agenticpay

👁 CI
👁 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

Related MCP server: opendexter

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

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/:

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

Maintenance

Resources

• GitHub Repository
Need Help?Related Servers

Tools

• agenticpay_infoB