Satoshi API MCP server
Commit 4. Nov. 2026Bietet Echtzeit-Bitcoin-Fee-Intelligence, Mempool-Status und Transaktionsanalysen für AI Agents und selbstgehostete Infrastruktur.
Auch bekannt als Bortlesboat/bitcoin-api
- Stars
- 5
- Tools
- —
- Downloads, 30 Tage
- —
- Neueste Version
- —
- Letzter Commit
- 4. Nov. 2026
- Lizenz
- Apache-2.0
Was ist Satoshi API MCP?
Bietet Echtzeit-Bitcoin-Fee-Intelligence, Mempool-Status und Transaktionsanalysen für AI Agents und selbstgehostete Infrastruktur.
Zusammenfassung generiert aus dem README des Projekts
Über Satoshi API MCP server
Die Satoshi API bietet Echtzeit-Bitcoin-Intelligence für Entwickler und AI Agents. Der Fokus liegt auf der Fee-Optimierung, indem der Mempool-Status mit mehreren Fee-Schätzungen kombiniert wird, um konkrete Empfehlungen zu geben. Statt nur Rohdaten zu liefern, bietet sie Orientierung darüber, ob eine Transaktion sofort gesendet werden sollte oder ob man auf niedrigere Kosten warten kann. Das Tool ist für das Self-Hosting via einfacher pip-Installation konzipiert und erfordert eine Verbindung zu einem Bitcoin Core oder Knots Node über RPC-Credentials.
Für alle, die mit KI bauen, bietet die bitcoin-mcp Implementierung 50 Standard-Tools, 6 Prompts und 8 Resources. Nutzer können ihre Agents mit einem lokalen Node oder einer Remote-Instanz der Satoshi API verbinden. Das System unterstützt fortgeschrittene Features wie x402 Paid Endpoints für monetarisierten Zugriff und Echtzeit-Datenstreaming via SSE für Blocks und Fees. Es enthält zudem Research-Funktionen, um Fee-Forecasting-Daten im JSONL-Format für Offline-Analysen zu exportieren.
Was du damit machen kannst
- 1Transaktionszeitpunkt optimierenLass einen AI Agent bestimmen, ob die aktuellen Netzwerkbedingungen geeignet sind, um eine Bitcoin-Transaktion zu senden.
- 2Transaktionsdetails analysierenFordere eine dekodierte Analyse und einen Status-Check für eine spezifische Transaktions-ID an.
- 3Netzwerk-Congestion überwachenLass einen Agent den aktuellen Congestion-Score und die Fee-Buckets im Mempool prüfen.
- 4Fee-Forecasting Research durchführenGeneriere einen JSONL-Export von Fee-Beobachtungen, um Offline-Forecasting-Arbeiten durchzuführen.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
Konfiguration
BITCOIN_RPC_USERSATOSHI_API_URL
| Name | Beschreibung | Typ |
|---|---|---|
| BITCOIN_RPC_USER | — | |
| SATOSHI_API_URL | — |
Automatisierte Checks
Geluften am 14. Nov. 2026Vollständiger Bericht →Noch nicht verifiziert. Ein Server benötigt einen Score von 80, keine kritischen Befunde und genug Daten für unsere Prüfung. Wie die Checks funktionieren · Was du für mehr Punkte verbessern kannst
- Source Repository verknüpft und erreichbarbortlesboat/bitcoin-api is public and reachablegithub.com/bortlesboat/bitcoin-api ↗Bestanden
- Paket nennt dieses Repository als QuelleNicht geprüft
- Build-Provenienz (Sigstore-Attestierung)Nicht geprüft
- Open Source Lizenz (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗Bestanden
- Commit oder Release im letzten JahrLast commit or release 2026-11-04github.com/bortlesboat/bitcoin-api ↗Bestanden
- OpenSSF ScorecardNicht geprüft
- Package-Name ähnelt keinem populären PackageNicht geprüft
- Keine kritischen Advisories im Paket oder seinen AbhängigkeitenNicht geprüft
- Keine versteckten Anweisungen an das Modell0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersBestanden
- Destruktive Tools sind markiertNicht geprüft
- Remote-Endpoint beantwortet den MCP-HandshakeNicht geprüft
README
Auf GitHub ansehen
Satoshi API
Stop overpaying Bitcoin fees. Know when to send.
Self-Hosting · PyPI · MCP Server · Discord Bot
Self-hostable · MCP-ready · x402-capable · Apache 2.0
Bad fee timing burns sats on every Bitcoin transaction. Satoshi API tells you when to send, what to pay, and whether to wait — combining multiple estimatesmartfee targets with real-time mempool state. Instead of just "4 sat/vB", you get "Fees are low. Good time to send." One pip install, self-hostable, open source.
[!IMPORTANT] The former hosted Satoshi API demo and x402 facilitator are paused.
bitcoinsapi.comnow runs a separate edge project, so this repo's endpoints are self-host only.
Install & Run
pip install satoshi-api
export BITCOIN_RPC_USER=your_user BITCOIN_RPC_PASSWORD=your_password
satoshi-api
# API: http://localhost:9332
# Docs: http://localhost:9332/docs
Example
curl http://localhost:9332/api/v1/fees/recommended | jq
{
"data": {
"recommendation": "Fees are low. Good time to send.",
"estimates": { "high": 4, "medium": 2, "low": 1 }
},
"meta": { "timestamp": "...", "node_height": 939462, "chain": "main" }
}
Core Endpoints
| Category | Example paths | Highlights |
|---|---|---|
| Fees | /api/v1/fees/recommended, /api/v1/fees/plan |
Recommendations, landscape ("send now or wait?"), history, mempool-blocks |
| Transactions | /api/v1/tx/{txid}, /api/v1/broadcast |
Decoded analysis, status, outspends, UTXO lookup, broadcast |
| Mempool | /api/v1/mempool, /api/v1/mempool/recent |
Congestion score, fee buckets, recent entries |
| Blocks | /api/v1/blocks/latest, /api/v1/blocks/{height_or_hash} |
Latest block, by height/hash, stats, txids, header |
| Mining | /api/v1/mining, /api/v1/mining/nextblock |
Hashrate, difficulty, next block template |
| Network | /api/v1/network, /api/v1/network/difficulty |
Peers, forks, difficulty, address validation |
| Streams | /api/v1/stream/blocks, /api/v1/stream/fees |
Real-time blocks & fees via SSE |
...and more (prices, address lookups, exchange comparison). A self-hosted instance serves its interactive docs at /docs.
For AI Agents
bitcoin-mcp provides 50 standard Bitcoin tools, 6 prompts, and 8 resources for AI agents. It connects to your Bitcoin Core/Knots node or an explicitly configured compatible API.
# Install and point at your Satoshi API instance
pip install "git+https://github.com/Bortlesboat/bitcoin-mcp.git"
SATOSHI_API_URL=http://127.0.0.1:9332 bitcoin-mcp
Or connect to a local node directly:
{
"mcpServers": {
"bitcoin": { "command": "bitcoin-mcp" }
}
}
For repo-native agent instructions, use docs/AGENT_INTEGRATION.md. It includes copy-paste snippets for AGENTS.md, CLAUDE.md, .github/copilot-instructions.md, Cursor/Windsurf rules, MCP config, and x402 paid calls.
The API's separate, optional HTTP MCP endpoint at /mcp requires pip install -e '.[mcp]' from this checkout. This uses the MCP SDK 2.x API (mcp>=2.3,<3); the development extra also installs it so the MCP tests run in a fresh environment.
With the bitcoin-api-x402 extension installed, a self-hosted instance lists its paid endpoints at /.well-known/x402. The paid flow is: discover them, request a paid /api/v1 endpoint, read PAYMENT-REQUIRED, then retry with PAYMENT-SIGNATURE.
Self-Hosting
pip install satoshi-api
satoshi-api # runs on :9332
# Expose publicly (free HTTPS + DDoS protection)
cloudflared tunnel --url http://localhost:9332
See self-hosting guide for full production setup.
Research Export
For offline fee-forecasting work, the repo now includes a local JSONL export path with documented observation features and 1-6 block clearing-fee outcomes.
$env:PYTHONPATH='src'
python scripts/export_fee_forecast_benchmark.py data/fee-forecast-benchmark.jsonl --hours 168 --interval-minutes 10
The export joins local fee_history observations to the next 1-6 confirmed blocks from the research tables in data/bitcoin_api.db. After migration 012_add_research_tables.sql, the background fee collector seeds the current tip, captures missed heights and reorg replacements in block_confirmations, and logs fee estimates every cycle, so a normal local API run can build this export without extra manual seeding. Very recent observations without six future block outcomes are skipped automatically.
Contributing
Issues and PRs welcome. Run the test suite before submitting:
pip install -e ".[dev]"
python -m pytest tests/ -q --ignore=tests/test_e2e.py --ignore=tests/locustfile.py
Roadmap
See docs/ROADMAP.md for ideas under consideration (not scheduled while the hosted service is paused): indexer expansion, multi-network support, fee prediction, SDKs, and more.
Support This Project
Satoshi API is free, open-source Bitcoin infrastructure. You can support the maintainer through GitHub Sponsors, report reproducible issues, or contribute tests and documentation.
Related Projects
- bitcoin-mcp — MCP server with 50 standard Bitcoin tools for AI agents
- ChainPulse — AI-powered Bitcoin network intelligence CLI
- BAIP-1 — Bitcoin Agent Identity Protocol
License
Apache 2.0 — see LICENSE.
Self-Hosting · PyPI · MCP Server · Roadmap
Maintained by Andrew Barnes / Bortlesboat. Run the unit-test command above for the current result; a passing local suite does not establish hosted-service availability.
Satoshi API MCP Fragen
Was macht die Satoshi API?
Sie liefert Bitcoin-Fee-Empfehlungen, Mempool-Congestion-Scores, Transaktionsanalysen und Blockdaten, um Nutzern zu helfen zu entscheiden, wann sie Transaktionen senden sollten.
Ist eine gehostete Version verfügbar?
Nein, die ehemalige gehostete Satoshi API Demo und der x402 Facilitator sind derzeit pausiert; die Endpoints sind nur für das Self-Hosting gedacht.