treasury-mcp

Bitcoin network + Corporate Treasury tools for AI agents.

Forked from Bortlesboat/bitcoin-mcp and extended with 4 Corporate Treasury tools by Billy Jo (@bjunjo).

Treasury-MCP gives any AI agent (Claude, Cursor, LangChain) the ability to accurately query Bitcoin treasury company data from primary sources — SEC EDGAR, Metaplanet IR, and a curated baseline of known holdings — without hallucinating.

New Treasury Tools (4 added on top of the original 49)

Tracked Companies (MVP)

Example Queries

Once connected, ask your AI agent:

• "What is MSTR's current mNAV?"
• "How many BTC does Metaplanet hold and what is it worth in KRW?"
• "Show me all tracked Bitcoin treasury companies."
• "What is MicroStrategy's latest SEC 8-K filing about Bitcoin?"
• "Calculate the BTC-per-share for Semler Scientific."

Roadmap

• Add Korean mid-cap companies (DART filings)
• Add STRC / STRK preferred stock yield tracking
• L402 Lightning paywall for premium filing analysis
• Automated baseline updates when new filings are detected

Original bitcoin-mcp

Give any AI agent Bitcoin superpowers — fee intelligence, mempool analysis, and 49 tools. Zero config, one command.

49 tools · 116 tests · 6 prompts · 7 resources · Zero config · MIT licensed

If bitcoin-mcp is useful to you, consider giving it a star — it helps others discover the project.

pip install bitcoin-mcp

Quick Start

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "bitcoin": {
      "command": "uvx",
      "args": ["bitcoin-mcp"]
    }
  }
}

Claude Code

claude mcp add bitcoin -- uvx bitcoin-mcp

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "bitcoin": {
      "command": "uvx",
      "args": ["bitcoin-mcp"]
    }
  }
}

VS Code

Add to .vscode/mcp.json:

{
  "servers": {
    "bitcoin": {
      "command": "uvx",
      "args": ["bitcoin-mcp"]
    }
  }
}

Docker

docker build -t bitcoin-mcp .
docker run -i bitcoin-mcp

Or with docker compose:

docker compose up

Pass environment variables to connect to a local Bitcoin Core node or set your API key:

docker run -i -e SATOSHI_API_KEY=your-key bitcoin-mcp

Why bitcoin-mcp?

• Fee intelligence that saves real money — know the cheapest time to send, compare fee tiers, estimate exact costs before broadcasting
• Zero config — works instantly with the free hosted Satoshi API, or connect your own Bitcoin Core node
• First Bitcoin MCP server on the Anthropic Registry

Top Use Cases

Ask your AI agent:

Full Tool Reference

Fee Intelligence

Blocks & Transactions

Mempool

Mining

Network & Status

Address & UTXO

Indexed Address (requires blockchain indexer)

Security

Utility

Get More Requests (Free)

bitcoin-mcp works immediately with 1,000 requests/day (anonymous). Register for a free API key to get 10,000/day (10x):

1. Visit bitcoinsapi.com
2. Register for a free key (takes 10 seconds)
3. Set the SATOSHI_API_KEY environment variable in your MCP config

Configuration

All environment variables are optional. bitcoin-mcp falls back to the free hosted Satoshi API when no local node is configured.

To connect to a local Bitcoin Core node:

{
  "mcpServers": {
    "bitcoin": {
      "command": "uvx",
      "args": ["bitcoin-mcp"],
      "env": {
        "BITCOIN_RPC_HOST": "127.0.0.1",
        "BITCOIN_RPC_PORT": "8332"
      }
    }
  }
}

Prompts & Resources

6 built-in prompts for common workflows: analyze_fee_environment, investigate_transaction, monitor_mempool_fees, taproot_adoption_report, network_health_report, track_transaction

7 resources for context injection: bitcoin://connection/status, bitcoin://node/status, bitcoin://fees/current, bitcoin://mempool/snapshot, bitcoin://protocol/script-opcodes, bitcoin://protocol/address-types, bitcoin://protocol/sighash-types

Links

• Satoshi API — the hosted backend powering zero-config mode
• Anthropic MCP Registry — io.github.Bortlesboat/bitcoin-mcp
• PyPI
• GitHub
• Full tool documentation

Examples

See the examples/ folder for documented usage patterns:

• Fee Analysis — find optimal send timing
• Mempool Monitor — track congestion
• Transaction Investigation — decode and analyze transactions
• Block Analysis — inspect and compare blocks

Support This Project

bitcoin-mcp is free, open-source Bitcoin infrastructure. Support development through OpenSats.

Contributing

Contributions are welcome. See CONTRIBUTING.md for guidelines, including how to add new tools and the PR checklist.

Please report security vulnerabilities privately — see SECURITY.md.

About

bitcoin-mcp is created and maintained by Andrew Barnes. It is the most comprehensive Bitcoin MCP server available, bridging AI agents and Bitcoin infrastructure through the Model Context Protocol.

Related projects:

• Satoshi API — Bitcoin fee intelligence API, 108 endpoints (powers zero-config mode)
• ChainPulse — AI-powered Bitcoin network intelligence CLI
• BAIP-1 — Bitcoin Agent Identity Protocol
• bitcoin-fee-observatory — Fee market analytics dashboard

License

MIT