Can I use a hosted facilitator or do I have to self-host?

You can use the provided hosted devnet facilitator for testing or run your own self-hosted facilitator from this repo.

What blockchain does agenticpay use for settlements?

It settles payments on the Solana blockchain using USDC SPL tokens.

What programming languages and tools does agenticpay provide?

It offers a TypeScript SDK, CLI tools, paywall middleware, and MCP server integration packages.

How fast are payments settled?

Payments settle on Solana in approximately 1.5 seconds.

Agenticpay

Open-source micropayments stack enabling pay-per-tool-call USDC settlements on Solana with a self-hosted facilitator.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

One-click editor setup isn’t available for this listing yet — we don’t have a confirmed install command, and we’d rather show nothing than point your editor at the wrong package or host. Follow the project’s own setup instructions, linked above.

Manual Client & Custom JSON ConfigExpand JSON ▾

No confirmed setup config for this listing yet. We only publish a config block when the install details come from the project itself — its README, its docs, or a verified owner. We haven’t found those for krystiangw/agenticpay, and we’d rather show nothing than a guess you’d paste into your client. Follow the project’s own setup instructions for the current steps.

Overview

This project provides a full micropayments infrastructure for AI agents using the Model Context Protocol (MCP). It enables tools to declare prices and agents to pay in USDC via the x402 protocol, settling transactions on Solana in about 1.5 seconds. The stack includes a TypeScript SDK, CLI, paywall middleware, and a self-hostable x402 facilitator that handles payment verification and on-chain settlement without relying on third-party services. It suits use cases where autonomous AI agents need to pay for tool usage without human credit card involvement.

Use cases

Integrate pay-per-call pricing for AI agent tools

Enable autonomous AI agents to pay for services using USDC

Self-host a micropayments facilitator for on-chain settlements

Test micropayments with a hosted Solana devnet facilitator

Wrap paid HTTP endpoints as native Eliza Actions for AI agents

Key features

TypeScript SDK for USDC transfers and wallet management

Self-hosted x402 facilitator for payment verification and Solana settlement

Paywall middleware for MCP servers to enforce tool pricing

CLI for wallet and payment operations

Supports sub-cent USDC micropayments settled on Solana in ~1.5 seconds

Includes live demo with autonomous AI agent paying for tool calls

Capabilities & Tool Schemas

Inspect callable tools, capabilities, and parameters exposed to AI agents by Agenticpay.

Extracted Tool Capabilities

TypeScript SDK for USDC transfers and wallet management

Self-hosted x402 facilitator for payment verification and Solana settlement

Paywall middleware for MCP servers to enforce tool pricing

CLI for wallet and payment operations

Supports sub-cent USDC micropayments settled on Solana in ~1.5 seconds

Includes live demo with autonomous AI agent paying for tool calls

Documentation Overview

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.

Code

$ pnpm --filter @agenticpay/two-agent-demo agent

Agent wallet: 3rHoEumCpH8EGrr6Lq2vBKeyec6h3yPRGj2nGG2FzEfX
Server:       http://localhost:4021
Facilitator:  http://localhost:4022   ← our own
Model:        claude-opus-4-7
Task:         Reverse the string 'agentpay rocks' and tell me how many words
              are in 'The quick brown fox jumps over the lazy dog'.

[turn 1] tool_use: reverse_string({"text":"agenticpay rocks"})  →  paying $0.001 USDC ...
  ✓ paid + got result in 1596ms: {"result":"skcor yaptnega"}
[turn 1] tool_use: word_count({"text":"The quick..."})  →  paying $0.0005 USDC ...
  ✓ paid + got result in 1286ms: {"count":9}

Agent final answer:
  1. Reversed string: skcor yaptnega
  2. Word count: 9 words

=== payments summary ===
  reverse_string   $0.0010 USDC   1596ms
  word_count       $0.0005 USDC   1286ms
  TOTAL            $0.0015 USDC   2 calls

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

Code

