citable-mcp

MCP-Server für Citable — SEO- und KI-Sichtbarkeitsdaten, die ein Agent pro Aufruf kaufen kann. Jedes Tool bezahlt sich selbst in USDC auf Solana über x402 aus einer Wallet auf deinem Rechner: kein Konto, kein API-Schlüssel, kein Abonnement. $0.005–0.30 pro Aufruf, und ein fehlgeschlagener Aufruf wird nie berechnet.

Der Code, der diese Zahlungen signiert, liegt in diesem Repo — server.ts ist der gesamte Server.

Installation

claude mcp add citable -- npx -y citable-mcp     # Claude Code
codex mcp add citable -- npx -y citable-mcp      # Codex

Cursor, Claude Desktop oder ein beliebiger MCP-Client — mcp.json:

{
  "mcpServers": {
    "citable": {
      "command": "npx",
      "args": ["-y", "citable-mcp"],
      "env": { "CITABLE_MAX_PRICE": "0.30" }
    }
  }
}

Node ≥ 20.18 oder bunx citable-mcp.

Related MCP server: Santos Automation

Wallet

Beginne mit citable_prices — es zeigt die Wallet, deren Guthaben und wie du sie auflädst. Zwei Möglichkeiten:

• Anmelden, keine Krypto nötig. citable_connect liefert einen Link: Melde dich bei citable.run mit Google oder E-Mail an, füge ein paar Dollar hinzu und klicke auf Connect. Der Agent bezahlt dann von dieser Wallet.

• Keypair, falls du bereits Solana nutzt. Ohne Konfiguration erstellt der Server bei erstem Bedarf ~/.config/citable/agent.json und zeigt die Adresse. Sende USDC auf Solana dorthin — kein SOL erforderlich, der x402-Facilitator übernimmt die Netzwerkgebühr — oder setze CITABLE_WALLET auf ein finanziertes Keypair.

Schritt-für-Schritt-Anleitung: https://citable.run/docs/wallet

Konfiguration

Tools

Jedes kostenpflichtige Ergebnis enthält _payment.transaction, die On-Chain-Abrechnung. Ein Aufruf über dem Limit oder ohne Guthaben gibt einen strukturierten Fehler zurück und kostet nichts.

So funktioniert ein Aufruf

1. Das Tool fragt den Endpunkt an. Citable antwortet mit 402 und nennt den Preis, den USDC-Mint und die Zahlungsadresse.

2. Der Server signiert eine USDC-Überweisung über genau diesen Betrag — nur wenn dieser auf oder unter CITABLE_MAX_PRICE liegt — und wiederholt den Aufruf mit dem Zahlungs-Header.

3. Der Facilitator wickelt die Abrechnung auf Solana in etwa 400 ms ab und der Endpunkt gibt 200 zurück.

Das Keypair wird von der Festplatte gelesen und ausschließlich zum Signieren dieser Überweisungen verwendet. Sonst verlässt nichts deinen Rechner, und Citable speichert nichts über dich: Die Wallet ist die einzige Identität.

Build

bun install
bun build.ts        # → dist/server.js, the published bin

MIT.