InFlow — agentic MPP (Machine Payments Protocol) / x402 payments from your machine.

by inflowpayai

411 downloads

Not rated

GitHub

About

A wallet for your agents to onboard and pay. Agentic MPP / x402 payments from your machine - CLI + MCP server.

Details

Author: inflowpayai
Downloads: 411
Categories: Developer Tools, AI

- Agentic and human-accessible via CLI or MCP assistants.
- Supports MPP (Machine Payments Protocol) and x402 payments.
- Provides command groups: auth, x402, mpp, user, balances, depositAddresses.
- Global flags and --format agent rendering.
- Ships as a skill and bundled MCP server plugin.
- Published as npm package @inflowpayai/inflow.

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name InFlow — agentic MPP (Machine Payments Protocol) / x402 payments from your machine.

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "inflow \u2014 agentic mpp (machine payments protocol) / x402 payments from your machine.": {
            "inflow": {
                "command": "npx",
                "args": [
                    "-y",
                    "@inflowpayai/inflow",
                    "--mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "inflow \u2014 agentic mpp (machine payments protocol) / x402 payments from your machine.": {
            "inflow": {
                "command": "npx",
                "args": [
                    "-y",
                    "@inflowpayai/inflow",
                    "--mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "inflow \u2014 agentic mpp (machine payments protocol) / x402 payments from your machine.": {
            "inflow": {
                "command": "npx",
                "args": [
                    "-y",
                    "@inflowpayai/inflow",
                    "--mcp"
                ]
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "inflow \u2014 agentic mpp (machine payments protocol) / x402 payments from your machine.": {
            "inflow": {
                "command": "npx",
                "args": [
                    "-y",
                    "@inflowpayai/inflow",
                    "--mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "inflow \u2014 agentic mpp (machine payments protocol) / x402 payments from your machine.": {
            "inflow": {
                "command": "npx",
                "args": [
                    "-y",
                    "@inflowpayai/inflow",
                    "--mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "inflow \u2014 agentic mpp (machine payments protocol) / x402 payments from your machine.": {
            "inflow": {
                "command": "npx",
                "args": [
                    "-y",
                    "@inflowpayai/inflow",
                    "--mcp"
                ]
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "inflow \u2014 agentic mpp (machine payments protocol) / x402 payments from your machine.": {
            "inflow": {
                "command": "npx",
                "args": [
                    "-y",
                    "@inflowpayai/inflow",
                    "--mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "inflow \u2014 agentic mpp (machine payments protocol) / x402 payments from your machine.": {
            "inflow": {
                "command": "npx",
                "args": [
                    "-y",
                    "@inflowpayai/inflow",
                    "--mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "inflow \u2014 agentic mpp (machine payments protocol) / x402 payments from your machine.": {
            "inflow": {
                "command": "npx",
                "args": [
                    "-y",
                    "@inflowpayai/inflow",
                    "--mcp"
                ]
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "inflow \u2014 agentic mpp (machine payments protocol) / x402 payments from your machine.": {
            "inflow": {
                "command": "npx",
                "args": [
                    "-y",
                    "@inflowpayai/inflow",
                    "--mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "inflow \u2014 agentic mpp (machine payments protocol) / x402 payments from your machine.": {
            "inflow": {
                "command": "npx",
                "args": [
                    "-y",
                    "@inflowpayai/inflow",
                    "--mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "inflow \u2014 agentic mpp (machine payments protocol) / x402 payments from your machine.": {
            "inflow": {
                "command": "npx",
                "args": [
                    "-y",
                    "@inflowpayai/inflow",
                    "--mcp"
                ]
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "inflow \u2014 agentic mpp (machine payments protocol) / x402 payments from your machine.": {
            "inflow": {
                "command": "npx",
                "args": [
                    "-y",
                    "@inflowpayai/inflow",
                    "--mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "inflow \u2014 agentic mpp (machine payments protocol) / x402 payments from your machine.": {
            "inflow": {
                "command": "npx",
                "args": [
                    "-y",
                    "@inflowpayai/inflow",
                    "--mcp"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "inflow \u2014 agentic mpp (machine payments protocol) / x402 payments from your machine.": {
            "inflow": {
                "command": "npx",
                "args": [
                    "-y",
                    "@inflowpayai/inflow",
                    "--mcp"
                ]
            }
        }
    }
}

From the repository

Install globally with npm install -g @inflowpayai/inflow or run directly with npx @inflowpayai/inflow. For agents, add the agentic-payments skill via npx skills add inflowpayai/inflow-cli or install the bundled plugin in hosts like Claude Code, Cursor, or Codex. The default MCP entry runs npx -y @inflowpayai/inflow --mcp.

`auth_login`

Authenticate with InFlow

`auth_logout`

Log out from InFlow

`auth_status`

Check authentication status

`balances_list`

List the authenticated user's balances

`deposit-addresses_list`

List the authenticated user's configured deposit addresses

`inspect`

Detect a URL's payment protocol(s) and show MPP and x402 challenges together. Read-only probe - no auth, no payment. Read `detected` to choose a pay rail (MPP wins when both are present).

`mpp_cancel`

Best-effort cancel of an MPP approval.

`mpp_decode`

Decode a raw WWW-Authenticate: Payment header, or a base64url credential / receipt.

`mpp_inspect`

Show the seller's MPP challenge(s) for a URL. Read-only probe - no auth, no payment.

`mpp_pay`

Pay an MPP-protected resource and return the seller response.

`mpp_status`

Poll the buyer-side state of an in-flight MPP transaction.

`mpp_supported`

List the methods the buyer can pay with - by intent, settlement rail, and currency.

`user_get`

Retrieve the current authenticated user

`x402_cancel`

Best-effort cancel of an x402 approval.

`x402_decode`

Decode a raw PAYMENT-REQUIRED header value.

`x402_inspect`

Show the seller's PAYMENT-REQUIRED accepts for a URL. Read-only probe - no auth, no payment.

`x402_pay`

Pay an x402-protected resource and return the seller response.

`x402_status`

Poll the signing state of an in-flight x402 transaction.

`x402_supported`

List the buyer-side capability cache (scheme x network).

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "inflow \u2014 agentic mpp (machine payments protocol) / x402 payments from your machine.": {
            "inflow": {
                "command": "npx",
                "args": [
                    "-y",
                    "@inflowpayai/inflow",
                    "--mcp"
                ]
            }
        }
    }
}

McpServers

{
    "inflow": {
        "command": "npx",
        "args": [
            "-y",
            "@inflowpayai/inflow",
            "--mcp"
        ]
    }
}

inflow

InFlow — agentic MPP (Machine Payments Protocol) / x402 payments from your machine.

The agent-native and human-accessible command-line entry point to InFlow. Agentic buyers perform agent-native payments
via MPP and x402; humans hit the same functionality from MCP-integrated assistants or the raw CLI.

New here? Start with the command reference in packages/cli/README.md — it covers auth,
the x402 and mpp command groups, the global flags, and the agent (--format) renderings.

Installing into an agent host? Use the per-surface guide:
docs/development/surfaces-and-testing.md.

Install

npm install -g @inflowpayai/inflow

Or run directly with npx:

npx @inflowpayai/inflow

Use with agents

Install the agentic-payments skill into a skills-aware agent:

npx skills add inflowpayai/inflow-cli

The repo also ships as an installable plugin (skill + MCP server bundled) for plugin-aware hosts:

- Claude Code — add the marketplace, then install the plugin:

  /plugin marketplace add inflowpayai/inflow-cli
  /plugin install inflow@inflow

Here inflowpayai/inflow-cli is the GitHub repo slug; the marketplace, plugin, and binary are all named inflow, so
the install target is inflow@inflow.

- Cursor / Codex — point the host at this repo; it discovers .cursor-plugin/marketplace.json,
.agents/plugins/marketplace.json, and .codex-plugin/plugin.json respectively.

In every case the plugin bundles the skill and the inflow MCP server (.mcp.json). The default MCP entry runs
npx -y @inflowpayai/inflow --mcp; install the binary globally only for direct CLI use or for hosts configured to run
inflow --mcp from PATH.

Development

This is a pnpm + Turborepo monorepo. Node >= 22 required.

pnpm install
pnpm build
pnpm test

Other useful tasks:

pnpm typecheck
pnpm lint
pnpm typedoc
pnpm changeset

Packages

- @inflowpayai/inflow (packages/cli) — the published binary, and the entry point for anyone integrating InFlow. Thin
render shell over inflow-core. See packages/cli/README.md for the full command
reference.
- @inflowpayai/inflow-core (packages/core) — the headless InFlow client behind the binary. One augmented handle per
command group (inflow.auth, inflow.user, inflow.balances, inflow.depositAddresses, inflow.x402,
inflow.mpp) carrying both protocol primitives and the command-shaped operations, plus the helpers (sanitization,
polling, seller-probe) that make both work. Workspace-internal today; see
packages/core/examples/ for runnable scripts.

Repository

<https://github.com/inflowpayai/inflow-cli>

License

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

auth_login

auth_logout

auth_status

balances_list

deposit-addresses_list

inspect

mpp_cancel

mpp_decode

mpp_inspect

mpp_pay

mpp_status

mpp_supported

user_get

x402_cancel

x402_decode

x402_inspect

x402_pay

x402_status

x402_supported

Claude Desktop / Cursor

McpServers

inflow

Install

Use with agents

Development

Packages

Repository

License

Install

More like this

Sentry

Github

Git

GitLab

Context 7

1Panel

`auth_login`

`auth_logout`

`auth_status`

`balances_list`

`deposit-addresses_list`

`inspect`

`mpp_cancel`

`mpp_decode`

`mpp_inspect`

`mpp_pay`

`mpp_status`

`mpp_supported`

`user_get`

`x402_cancel`

`x402_decode`

`x402_inspect`

`x402_pay`

`x402_status`

`x402_supported`