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.

Related MCP server: Lightning Enable MCP

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/glowhub-1028/inflow-cli

License

MIT — Copyright (c) 2025-2026 Jarwin, Inc.