┌──────────────┐     1) HTTP request                    ┌─────────────┐
│   Claude /   │ ────────────────────────────────────▶ │  mcp-server │
│   GPT agent  │     2) HTTP 402 + payment requirements │  (yours)    │
│              │ ◀──────────────────────────────────── │             │
│              │     3) signed USDC payload             │             │
│              │ ────────────────────────────────────▶ │             │
└──────────────┘                                        └─────┬───────┘
                                                              │ verify+settle
                                                              ▼
                                                   ┌──────────────────────┐
                                                   │ agenticpay facilitator │
                                                   │   (also yours, this  │
                                                   │    repo, port 4022)  │
                                                   └──────────┬───────────┘
                                                              │ submit
                                                              ▼
                                                          Solana
                                                       (USDC SPL,
                                                       sub-cent fees)

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

Terminal

npm install @agenticpay/sdk           # Solana + USDC primitives
npm install -g @agenticpay/cli        # `agenticpay` command
npm install @agenticpay/mcp-server    # paywalled HTTP server
npm install @agenticpay/facilitator   # self-hosted x402 facilitator
npm install @agenticpay/eliza-plugin  # Eliza plugin (Solana-native agents)
npm install @agenticpay/ai-sdk        # Vercel AI SDK paid tools
npm install -g @agenticpay/mcp-bridge # MCP server for Claude Desktop / Cursor

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.

bash

mkdir -p ~/.claude/skills
cp -r .claude/skills/agenticpay ~/.claude/skills/

Quickstart (devnet, ~5 minutes, free)

server.ts

# 1. Install
pnpm install
pnpm -r build

# 2. Generate a payer wallet, fund it on devnet
node packages/cli/dist/index.js wallet new
node packages/cli/dist/index.js wallet show
# → fund SOL at https://faucet.solana.com  (paste pubkey)
# → fund USDC at https://faucet.circle.com (Solana Devnet, same pubkey)

# 3. (option A - fastest) Use our hosted devnet facilitator. Skip step 4.
export FACILITATOR_URL=https://agentpay-facilitator-e9b20a5fee6a.herokuapp.com

# 3. (option B - fully self-hosted) Start your own facilitator (terminal 1)
pnpm --filter @agenticpay/facilitator dev
# Note the printed feePayer address. It needs ~0.05 SOL devnet to cover fees.
# Either airdrop or use the helper:
pnpm --filter @agenticpay/facilitator fund
export FACILITATOR_URL=http://localhost:4022

# 4. Start the paywalled mcp-server (terminal 2)
PAY_TO=<recipient pubkey> pnpm --filter @agenticpay/mcp-server dev

