agenticpay

CodeQL gitleaks License: MIT GitHub stars npm: @agenticpay/sdk npm downloads

Lass dich von KI-Agenten bezahlen. Open-Source-Zahlungsinfrastruktur für das MCP-Ökosystem — lege einen Preis für jedes Tool fest, Agenten zahlen in USDC über x402, die Abwicklung erfolgt auf Solana in ca. 1,5 Sekunden.

Kein Stripe. Keine Konten. Keine API-Schlüssel.

Der gesamte Stack ist hier enthalten — SDK, CLI, Paywall-Middleware, selbst gehosteter x402-Facilitator und eine Live-LLM-Agenten-Demo. Alles in TypeScript, MIT-lizenziert.

Willst du es nur testen? Verweise deinen mcp-server auf unseren gehosteten Devnet-Facilitator: FACILITATOR_URL=https://agentpay-facilitator-e9b20a5fee6a.herokuapp.com — keine Einrichtung erforderlich.

Live-Demo

Ein echter Claude Opus-Agent erhält eine Aufgabe, entscheidet, welche kostenpflichtigen Tools er verwenden möchte, zahlt autonom über x402-Mikrozahlungen auf Solana und antwortet dem Benutzer.

$ 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-Nachweis (Solana Devnet):

Abgewickelt durch unseren selbst gehosteten Facilitator: EsqzTG8id...Bnku
Frühere Abwicklung über x402.org: 2d2HcefgJ...vkqY

Warum

Der aktuelle KI-Agenten-Stack geht davon aus, dass Menschen die Kreditkarte halten. Das bricht zusammen, sobald Agenten aus eigener Initiative handeln — APIs aufrufen, Sub-Agenten beauftragen, Rechenleistung bezahlen. Das lässt sich nicht über OAuth lösen.

Stablecoin-Mikrozahlungen über HTTP lösen das Problem. agenticpay bündelt die fehlende Ergonomie speziell für das MCP-Ökosystem: Jedes Tool kann einen Preis festlegen, jeder Agent kann ihn bezahlen, und die gesamte Pipeline — einschließlich des Facilitators, der die On-Chain-Abwicklung tatsächlich einreicht — ist Open Source und selbst hostbar.

Architektur

┌──────────────┐     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)

Du kannst mcp-server auch auf den öffentlichen x402.org/facilitator für Testnet/Devnet oder auf Coinbase CDP für Mainnet verweisen. Wir haben den selbst gehosteten Weg einfach gemacht.

Pakete

Paket	Was es tut
`packages/sdk`	TypeScript-Primitive: USDC-Transfers, Wallet-Management, Netzwerkkonfiguration
`packages/cli`	`agenticpay`-Befehl — Wallet, Guthaben, Senden
`packages/mcp-server`	HTTP-Server mit x402-Paywall-Middleware. Jedes Tool hat einen Preis.
`packages/facilitator`	Selbst gehosteter x402-Facilitator — verifiziert + wickelt USDC-Zahlungen auf Solana ab. Zahlt SOL-Gebühren im Namen der Agenten.
`packages/eliza-plugin`	Eliza-Plugin — kapselt kostenpflichtige HTTP-Endpunkte als native Eliza-Actions. Solana-native KI-Agenten zahlen pro Tool-Aufruf.
`packages/ai-sdk`	Vercel AI SDK-Helfer — binde kostenpflichtige Tools direkt in `generateText` / `streamText` ein.
`packages/mcp-bridge`	Echter MCP-Server (stdio + `@modelcontextprotocol/sdk`), der x402-kostenpflichtige Tools kapselt. In Claude Desktop / Cursor einbinden.
`examples/two-agent-demo`	Echter Claude Opus-Agent, der für Tool-Aufrufe bezahlt

Installation

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

Oder klone das Monorepo, um die Live-Zwei-Agenten-Demo und bearbeitungsfreundliche Vorlagen zu erhalten (empfohlen für den ersten Durchlauf — siehe Quickstart unten).

Verwendung mit Claude Code

Dieses Repo enthält ein Anthropic Skill unter .claude/skills/agenticpay/SKILL.md. Kopiere es in dein ~/.claude/skills/-Verzeichnis, um Claude Code erstklassigen Kontext über agenticpay zu geben — es führt dich dann durch die Monetarisierung eines MCP-Servers, das Generieren von Tool-Routen und das Verifizieren von On-Chain-Abwicklungen, ohne jedes Mal die README lesen zu müssen.

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

Quickstart (Devnet, ~5 Minuten, kostenlos)

# 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-Integrationen

Drop-in-Vorlagen für die gängigsten KI-Agenten-Stacks befinden sich unter examples/:

Framework	Datei
Anthropic SDK (kanonisch)	`examples/two-agent-demo/src/agent-llm.ts`
Vorlage für einen kostenpflichtigen Server (Claude-gestützte 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-nativ)	`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`

Siehe examples/README.md für die Integrationsmatrix.

Status

Pre-Alpha. Devnet durchgängig validiert. Mainnet-Konfiguration wird unterstützt, erfordert jedoch die Finanzierung des Facilitators mit echtem SOL und den Verweis auf einen Mainnet-fähigen RPC (Helius, QuickNode, etc.).

Roadmap

[x] Devnet End-to-End-Demo (Smoke + LLM-Agent)
[x] Selbst gehosteter x402-Facilitator (Verifizierung + Abwicklung, fee_payer-Abstraktion)
[ ] Echter MCP-Server-Template (Suchen, Abrufen, Zusammenfassen, Extrahieren — statt Spielerei reverse_string)
[ ] On-Chain-Treuhandkonto für lang laufende Aufgaben (Anchor-Programm)
[ ] On-Chain-Reputationsregister für Agenten
[ ] Gehosteter Facilitator-Dienst (agenticpay.com)

Was ist ein Facilitator?

Falls du x402 noch nie gesehen hast: Der Facilitator ist der vertrauenswürdige Mittelsmann, der (1) das signierte Zahlungs-Payload eines Agenten verifiziert, (2) den USDC-Transfer on-chain einreicht und (3) die SOL-Gasgebühren bezahlt, sodass der Agent kein SOL benötigt — nur USDC. Die meisten MCP-Entwickler möchten keinen eigenen betreiben; sie verweisen auf einen gehosteten.

Dieses Repo enthält eine vollständige Facilitator-Implementierung. Du kannst sie selbst hosten, forken, prüfen oder als Dienst für deine eigenen Benutzer bereitstellen.

Lizenz

MIT

agenticpay

agenticpay

Live-Demo

Warum

Architektur

Pakete

Installation

Verwendung mit Claude Code

Quickstart (Devnet, ~5 Minuten, kostenlos)

Framework-Integrationen

Status

Roadmap

Was ist ein Facilitator?

Lizenz

Resources

Tools

Latest Blog Posts

MCP directory API