{
  "markdown": "# Maximum Sats MCP Server\n\nMCP server for Bitcoin AI tools and Nostr Web of Trust scoring. Pay-per-use via Lightning [L402](https://docs.lightning.engineering/the-lightning-network/l402).\n\n## Why MaximumSats?\n\nAs MCP servers proliferate, a critical question emerges: **How do we secure and monetize MCP API access in a decentralized way?**\n\nMaximumSats delivers:\n- **L402 Payment Endpoints** — Every API call can require payment in satoshis\n- **Web of Trust (WoT) Scoring** — Sybil-resistant reputation for Nostr users  \n- **Nostr ID Utilities** — Decoding/encoding npub, note, nprofile, nevent, naddr, and more\n\n## Use Cases\n\n- **Bounty Platforms** — Pay hunters per task, prevent sybil with WoT\n- **AI Agent Marketplaces** — Monetize MCP tools per-call\n- **Data Feeds** — Secure oracle data with L402\n- **Reputation Systems** — WoT-powered trust scoring\n\n## Install\n\n```sh\nnpx maximumsats-mcp\n```\n\nOr add to your MCP client config:\n\n```json\n{\n  \"mcpServers\": {\n    \"maximumsats\": {\n      \"command\": \"npx\",\n      \"args\": [\"maximumsats-mcp\"]\n    }\n  }\n}\n```\n\n## Tools\n\n### AI Tools (maximumsats.com)\n\n| Tool | Cost | Description |\n|------|------|-------------|\n| `ask_bitcoin` | 21 sats | Ask about Bitcoin/Lightning (Llama 3.3 70B) |\n| `generate_image` | 100 sats | Text-to-image (FLUX.1 Schnell 12B) |\n\n### Web of Trust (wot.klabo.world) — 50 free/day\n\n| Tool | Description |\n|------|-------------|\n| `wot_score` | PageRank trust score (0-100) with rank and percentile |\n| `wot_sybil_check` | 5-signal Sybil detection (genuine/suspicious/likely_sybil) |\n| `wot_trust_path` | Hop-by-hop trust path between two pubkeys |\n| `wot_network_health` | Network metrics: 51K+ nodes, Gini coefficient, density |\n| `wot_follow_quality` | Follow list quality analysis with suggestions |\n| `wot_trust_circle` | Mutual follows with trust strength and cohesion |\n| `wot_anomalies` | Ghost followers, asymmetric patterns, cluster detection |\n| `wot_predict_link` | Link prediction (5 topology signals) |\n| `wot_compare_providers` | Cross-provider NIP-85 trust score consensus |\n| `wot_influence` | Simulate follow/unfollow ripple effects |\n\n## Security & Governance Features\n\nMaximumSats is purpose-built for the **Secure & Govern MCP** track:\n\n### 1. Paid API Access Control — One Payment, One Retry\nEvery endpoint can be gated behind payment. The L402 flow is simple:\n\n```bash\n# Request returns HTTP 402 with Lightning invoice\ncurl -X POST https://maximumsats.com/api/dvm \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"prompt\":\"hello\"}'\n# Returns: {\"error\":\"Payment required\",\"payment_request\":\"lnbc21...\",\"payment_hash\":\"abc123\",\"amount_sats\":21}\n\n# Pay the invoice in your Lightning wallet, then retry with payment_hash in Authorization header:\ncurl -X POST https://maximumsats.com/api/dvm \\\n  -H \"Content-Type: application/json\" \\\n  -H \"Authorization: abc123\" \\\n  -d '{\"prompt\":\"hello\"}'\n# Returns: {\"status\":\"success\",\"data\":{...}}\n```\n\n### 2. Sybil Resistance with WoT\nThe WoT endpoint scores Nostr pubkeys based on their network position — valuable for:\n- Bounty platforms preventing fake accounts\n- Voting systems needing sybil resistance\n- Reputation engines\n```bash\ncurl https://maximumsats.com/api/wot/npub1...\n# Returns: {\"score\": 45, \"rank\": 1234, \"percentile\": 95.5}\n```\n\n### 3. No Middleman — Direct Lightning\n- Instant settlement on Lightning Network\n- No subscriptions, pay per request\n- Pseudonymous, no KYC required\n\n## Technical Implementation\n\nMaximumSats uses the L402 protocol (Lightning HTTP 402):\n\n```javascript\n// Challenge response includes invoice\n{ status: 402, error: \"Payment required\", invoice: \"lnbc...\", amount_sats: 21 }\n\n// After payment, include payment_hash in retry\n{ status: 402, error: \"Payment required\", payment_hash: \"abc123...\" }\n\n// Successful response after payment verification\n{ status: 200, data: { ... } }\n```\n\nAll payment flows through Lightning Network — no blockchain bloat.\n\n## APIs\n\n- [maximumsats.com/stats](https://maximumsats.com/stats) — AI tools pricing\n- [wot.klabo.world/docs](https://wot.klabo.world/docs) — WoT API interactive docs\n- [wot.klabo.world/openapi.json](https://wot.klabo.world/openapi.json) — OpenAPI 3.0 spec\n\n## Quick Examples\n\n### Get Started: One Payment, One Retry L402 Flow\n\nThe MaximumSats API uses L402 — here's exactly how to pay and get results:\n\n```bash\n# Step 1: Request (returns 402 with Lightning invoice)\ncurl -X POST \"https://maximumsats.com/api/bolt11-decode\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"invoice\":\"lnbc1...\"}'\n\n# Response: {\"error\":\"Payment required\",\"payment_request\":\"lnbc...\",\"payment_hash\":\"abc123...\",\"amount_sats\":21}\n\n# Step 2: Pay the invoice in your Lightning wallet, then retry with payment_hash:\ncurl -X POST \"https://maximumsats.com/api/bolt11-decode\" \\\n  -H \"Content-Type: application/json\" \\\n  -H \"Authorization: abc123...\" \\\n  -d '{\"invoice\":\"lnbc1...\"}'\n\n# Response: {\"status\":\"success\",\"data\":{...}}\n```\n\n### Check a user's reputation before paying a bounty\n```bash\ncurl -s \"https://wot.klabo.world/score/npub1...\" | jq '.score'\n# Returns: {\"score\": 42, \"rank\": 1234, \"percentile\": 95.5}\n```\n\n### Decode a Lightning invoice before payment\n```bash\ncurl -X POST \"https://maximumsats.com/api/bolt11-decode\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"invoice\":\"lnbc...\"}'\n# Returns: amount, description_hash, expiry, payee pubkey\n```\n\n### Verify a Nostr identity (NIP-05)\n```bash\ncurl -X POST \"https://maximumsats.com/api/nip05-verify\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"identifier\":\"bob@nostr.com\"}'\n# Returns: pubkey, valid boolean, relay hints\n```\n\n## License\n\nMIT\n",
  "bytes": 5608,
  "sha": "817b0c853698da5ca359fb1869f0a246b62ca5ead55cea3e3241e018f4448e79",
  "repo_slug": "joelklabo/maximumsats-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_com_maximumsats_maximumsats_f5b1b949/readme"
}