maximumsats-mcp

Servidor MCP Maximum Sats

Servidor MCP para ferramentas de IA Bitcoin e pontuação Web of Trust do Nostr. Pagamento por uso via Lightning L402.

Por que MaximumSats?

Com a proliferação de servidores MCP, surge uma questão crítica: Como proteger e monetizar o acesso à API MCP de forma descentralizada?

A MaximumSats oferece:

• Endpoints de Pagamento L402 — Cada chamada de API pode exigir pagamento em satoshis
• Pontuação Web of Trust (WoT) — Reputação resistente a Sybil para usuários do Nostr
• Utilitários de ID Nostr — Decodificação/codificação de npub, note, nprofile, nevent, naddr e mais

Casos de Uso

• Plataformas de Recompensas — Pague caçadores por tarefa, previna sybil com WoT
• Marketplaces de Agentes de IA — Monetize ferramentas MCP por chamada
• Feeds de Dados — Proteja dados de oráculos com L402
• Sistemas de Reputação — Pontuação de confiança baseada em WoT

Instalação

npx maximumsats-mcp

Ou adicione à configuração do seu cliente MCP:

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

Ferramentas

Ferramentas de IA (maximumsats.com)

Ferramenta	Custo	Descrição
ask_bitcoin	21 sats	Pergunte sobre Bitcoin/Lightning (Llama 3.3 70B)
generate_image	100 sats	Texto para imagem (FLUX.1 Schnell 12B)

Web of Trust (wot.klabo.world) — 50 grátis/dia

Ferramenta	Descrição
wot_score	Pontuação de confiança PageRank (0-100) com classificação e percentil
wot_sybil_check	Detecção de Sybil com 5 sinais (genuíno/suspeito/provável_sybil)
wot_trust_path	Caminho de confiança salto a salto entre duas pubkeys
wot_network_health	Métricas de rede: 51K+ nós, coeficiente de Gini, densidade
wot_follow_quality	Análise de qualidade da lista de seguidores com sugestões
wot_trust_circle	Seguimentos mútuos com força de confiança e coesão
wot_anomalies	Seguidores fantasmas, padrões assimétricos, detecção de clusters
wot_predict_link	Previsão de conexões (5 sinais topológicos)
wot_compare_providers	Consenso de pontuação de confiança NIP-85 entre provedores
wot_influence	Simule efeitos em cascata de seguir/deixar de seguir

Recursos de Segurança e Governança

A MaximumSats é construída especificamente para a trilha Secure & Govern MCP:

1. Controle de Acesso à API Pago — Um Pagamento, Uma Tentativa

Cada endpoint pode ser protegido por pagamento. O fluxo L402 é simples:

# 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. Resistência a Sybil com WoT

O endpoint WoT pontua pubkeys do Nostr com base na posição delas na rede — valioso para:

• Plataformas de recompensas que previnem contas falsas
• Sistemas de votação que precisam de resistência a Sybil
• Mecanismos de reputação

curl https://maximumsats.com/api/wot/npub1...
# Returns: {"score": 45, "rank": 1234, "percentile": 95.5}

3. Sem Intermediários — Lightning Direto

• Liquidação instantânea na Rede Lightning
• Sem assinaturas, pague por solicitação
• Pseudônimo, sem KYC obrigatório

Implementação Técnica

A MaximumSats usa o protocolo L402 (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: { ... } }

Todo o pagamento flui pela Rede Lightning — sem inchaço de blockchain.

APIs

• maximumsats.com/stats — Preços das ferramentas de IA
• wot.klabo.world/docs — Documentação interativa da API WoT
• wot.klabo.world/openapi.json — Especificação OpenAPI 3.0

Exemplos Rápidos

Comece: Fluxo L402 de Um Pagamento, Uma Tentativa

A API MaximumSats usa L402 — veja exatamente como pagar e obter resultados:

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

Verifique a reputação de um usuário antes de pagar uma recompensa

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

Decodifique uma fatura Lightning antes do pagamento

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

Verifique uma identidade Nostr (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 hints

Licença

MIT