btcmatic-mcp-server

MCP-Server für die BTCMatic-Agenten-API: nutzungsbasierte Bezahlung Bitcoin-Kontext für autonome Agenten — der Self-Custody-Sicherheitsradar, Gebührenperzentil, Preisänderungsfenster und Bedingungshäufigkeit — bezahlt in Sats über Lightning. Kein Konto, kein API-Schlüssel, keine Kreditkarte: Die API antwortet mit 402 und einer Rechnung, die Wallet des Agenten bezahlt, der Tool-Aufruf wird mit dem Preimage abgeschlossen.

BTCMatic ist die Bitcoin-Event-Engine; dieses Paket ist der Einstieg für Agenten. Alles hier ist nur-Lese-Kontext — es kann keine Regeln erstellen, keine Aufträge aufgeben, niemanden benachrichtigen oder Gelder berühren.

Tools

Ein bezahlter Aufruf kostet etwa 21 Sats (der aktuelle Preis steht in btcmatic_discover).

Related MCP server: x402-api

So funktioniert die Bezahlung

1. Rufen Sie ein bezahltes Tool ohne Nachweis auf. Das Ergebnis ist das 402-Angebot als Daten, kein Fehler: { "kind": "offer", "price_sats", "bolt11", "payment_hash", "next_step" }.

2. Ihre Wallet bezahlt die bolt11-Rechnung und zeigt das Preimage.

3. Rufen Sie dasselbe Tool erneut mit { "payment_hash", "preimage" } auf. Der Nachweis ist einmalig verwendbar.

Vorausbezahlt: btcmatic_topup → bezahlen → btcmatic_topup_claim → Token. Starten Sie den Server mit BTCMATIC_AGENT_TOKEN=agt_… und jedes bezahlte Tool belastet das Guthaben; bei null antworten die Tools mit { "kind": "topup_needed" }.

Dieser Server hält niemals Schlüssel und bezahlt niemals. Er übermittelt Nachweise; das Bezahlen ist immer die Entscheidung einer Wallet, die Sie kontrollieren. Das Nachweisformat ist Authorization: L402 <payment_hash>:<preimage> — der Zahlungshash benennt eine Rechnung, die BTCMatic ausgestellt hat, und sha256(preimage) = payment_hash ist der Nachweis, somit ist kein Macaroon erforderlich.

Installation

{
	"mcpServers": {
		"btcmatic": {
			"command": "npx",
			"args": ["-y", "btcmatic-mcp-server"],
			"env": { "BTCMATIC_AGENT_TOKEN": "agt_…" }
		}
	}
}

BTCMATIC_AGENT_TOKEN ist optional (nutzungsbasierter 402-Ablauf ohne ihn). BTCMATIC_API_URL überschreibt die API-Basis-URL (Standard: https://api.btcmatic.com).

Was die Zahlen sind — und was nicht

• Quellenbezogene Präzision stammt aus manuell von BTCMatic gepflegten Kennzeichnungen, veröffentlicht unter btcmatic.com/radar; eine nicht gekennzeichnete Quelle zeigt keinerlei Präzision an.

• Gebührenperzentil, Änderungsfenster und Häufigkeit sind beschreibende Statistiken über öffentliche Datenreihen. Sie beschreiben die Vergangenheit; sie sagen nichts voraus und nichts davon ist eine Empfehlung zum Kaufen oder Verkaufen.

• Jede bezahlte Antwort enthält einen meta-Block mit dem bezahlten Preis, dem verbleibenden Guthaben, einem Haftungsausschluss und einem Anmeldelink — dieselben Daten sind mit einem BTCMatic-Konto kostenlos; diese API existiert für Clients, die keines haben können.

Entwicklung

pnpm install
pnpm build && pnpm test && pnpm lint
BTCMATIC_API_URL=http://localhost:3000 node dist/cli.js   # stdio transport

Ressourcen

• Agenten-API-Dokumentation: https://btcmatic.com/integrations/agents

• OpenAPI (Tag agent): https://api.btcmatic.com/docs

• BTCMatic für Automatisierungen (API-Schlüssel, n8n): https://btcmatic.com/integrations/n8n

Lizenz

MIT