MCP server for SatoshiAPI — Bitcoin intelligence via Lightning micropayments
Project description
mcp-name: io.satoshiapi/mcp
SatoshiAPI MCP Server ⚡
Model Context Protocol server for SatoshiAPI — Bitcoin intelligence via Lightning micropayments.
Pay-per-call Bitcoin data for AI agents: price, mempool fees, DCA signals, whale activity, market regime, risk score, and more. 10–200 sats per call via L402. No accounts, no API keys.
Hosted MCP Server (recommended)
Connect directly — no installation needed:
https://api.satoshiapi.io/mcp
Any MCP client (Claude, Cursor, etc.) can connect instantly. Payments are handled per-call via L402 Lightning.
Self-hosted (pip install)
pip install satoshiapi-mcp
Configure in Claude Desktop (~/.config/claude/claude_desktop_config.json):
{
"mcpServers": {
"satoshiapi": {
"command": "python3",
"args": ["-m", "satoshiapi_mcp"],
"env": {
"SATOSHIAPI_LND_REST": "https://your-lnd:8079",
"SATOSHIAPI_LND_MACAROON": "/path/to/invoice.macaroon",
"SATOSHIAPI_LND_CERT": "/path/to/tls.cert"
}
}
}
}
Tools (15 total)
| Tool | Cost | Description |
|---|---|---|
get_btc_price |
10 sats | BTC/USD + 24h change |
get_mempool_fees |
10 sats | Fee estimates (sat/vB) |
get_block_height |
10 sats | Block height + hashrate |
get_halving_info |
10 sats | Halving countdown + supply |
get_tx_info |
10 sats | Transaction details |
get_sentiment |
25 sats | Fear & Greed index |
get_fees_forecast |
25 sats | Optimal send timing |
get_lightning_stats |
25 sats | LN capacity + node stats |
get_address_info |
25 sats | Address balance + UTXOs |
get_dca_signal |
50 sats | STRONG_BUY/BUY/HOLD/REDUCE |
get_market_summary |
50 sats | Full market snapshot |
get_whale_activity |
100 sats | Large tx + exchange flows |
get_market_regime |
150 sats | Bull/bear/crab + confidence |
get_risk_score |
200 sats | Composite risk 0–100 |
get_dca_plan |
200 sats | Personalized DCA plan |
Links
- Live API: api.satoshiapi.io
- Source: github.com/SatoshiAPI/satoshi-btc-api (MIT)
- Node:
03176f9948d333f9cc1d7d409353f995816e44b3c90a3300b5a08ceba811faf989
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file satoshiapi_mcp-1.0.3.tar.gz.
File metadata
- Download URL: satoshiapi_mcp-1.0.3.tar.gz
- Upload date:
- Size: 5.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.14.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
3049c9f42469dac60d8b2b1a07e0fbf4549a2e7fa589a459d200059239e48405
|
|
| MD5 |
5c1180cca0afaa9212b0617866ee403a
|
|
| BLAKE2b-256 |
464de7e17fb36d698acda212565edf0511f7802fd622a2c265bcbe0134e3229c
|
File details
Details for the file satoshiapi_mcp-1.0.3-py3-none-any.whl.
File metadata
- Download URL: satoshiapi_mcp-1.0.3-py3-none-any.whl
- Upload date:
- Size: 5.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.14.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
4e5c070c4cd0ec8c8ed56f94cdaec32b25944e2b11d1bb96fb5552cde49f7bec
|
|
| MD5 |
fcbb8f011c7aa8f078b1065407e21479
|
|
| BLAKE2b-256 |
408fbf5480e4255c69d723eb6da17b5f0cd0eb4c30c8dac764a3c1de67085102
|