Skip to main content

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

satoshiapi_mcp-1.0.3.tar.gz (5.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

satoshiapi_mcp-1.0.3-py3-none-any.whl (5.9 kB view details)

Uploaded Python 3

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

Hashes for satoshiapi_mcp-1.0.3.tar.gz
Algorithm Hash digest
SHA256 3049c9f42469dac60d8b2b1a07e0fbf4549a2e7fa589a459d200059239e48405
MD5 5c1180cca0afaa9212b0617866ee403a
BLAKE2b-256 464de7e17fb36d698acda212565edf0511f7802fd622a2c265bcbe0134e3229c

See more details on using hashes here.

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

Hashes for satoshiapi_mcp-1.0.3-py3-none-any.whl
Algorithm Hash digest
SHA256 4e5c070c4cd0ec8c8ed56f94cdaec32b25944e2b11d1bb96fb5552cde49f7bec
MD5 fcbb8f011c7aa8f078b1065407e21479
BLAKE2b-256 408fbf5480e4255c69d723eb6da17b5f0cd0eb4c30c8dac764a3c1de67085102

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page