Maximum Sats — Claude Code MCP server: features and setup
The Maximum Sats MCP server queries Bitcoin and Lightning Network stats, evaluates Nostr accounts, and answers questions about decentralized technology.
no license 1,235 installs updated 2026-02-08
claude mcp add --transport http maximumsats https://maximumsats--maximumsats.run.toolsWhat Maximum Sats does
Maximum Sats gives an agent tools for questions about Bitcoin, Lightning Network, and Nostr. bitcoin_stats retrieves current Bitcoin and Lightning figures; ask_bitcoin handles questions on those subjects and related topics. Its answers come from Maximum Sats AI, powered by Llama 3.3 70B.
Use wot_score to check a Nostr public key’s Web of Trust rating, calculated from the follow graph. wot_top returns accounts with the highest ratings. The first query from an IP each day is free. Paid queries accept Lightning or USDC; after paying a Lightning invoice, a retry needs the payment_hash from the original response. Keep that requirement in mind when building a paid-query flow.
What it helps with
- retrieve current Bitcoin and Lightning Network statistics
- ask questions about Bitcoin, Lightning, or Nostr
- check a Nostr public key’s Web of Trust rating
- find Nostr accounts with high trust scores
Example prompts for the agent
- Use
bitcoin_statsto get current Bitcoin and Lightning Network figures. - Check the Web of Trust rating for this Nostr public key with
wot_score. - Ask about Nostr with
ask_bitcoin, then retry the paid query using itspayment_hashwithretry_with_payment.
How to install Maximum Sats
Platform CLI: remote server
claude mcp add --transport http maximumsats https://maximumsats--maximumsats.run.toolsPlatform CLI: remote server
codex mcp add maximum-sats --url https://maximumsats--maximumsats.run.toolsConfig file
{
"mcpServers": {
"maximum-sats": {
"url": "https://maximumsats--maximumsats.run.tools"
}
}
}Config file
{
"servers": {
"maximum-sats": {
"type": "http",
"url": "https://maximumsats--maximumsats.run.tools"
}
}
}Platform CLI: remote server
gemini mcp add -t http maximum-sats https://maximumsats--maximumsats.run.toolsStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Maximum Sats
How do I install Maximum Sats in Codex?
Run codex mcp add maximum-sats --url https://maximumsats--maximumsats.run.tools to add the MCP server.
What does Maximum Sats do?
It gives an agent tools for Bitcoin, Lightning, and Nostr questions, current network statistics, and Nostr trust-score checks.
What does a paid Lightning retry need?
After paying the invoice, provide payment_hash from the initial response to retry_with_payment.