Maximum Sats MCP
Provides tools for querying Bitcoin and Lightning Network knowledge, retrieving real-time blockchain and network statistics, and accessing Web of Trust scores for Nostr pubkeys.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Maximum Sats MCP What are the current Bitcoin and Lightning Network stats?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Maximum Sats MCP Server
MCP server for Bitcoin AI tools and Nostr Web of Trust scoring. Pay-per-use via Lightning L402.
Why MaximumSats?
As MCP servers proliferate, a critical question emerges: How do we secure and monetize MCP API access in a decentralized way?
MaximumSats delivers:
L402 Payment Endpoints — Every API call can require payment in satoshis
Web of Trust (WoT) Scoring — Sybil-resistant reputation for Nostr users
Nostr ID Utilities — Decoding/encoding npub, note, nprofile, nevent, naddr, and more
Related MCP server: AgentBTC MCP Server
Use Cases
Bounty Platforms — Pay hunters per task, prevent sybil with WoT
AI Agent Marketplaces — Monetize MCP tools per-call
Data Feeds — Secure oracle data with L402
Reputation Systems — WoT-powered trust scoring
Install
npx maximumsats-mcpOr add to your MCP client config:
{
"mcpServers": {
"maximumsats": {
"command": "npx",
"args": ["maximumsats-mcp"]
}
}
}Tools
AI Tools (maximumsats.com)
Tool | Cost | Description |
| 21 sats | Ask about Bitcoin/Lightning (Llama 3.3 70B) |
| 100 sats | Text-to-image (FLUX.1 Schnell 12B) |
Web of Trust (wot.klabo.world) — 50 free/day
Tool | Description |
| PageRank trust score (0-100) with rank and percentile |
| 5-signal Sybil detection (genuine/suspicious/likely_sybil) |
| Hop-by-hop trust path between two pubkeys |
| Network metrics: 51K+ nodes, Gini coefficient, density |
| Follow list quality analysis with suggestions |
| Mutual follows with trust strength and cohesion |
| Ghost followers, asymmetric patterns, cluster detection |
| Link prediction (5 topology signals) |
| Cross-provider NIP-85 trust score consensus |
| Simulate follow/unfollow ripple effects |
Security & Governance Features
MaximumSats is purpose-built for the Secure & Govern MCP track:
1. Paid API Access Control — One Payment, One Retry
Every endpoint can be gated behind payment. The L402 flow is simple:
# Request returns HTTP 402 with Lightning invoice
curl -X POST https://maximumsats.com/api/dvm \
-H "Content-Type: application/json" \
-d '{"prompt":"hello"}'
# Returns: {"error":"Payment required","payment_request":"lnbc21...","payment_hash":"abc123","amount_sats":21}
# Pay the invoice in your Lightning wallet, then retry with payment_hash in Authorization header:
curl -X POST https://maximumsats.com/api/dvm \
-H "Content-Type: application/json" \
-H "Authorization: abc123" \
-d '{"prompt":"hello"}'
# Returns: {"status":"success","data":{...}}2. Sybil Resistance with WoT
The WoT endpoint scores Nostr pubkeys based on their network position — valuable for:
Bounty platforms preventing fake accounts
Voting systems needing sybil resistance
Reputation engines
curl https://maximumsats.com/api/wot/npub1...
# Returns: {"score": 45, "rank": 1234, "percentile": 95.5}3. No Middleman — Direct Lightning
Instant settlement on Lightning Network
No subscriptions, pay per request
Pseudonymous, no KYC required
Technical Implementation
MaximumSats uses the L402 protocol (Lightning HTTP 402):
// Challenge response includes invoice
{ status: 402, error: "Payment required", invoice: "lnbc...", amount_sats: 21 }
// After payment, include payment_hash in retry
{ status: 402, error: "Payment required", payment_hash: "abc123..." }
// Successful response after payment verification
{ status: 200, data: { ... } }All payment flows through Lightning Network — no blockchain bloat.
APIs
maximumsats.com/stats — AI tools pricing
wot.klabo.world/docs — WoT API interactive docs
wot.klabo.world/openapi.json — OpenAPI 3.0 spec
Quick Examples
Get Started: One Payment, One Retry L402 Flow
The MaximumSats API uses L402 — here's exactly how to pay and get results:
# Step 1: Request (returns 402 with Lightning invoice)
curl -X POST "https://maximumsats.com/api/bolt11-decode" \
-H "Content-Type: application/json" \
-d '{"invoice":"lnbc1..."}'
# Response: {"error":"Payment required","payment_request":"lnbc...","payment_hash":"abc123...","amount_sats":21}
# Step 2: Pay the invoice in your Lightning wallet, then retry with payment_hash:
curl -X POST "https://maximumsats.com/api/bolt11-decode" \
-H "Content-Type: application/json" \
-H "Authorization: abc123..." \
-d '{"invoice":"lnbc1..."}'
# Response: {"status":"success","data":{...}}Check a user's reputation before paying a bounty
curl -s "https://wot.klabo.world/score/npub1..." | jq '.score'
# Returns: {"score": 42, "rank": 1234, "percentile": 95.5}Decode a Lightning invoice before payment
curl -X POST "https://maximumsats.com/api/bolt11-decode" \
-H "Content-Type: application/json" \
-d '{"invoice":"lnbc..."}'
# Returns: amount, description_hash, expiry, payee pubkeyVerify a Nostr identity (NIP-05)
curl -X POST "https://maximumsats.com/api/nip05-verify" \
-H "Content-Type: application/json" \
-d '{"identifier":"bob@nostr.com"}'
# Returns: pubkey, valid boolean, relay hintsLicense
MIT
Available Tools
12 toolsask_bitcoinA
Ask a question about Bitcoin, Lightning Network, or cryptocurrency. Powered by Llama 3.3 70B. Costs 21 sats via Lightning L402.
Inputs: prompt (required), payment_hash.
generate_imageA
Generate an image from a text prompt using FLUX.1 Schnell (12B). Costs 100 sats via Lightning L402.
Inputs: prompt (required), payment_hash.
wot_anomaliesA
Detect anomalous patterns in a Nostr pubkey's network behavior. Checks for ghost followers, asymmetric relationships, cluster patterns, and suspicious activity.
Inputs: pubkey (required), payment_hash.
wot_compare_providersB
Compare trust scores for a pubkey across multiple NIP-85 providers. Shows consensus classification and provider agreement.
Inputs: pubkey (required), payment_hash.
wot_follow_qualityA
Analyze the quality of a Nostr pubkey's follow list. Returns quality score, ghost follower ratio, diversity entropy, and improvement suggestions.
Inputs: pubkey (required), payment_hash.
wot_influenceA
Simulate what happens if one pubkey follows/unfollows another. Shows ripple effect across the network using differential PageRank.
Inputs: pubkey (required), other (required), action, payment_hash.
wot_network_healthA
Get Nostr network health metrics: node count, edge count, Gini coefficient (decentralization), power-law exponent, density, and component analysis. No pubkey needed.
Inputs: payment_hash.
wot_predict_linkA
Predict how likely two Nostr pubkeys are to connect. Uses 5 topology signals: Common Neighbors, Adamic-Adar, Preferential Attachment, Jaccard, WoT Proximity.
Inputs: source (required), target (required), payment_hash.
wot_scoreA
Look up a Nostr pubkey's Web of Trust score (PageRank-based, 0-100). Returns score, rank, percentile, followers. 50 free requests/day, then L402.
Inputs: pubkey (required), payment_hash.
wot_sybil_checkA
Run 5-signal Sybil detection on a Nostr pubkey. Analyzes follower quality, mutual trust ratio, follow diversity, temporal patterns, and community integration. Returns classification: genuine, likely_genuine, suspicious, or likely_sybil.
Inputs: pubkey (required), payment_hash.
wot_trust_circleA
Get a pubkey's trust circle (mutual follows with trust strength). Returns members with roles, cohesion, and density metrics.
Inputs: pubkey (required), payment_hash.
wot_trust_pathA
Find the trust path between two Nostr pubkeys. Shows hop-by-hop path with trust scores at each hop. Useful for 'how am I connected to this person?'
Inputs: from (required), to (required), payment_hash.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 12 tools
The tools are mostly distinct with clear purposes, but there is some overlap in the Web of Trust (WoT) analysis tools. For example, wot_anomalies and wot_sybil_check both detect suspicious activity, which could cause confusion. However, each tool's description helps differentiate them by focusing on specific aspects like network patterns versus Sybil detection signals.
The naming follows a highly consistent pattern. All Web of Trust tools use the 'wot_' prefix followed by a descriptive action or concept (e.g., wot_score, wot_trust_path). The non-WoT tools (ask_bitcoin, generate_image) also use clear verb_noun or action_object formats, maintaining overall consistency without mixing conventions.
With 12 tools, the count is well-scoped for the server's purpose of providing Bitcoin/Lightning and Nostr Web of Trust services. It covers a broad range of functionalities without being overwhelming, with 2 tools for general Bitcoin tasks and 10 dedicated to WoT analysis, each serving a distinct role in the ecosystem.
The tool set offers comprehensive coverage for Nostr Web of Trust analysis, including scoring, network health, trust paths, and anomaly detection. Minor gaps exist, such as no direct tools for modifying or managing trust relationships (e.g., follow/unfollow actions), but agents can likely work around this given the strong analytical focus.
Maintenance
Related MCP Connectors
Agent registry with Nostr identity, reputation, escrow, observability, and Lightning payments.
Bitcoin wallet intelligence for AI agents: trust, labels, tx verify, fees, and timestamps.
Give AI agents a Bitcoin wallet with Lightning Network payments and L402 support.
Bitcoin and YouTube video intelligence for AI agents. Pay-per-call via x402 USDC on Base.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables Bitcoin Lightning wallet integration with LLMs through Nostr Wallet Connect (NWC). Supports lightning payments, LNURL operations, and L402 authentication for AI-powered bitcoin transactions.126 npmApache 2.0
- AlicenseAqualityDmaintenanceEnables AI agents to perform Bitcoin and Lightning Network payments using a non-custodial, zero-trust architecture. It provides 13 tools for wallet management, invoice creation, and payment processing while keeping node credentials local to the user's machine.138 npmMIT
- AlicenseNot gradedqualityDmaintenanceLightning Network trust oracle for AI agents. Provides real-time node reachability checks, trust scores, and personalized pathfinding for 17,000+ Lightning nodes via 12 MCP tools.4 npmAGPL 3.0
- AlicenseAqualityDmaintenancePersistent memory and payment safety for AI agents on Lightning. Enables agents to remember purchases, track vendor reputations, enforce budgets, and share trust signals via Nostr.229MIT