Skip to main content
Glama

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

Related MCP server: x402 Payment Gateway MCP Server

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

Available Tools

1 tool
agenticpay_infoB

Placeholder tool for Glama introspection handshake.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

B3.3/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description must fully disclose behavior. It describes itself as a 'placeholder,' implying no significant side effects, but fails to explicitly state whether it is read-only, what it returns, or any other behavioral traits.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single sentence that is both concise and front-loaded. Every word serves a purpose, and there is no unnecessary information.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's simplicity (no parameters, no output schema), the description is adequately complete for its placeholder role. It explains the tool's purpose without missing essential details for a minimal introspection handshake.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema has zero parameters, so the baseline score is 4 per the rubric. The description adds no parameter information, but none is needed.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool is a placeholder for 'Glama introspection handshake,' which is a specific purpose. The verb 'handshake' is implied, and the resource 'introspection' is named, distinguishing it from typical functional tools.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is provided on when to use this tool versus alternatives. As a placeholder, it likely serves a specific introspective role, but the description does not explain its usage context or when not to use it.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 1 tool updatev0.1.0
    • First observedagenticpay_info

TDQS

B3.2/5.0

Scored across 1 tool

Disambiguation5/5

Only one tool exists, so there is no ambiguity between tools.

Naming Consistency5/5

With a single tool, naming is trivially consistent; the name uses a clear verb_noun pattern.

Tool Count1/5

One placeholder tool is far too few for a server named 'agenticpay', which implies a payment domain requiring multiple operations.

Completeness1/5

The server lacks any functional tools; a payment server should have tools for transactions, balances, etc., but there is only a placeholder.

Maintenance

ActivityActive
ResponsivenessWithin a week

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    B
    maintenance
    Drop-in x402 payment middleware for MCP servers. Charge AI agents per tool call using USDC on Base chain — Python and JavaScript SDKs, no payment processor, no KYC.
    MIT
  • A
    license
    A
    quality
    A
    maintenance
    Agentic payments on Solana: an agent can pay x402 / HTTP 402 paywalls in USDC, hold a pre-paid balance or a subscription, and buy datasets or settle store checkouts. All 15 tools run behind fail-closed spending caps ($1 per payment, $10 per day by default), and settlement is non-custodial through a program-owned escrow that releases 99% to the creator.
    18
    79 npm
    MIT
  • A
    license
    B
    quality
    D
    maintenance
    An MCP server providing 22 pay-per-call utility tools for AI agents (scrape, validate, embed, store, moderate, notify, convert, prevent loops) without accounts or API keys, using USDC payments via the x402 protocol.
    17
    77 npm
    1
    MIT