# 5. Run the live LLM agent demo (terminal 3, needs ANTHROPIC_API_KEY in .env)
pnpm --filter @agenticpay/two-agent-demo agent

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/`
LangChain.js	`examples/langchain-js/agent-with-paid-tools.ts`
LangChain Python	`examples/langchain-python/agent_with_paid_tools.py`
Eliza (Solana-native)	`examples/eliza/plugin-agenticpay.ts`
Mastra	`examples/mastra/paid-tool.ts`
Vercel AI SDK	`examples/vercel-ai-sdk/paid-tool.ts`
OpenAI Custom GPT	`examples/openai-gpt/action-schema.json`

See examples/README.md for the integration matrix.

Status

Pre-alpha. Devnet validated end-to-end. Mainnet config supported but requires funding the facilitator with real SOL and pointing at a mainnet-capable RPC (Helius, QuickNode, etc.).

Roadmap

Devnet end-to-end demo (smoke + LLM agent)
Self-hosted x402 facilitator (verify + settle, fee_payer abstraction)
Real-world MCP server template (search, fetch, summarize, extract - instead of toy reverse_string)
On-chain escrow for long-running tasks (Anchor program)
Agent reputation registry on-chain
Hosted facilitator service (agenticpay.com)

What's a facilitator?

Read the full README →View source on GitHub →

Related MCP Servers

View all in Finance & Fintech View all alternatives

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars

Stargazers on the source repository.

Last commit

1mo ago

Most recent push to the default branch.

Directory activity

1 views

Config copies, upvotes, and views on AllMCPs.

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Agenticpay

No, it uses USDC stablecoin micropayments on Solana and does not require Stripe, accounts, or API keys.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/krystiangw-agenticpay?style=directory)](https://allmcps.com/mcp/krystiangw-agenticpay)

HTML Embed

<a href="https://allmcps.com/mcp/krystiangw-agenticpay"><img src="https://allmcps.com/api/badge/krystiangw-agenticpay?style=directory" alt="Agenticpay on AllMCPs" /></a>

Technical Specs & Signals

CategoryFinance & Fintech

43Quality signal: Fair · 43/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools19/30

Adoption & activity3/15

Community engagement0/10

A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.

★ Spotlight Slot

Feature Your MCP Server

Get maximum visibility for your server across our directory, search results, and detail pages.

Spotlight Your Server

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge — proof is checked automatically, then reviewed by our team.

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💰 Finance & Fintech →Best MCP servers for Finance & Fintech →Alternatives to Agenticpay →Install in Claude Desktop Install in Cursor Install in VS Code

Agenticpay

Open-source micropayments stack enabling pay-per-tool-call USDC settlements on Solana with a self-hosted facilitator.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Manual Client & Custom JSON ConfigExpand JSON ▾

Overview

Use cases

Integrate pay-per-call pricing for AI agent tools

Enable autonomous AI agents to pay for services using USDC

Self-host a micropayments facilitator for on-chain settlements

Test micropayments with a hosted Solana devnet facilitator

Wrap paid HTTP endpoints as native Eliza Actions for AI agents

Key features

TypeScript SDK for USDC transfers and wallet management

Self-hosted x402 facilitator for payment verification and Solana settlement

Paywall middleware for MCP servers to enforce tool pricing

CLI for wallet and payment operations

Supports sub-cent USDC micropayments settled on Solana in ~1.5 seconds

Includes live demo with autonomous AI agent paying for tool calls

Capabilities & Tool Schemas

Inspect callable tools, capabilities, and parameters exposed to AI agents by Agenticpay.

Extracted Tool Capabilities

TypeScript SDK for USDC transfers and wallet management

Self-hosted x402 facilitator for payment verification and Solana settlement

Paywall middleware for MCP servers to enforce tool pricing

CLI for wallet and payment operations

Supports sub-cent USDC micropayments settled on Solana in ~1.5 seconds

Includes live demo with autonomous AI agent paying for tool calls

Documentation Overview

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.

Code

$ pnpm --filter @agenticpay/two-agent-demo agent

Agent wallet: 3rHoEumCpH8EGrr6Lq2vBKeyec6h3yPRGj2nGG2FzEfX
Server:       http://localhost:4021
Facilitator:  http://localhost:4022   ← our own
Model:        claude-opus-4-7
Task:         Reverse the string 'agentpay rocks' and tell me how many words
              are in 'The quick brown fox jumps over the lazy dog'.

[turn 1] tool_use: reverse_string({"text":"agenticpay rocks"})  →  paying $0.001 USDC ...
  ✓ paid + got result in 1596ms: {"result":"skcor yaptnega"}
[turn 1] tool_use: word_count({"text":"The quick..."})  →  paying $0.0005 USDC ...
  ✓ paid + got result in 1286ms: {"count":9}

Agent final answer:
  1. Reversed string: skcor yaptnega
  2. Word count: 9 words

=== payments summary ===
  reverse_string   $0.0010 USDC   1596ms
  word_count       $0.0005 USDC   1286ms
  TOTAL            $0.0015 USDC   2 calls

On-chain proof (Solana devnet):

Settled by our self-hosted facilitator: EsqzTG8id...Bnku
Earlier settle via x402.org: 2d2HcefgJ...vkqY

Why

Architecture

Code

┌──────────────┐     1) HTTP request                    ┌─────────────┐
│   Claude /   │ ────────────────────────────────────▶ │  mcp-server │
│   GPT agent  │     2) HTTP 402 + payment requirements │  (yours)    │
│              │ ◀──────────────────────────────────── │             │
│              │     3) signed USDC payload             │             │
│              │ ────────────────────────────────────▶ │             │
└──────────────┘                                        └─────┬───────┘
                                                              │ verify+settle
                                                              ▼
                                                   ┌──────────────────────┐
                                                   │ agenticpay facilitator │
                                                   │   (also yours, this  │
                                                   │    repo, port 4022)  │
                                                   └──────────┬───────────┘
                                                              │ submit
                                                              ▼
                                                          Solana
                                                       (USDC SPL,
                                                       sub-cent fees)

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

Terminal

npm install @agenticpay/sdk           # Solana + USDC primitives
npm install -g @agenticpay/cli        # `agenticpay` command
npm install @agenticpay/mcp-server    # paywalled HTTP server
npm install @agenticpay/facilitator   # self-hosted x402 facilitator
npm install @agenticpay/eliza-plugin  # Eliza plugin (Solana-native agents)
npm install @agenticpay/ai-sdk        # Vercel AI SDK paid tools
npm install -g @agenticpay/mcp-bridge # MCP server for Claude Desktop / Cursor

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

bash

mkdir -p ~/.claude/skills
cp -r .claude/skills/agenticpay ~/.claude/skills/

Quickstart (devnet, ~5 minutes, free)

server.ts

# 1. Install
pnpm install
pnpm -r build

# 2. Generate a payer wallet, fund it on devnet
node packages/cli/dist/index.js wallet new
node packages/cli/dist/index.js wallet show
# → fund SOL at https://faucet.solana.com  (paste pubkey)
# → fund USDC at https://faucet.circle.com (Solana Devnet, same pubkey)

# 3. (option A - fastest) Use our hosted devnet facilitator. Skip step 4.
export FACILITATOR_URL=https://agentpay-facilitator-e9b20a5fee6a.herokuapp.com

# 3. (option B - fully self-hosted) Start your own facilitator (terminal 1)
pnpm --filter @agenticpay/facilitator dev
# Note the printed feePayer address. It needs ~0.05 SOL devnet to cover fees.
# Either airdrop or use the helper:
pnpm --filter @agenticpay/facilitator fund
export FACILITATOR_URL=http://localhost:4022

# 4. Start the paywalled mcp-server (terminal 2)
PAY_TO=<recipient pubkey> pnpm --filter @agenticpay/mcp-server dev

# 5. Run the live LLM agent demo (terminal 3, needs ANTHROPIC_API_KEY in .env)
pnpm --filter @agenticpay/two-agent-demo agent

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/`
LangChain.js	`examples/langchain-js/agent-with-paid-tools.ts`
LangChain Python	`examples/langchain-python/agent_with_paid_tools.py`
Eliza (Solana-native)	`examples/eliza/plugin-agenticpay.ts`
Mastra	`examples/mastra/paid-tool.ts`
Vercel AI SDK	`examples/vercel-ai-sdk/paid-tool.ts`
OpenAI Custom GPT	`examples/openai-gpt/action-schema.json`

