maximumsats-mcp

Servidor MCP Maximum Sats

Servidor MCP para herramientas de IA de Bitcoin y puntuación de Web of Trust de Nostr. Pago por uso vía Lightning L402.

¿Por qué MaximumSats?

A medida que proliferan los servidores MCP, surge una pregunta crítica: ¿Cómo aseguramos y monetizamos el acceso a la API de MCP de manera descentralizada?

MaximumSats ofrece:

• Endpoints de pago L402 — Cada llamada a la API puede requerir pago en satoshis
• Puntuación Web of Trust (WoT) — Reputación resistente a Sybil para usuarios de Nostr
• Utilidades de ID de Nostr — Decodificación/codificación de npub, note, nprofile, nevent, naddr, y más

Casos de uso

• Plataformas de recompensas — Pagar a cazadores por tarea, prevenir sybil con WoT
• Mercados de agentes de IA — Monetizar herramientas MCP por llamada
• Fuentes de datos — Asegurar datos de oráculos con L402
• Sistemas de reputación — Puntuación de confianza impulsada por WoT

Instalación

npx maximumsats-mcp

O añade a la configuración de tu cliente MCP:

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

Herramientas

Herramientas de IA (maximumsats.com)

Herramienta	Coste	Descripción
ask_bitcoin	21 sats	Pregunta sobre Bitcoin/Lightning (Llama 3.3 70B)
generate_image	100 sats	Texto a imagen (FLUX.1 Schnell 12B)

Web of Trust (wot.klabo.world) — 50 gratis/día

Herramienta	Descripción
wot_score	Puntuación de confianza PageRank (0-100) con rango y percentil
wot_sybil_check	Detección de Sybil de 5 señales (genuino/sospechoso/probable_sybil)
wot_trust_path	Ruta de confianza salto a salto entre dos pubkeys
wot_network_health	Métricas de red: 51K+ nodos, coeficiente de Gini, densidad
wot_follow_quality	Análisis de calidad de lista de seguidos con sugerencias
wot_trust_circle	Seguidos mutuos con fuerza de confianza y cohesión
wot_anomalies	Seguidores fantasma, patrones asimétricos, detección de clústeres
wot_predict_link	Predicción de enlaces (5 señales topológicas)
wot_compare_providers	Consenso de puntuación de confianza NIP-85 entre proveedores
wot_influence	Simular efectos de onda de seguir/dejar de seguir

Características de Seguridad y Gobernanza

MaximumSats está diseñado específicamente para la pista Secure & Govern MCP:

1. Control de Acceso a API de Pago — Un Pago, Un Reintento

Cada endpoint puede estar protegido por pago. El flujo L402 es 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. Resistencia a Sybil con WoT

El endpoint WoT puntúa pubkeys de Nostr según su posición en la red — valioso para:

• Plataformas de recompensas que previenen cuentas falsas
• Sistemas de votación que necesitan resistencia a Sybil
• Motores de reputación

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

3. Sin Intermediarios — Lightning Directo

• Liquidación instantánea en la red Lightning
• Sin suscripciones, pago por solicitud
• Seudónimo, sin KYC requerido

Implementación Técnica

MaximumSats utiliza el 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 el pago fluye a través de la red Lightning — sin inflar la blockchain.

APIs

• maximumsats.com/stats — Precios de herramientas de IA
• wot.klabo.world/docs — Documentación interactiva de la API WoT
• wot.klabo.world/openapi.json — Especificación OpenAPI 3.0

Ejemplos Rápidos

Comenzar: Flujo L402 de Un Pago, Un Reintento

La API de MaximumSats usa L402 — aquí está exactamente cómo pagar y obtener 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":{...}}

Verificar la reputación de un usuario antes de pagar una recompensa

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

Decodificar una factura Lightning antes del pago

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

Verificar una identidad 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

Licencia

MIT