maximumsats-mcp
MCP server for Maximum Sats AI — Bitcoin & Lightning knowledge tools for AI agents.
Tools
| Tool | Description |
|---|---|
ask_bitcoin | Ask questions about Bitcoin, Lightning, Nostr, or crypto. First query per IP per day is free. |
retry_with_payment | Retry a query after paying a Lightning invoice (10 sats). |
wot_score | Look up the Web of Trust score for any Nostr pubkey. |
wot_top | Get the most trusted pubkeys on Nostr (PageRank over 51K+ nodes). |
bitcoin_stats | Get current Bitcoin and Lightning Network statistics. |
Setup
Claude Code
claude mcp add maximumsats -- npx -y github:joelklabo/maximumsats-mcp
Claude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": {
"maximumsats": {
"command": "npx",
"args": ["-y", "github:joelklabo/maximumsats-mcp"]
}
}
}
From source
git clone https://github.com/joelklabo/maximumsats-mcp.git
cd maximumsats-mcp
npm install
node index.js
How Payment Works
- Your first query per IP per 24 hours is free — no setup needed.
- After the free query, you get a Lightning invoice for 10 sats.
- Pay the invoice with any Lightning wallet.
- Use
retry_with_paymentwith thepayment_hashto get your answer.
What Can You Ask?
- "How does the Lightning Network work?"
- "What is a BOLT 12 offer?"
- "Explain Nostr NIP-90 data vending machines"
- "What are taproot assets?"
- "How does L402 authentication work?"
License
MIT