See examples/README.md for the integration matrix.

Status

Pre-alpha. Devnet validated end-to-end. Mainnet config supported but requires funding the facilitator with real SOL and pointing at a mainnet-capable RPC (Helius, QuickNode, etc.).

Roadmap

Devnet end-to-end demo (smoke + LLM agent)
Self-hosted x402 facilitator (verify + settle, fee_payer abstraction)
Real-world MCP server template (search, fetch, summarize, extract - instead of toy reverse_string)
On-chain escrow for long-running tasks (Anchor program)
Agent reputation registry on-chain
Hosted facilitator service (agenticpay.com)

What's a facilitator?

Read the full README →View source on GitHub →

Related MCP Servers

View all in Finance & Fintech View all alternatives

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars

Stargazers on the source repository.

Last commit

1mo ago

Most recent push to the default branch.

Directory activity

1 views

Config copies, upvotes, and views on AllMCPs.

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Agenticpay

No, it uses USDC stablecoin micropayments on Solana and does not require Stripe, accounts, or API keys.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/krystiangw-agenticpay?style=directory)](https://allmcps.com/mcp/krystiangw-agenticpay)

HTML Embed

<a href="https://allmcps.com/mcp/krystiangw-agenticpay"><img src="https://allmcps.com/api/badge/krystiangw-agenticpay?style=directory" alt="Agenticpay on AllMCPs" /></a>

Technical Specs & Signals

CategoryFinance & Fintech

43Quality signal: Fair · 43/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools19/30

Adoption & activity3/15

Community engagement0/10

★ Spotlight Slot

Feature Your MCP Server

Get maximum visibility for your server across our directory, search results, and detail pages.

Spotlight Your Server

Own this project?

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💰 Finance & Fintech →Best MCP servers for Finance & Fintech →Alternatives to Agenticpay →Install in Claude Desktop Install in Cursor Install in VS Code