https://github.com/inflowpayai/inflow-cli
A wallet for your agents to onboard and pay. Agentic MPP / x402 payments from your machine - CLI + MCP server.
https://github.com/inflowpayai/inflow-cli
aep agent-skills agentic-commerce agentic-payments ai-agents cli http-402 mcp mcp-server mpp onboarding payments stablecoins wallet x402
Last synced: 3 days ago
JSON representation
A wallet for your agents to onboard and pay. Agentic MPP / x402 payments from your machine - CLI + MCP server.
- Host: GitHub
- URL: https://github.com/inflowpayai/inflow-cli
- Owner: inflowpayai
- License: mit
- Created: 2026-05-24T21:19:44.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2026-07-03T09:05:14.000Z (19 days ago)
- Last Synced: 2026-07-19T10:39:14.970Z (3 days ago)
- Topics: aep, agent-skills, agentic-commerce, agentic-payments, ai-agents, cli, http-402, mcp, mcp-server, mpp, onboarding, payments, stablecoins, wallet, x402
- Language: TypeScript
- Homepage: https://inflowcli.ai
- Size: 410 KB
- Stars: 9
- Watchers: 0
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
- Agents: AGENTS.md
Awesome Lists containing this project
README
# inflow
[](https://github.com/inflowpayai/inflow-cli/actions/workflows/ci.yml)
[](https://www.npmjs.com/package/@inflowpayai/inflow)
[](https://www.npmjs.com/package/@inflowpayai/inflow)
[](https://codecov.io/gh/inflowpayai/inflow-cli)
[](https://nodejs.org)
[](./LICENSE)
[](https://discord.gg/Z9nmMAgaR4)
[](https://skills.sh/inflowpayai/inflow-cli)
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`](./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`](./docs/development/surfaces-and-testing.md).
## Install
```bash
npm install -g @inflowpayai/inflow
```
Or run directly with `npx`:
```bash
npx @inflowpayai/inflow
```
### Use with agents
Install the `agentic-payments` skill into a skills-aware agent:
```bash
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.
```bash
pnpm install
pnpm build
pnpm test
```
Other useful tasks:
```bash
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`](./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/`](./packages/core/examples/) for runnable scripts.
## Repository
## License
MIT — Copyright (c) 2025-2026 Jarwin, Inc.