krystiangw/agenticpay

**Website** ·
Spend caps ·
npm
**Get paid by AI agents.** Open-source payment infrastructure for the MCP
ecosystem - declare a price on any tool, agents pay in USDC over x402,
settles on Solana in ~1.5 seconds.
No Stripe. No accounts. No API keys.
The full stack is here - SDK, CLI, paywall middleware, **self-hosted x402
facilitator**, and a live LLM agent demo. All TypeScript, MIT licensed.
> **Just want to test it?** Point your mcp-server at our hosted devnet
> facilitator: FACILITATOR_URL=https://agentpay-facilitator-e9b20a5fee6a.herokuapp.com
> No setup needed.
Live demo
A real Claude Opus agent receives a task, decides which paid tools to use,
pays autonomously via x402 micropayments on Solana, and answers the user.
On-chain proof (Solana devnet):
- Settled by our self-hosted facilitator: EsqzTG8id...Bnku
- Earlier settle via x402.org: 2d2HcefgJ...vkqY
Why
The current AI agent stack assumes humans hold the credit card. That breaks
the moment agents act on their own initiative - calling APIs, hiring
sub-agents, paying for compute. You can't OAuth your way through it.
Stablecoin micropayments over HTTP fix it. agenticpay packages the missing
ergonomics for the MCP ecosystem specifically: any tool can declare a price,
any agent can pay it, and the whole pipeline - including the facilitator that
actually submits the on-chain settlement - is open source and self-hostable.
Architecture
You can also point mcp-server at the public x402.org/facilitator for
testnet/devnet, or at Coinbase CDP for mainnet. We just made the
self-hosted route easy.
Packages
| Package | What it does |
|---|---|
| packages/sdk | TypeScript primitives: USDC transfers, wallet management, network config |
| packages/cli | agenticpay command - wallet, balance, send |
| packages/mcp-server | HTTP server with x402 paywall middleware. Each tool has a price. |
| packages/facilitator | **Self-hosted x402 facilitator** - verify + settle USDC payments on Solana. Pays SOL fees on behalf of agents. |
| packages/eliza-plugin | **Eliza plugin** - wraps paid HTTP endpoints as native Eliza Actions. Solana-native AI agents pay per tool call. |
| packages/ai-sdk | **Vercel AI SDK helpers** - drop paid tools straight into generateText / streamText. |
| packages/mcp-bridge | **Real MCP server** (stdio + @modelcontextprotocol/sdk) wrapping x402 paid tools. Drop into Claude Desktop / Cursor. |
| examples/two-agent-demo | Real Claude Opus agent paying for tool calls |
Install
Or clone the monorepo to get the live two-agent demo and edit-friendly
templates (recommended for first run - see Quickstart below).
Use with Claude Code
This repo ships an Anthropic Skill
at .claude/skills/agenticpay/SKILL.md. Copy it into your ~/.claude/skills/
to give Claude Code first-class context about agenticpay - it'll then walk you
through monetizing an MCP server, generating tool routes, and verifying
on-chain settlements without re-reading the README every time.
Quickstart (devnet, ~5 minutes, free)
Framework integrations
Drop-in templates for the most common AI agent stacks live under examples/:
| Framework | File |
|---|---|
| Anthropic SDK (canonical) | examples/two-agent-demo/src/agent-llm.ts |
| Real-world paid server template (Claude-backed tools) | examples/research-server/ |