maximumsats-mcp

by joelklabo

Not rated
GitHub

About

Bitcoin Lightning + Nostr Web-of-Trust tools for agents (L402 pay-per-call endpoints)

Details

Author
joelklabo
Categories
Developer Tools

Setup

Install maximumsats-mcp in your MCP client (Claude Desktop, Cursor, Windsurf, and others).

Repository: https://github.com/joelklabo/maximumsats-mcp

Follow the installation instructions in the repository README, then restart your MCP client.

Bitcoin Lightning + Nostr Web-of-Trust tools for agents (L402 pay-per-call endpoints)

MCP server for Bitcoin AI tools and Nostr Web of Trust scoring. Pay-per-use via LightningL402.

As MCP servers proliferate, a critical question emerges:How do we secure and monetize MCP API access in a decentralized way?

- 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

- 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

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

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

MaximumSats is purpose-built for theSecure & Govern MCPtrack:

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":{...}}

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}

- Instant settlement on Lightning Network
- No subscriptions, pay per request
- Pseudonymous, no KYC required

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.

- maximumsats.com/stats— AI tools pricing
-
wot.klabo.world/docs— WoT API interactive docs
-
wot.klabo.world/openapi.json— OpenAPI 3.0 spec

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 pubkey
curl -X POST "https://maximumsats.com/api/nip05-verify" \ -H "Content-Type: application/json" \ -d '{"identifier":"bob@nostr.com"}' # Returns: pubkey, valid boolean, relay hints

This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.

Create crafted UI components inspired by the best 21st.dev design engineers.

Bring agent evaluations, observability, and synthetic test set generation directly into your IDE for free with Galileo's new MCP server

An MCP server to help AI assistants to answer questions and generate AccelByte Extend SDK code more effectively .

MCP server for AI Diagram Maker — generate beautiful software engineering diagrams directly inside Cursor, Claude Desktop, Claude Code, or any MCP-compatible AI agent

ALAPI MCP Tools,Call hundreds of API interfaces via MCP

AI-powered SVG animation generator that transforms static files into animated SVG components using the Allyson platform

MCP server that gives AI assistants on-demand access to 1,500+ amCharts docs, ~300 code examples, and 1000+ class API references.

APIMatic MCP Server is used to validate OpenAPI specifications using APIMatic. The server processes OpenAPI files and returns validation summaries by leveraging APIMatic’s API.

One shared context layer for AI agents and humans — live API specs, DB schemas, and versioned contracts across repos so every agent and teammate works from the same source of truth.

Build and deploy full-stack Next.js apps with 98 tools for React, AWS, and MongoDB

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.