Maximum Sats

io.github.joelklaboPublished by GitHub account joelklabov1.0.0Updated Oct 24, 2026

Bitcoin & Lightning Network AI tools with native Lightning L402 micropayments.

VerifiedSTDIODesktop onlyFinanceSecurity & MonitoringAI & ML

Overview

AI-generated overview

A local MCP server giving assistants Bitcoin and Lightning AI tools plus Nostr Web of Trust reputation scoring, with pay-per-call Lightning L402 payments.

What you can do
Exposes Bitcoin and Lightning AI tools such as ask_bitcoin (a language-model Q&A endpoint) and generate_image (text-to-image), each priced in satoshis and gated behind Lightning L402 payment. It also provides Nostr Web of Trust tools: trust scores, Sybil detection, trust paths, network health metrics, follow-list quality, trust circles, anomaly detection, link prediction, cross-provider score comparison, and influence simulation. A free daily quota applies to the Web of Trust endpoints.
When to use it
Useful when an assistant needs Bitcoin or Lightning answers, generated images, or Nostr reputation and Sybil-resistance checks, for example screening accounts before paying bounties or assessing trust between pubkeys. It is aimed at pay-per-call access rather than subscription-based API use.
Requirements
Runs as a local process via npx (Node.js required). Network access to maximumsats.com and wot.klabo.world. Paid tools require a Lightning wallet to pay the returned invoice and a retry carrying the payment hash in the Authorization header. No environment variables or headers are declared in the manifest.
Before you install
Paid tools spend real satoshis: ask_bitcoin costs 21 sats and generate_image 100 sats per call, settled over the Lightning Network. Payment uses an invoice and payment hash in the Authorization header; treat that hash as a credential. Prompts and pubkeys are sent to third-party services (maximumsats.com, wot.klabo.world).

Installation

In SourceWeft

  1. Open Maximum Sats in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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

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

sh
npx maximumsats-mcp

Or add to your MCP client config:

json
{  "mcpServers": {    "maximumsats": {      "command": "npx",      "args": ["maximumsats-mcp"]    }  }}

Tools

AI Tools (maximumsats.com)

ToolCostDescription
ask_bitcoin21 satsAsk about Bitcoin/Lightning (Llama 3.3 70B)
generate_image100 satsText-to-image (FLUX.1 Schnell 12B)

Web of Trust (wot.klabo.world) — 50 free/day

ToolDescription
wot_scorePageRank trust score (0-100) with rank and percentile
wot_sybil_check5-signal Sybil detection (genuine/suspicious/likely_sybil)
wot_trust_pathHop-by-hop trust path between two pubkeys
wot_network_healthNetwork metrics: 51K+ nodes, Gini coefficient, density
wot_follow_qualityFollow list quality analysis with suggestions
wot_trust_circleMutual follows with trust strength and cohesion
wot_anomaliesGhost followers, asymmetric patterns, cluster detection
wot_predict_linkLink prediction (5 topology signals)
wot_compare_providersCross-provider NIP-85 trust score consensus
wot_influenceSimulate 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:

bash
# Request returns HTTP 402 with Lightning invoicecurl -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
bash
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):

javascript
// 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

Quick Examples

Get Started: One Payment, One Retry L402 Flow

The MaximumSats API uses L402 — here's exactly how to pay and get results:

bash
# 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

bash
curl -s "https://wot.klabo.world/score/npub1..." | jq '.score'# Returns: {"score": 42, "rank": 1234, "percentile": 95.5}

Decode a Lightning invoice before payment

bash
curl -X POST "https://maximumsats.com/api/bolt11-decode" \  -H "Content-Type: application/json" \  -d '{"invoice":"lnbc..."}'# Returns: amount, description_hash, expiry, payee pubkey

Verify a Nostr identity (NIP-05)

bash
curl -X POST "https://maximumsats.com/api/nip05-verify" \  -H "Content-Type: application/json" \  -d '{"identifier":"[email protected]"}'# Returns: pubkey, valid boolean, relay hints

License

MIT

Source: README.md at commit b974195

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.0.0LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts