sats4ai-mcp

Más de 30 herramientas de IA pagadas con Bitcoin Lightning. Sin registro, sin claves API, sin KYC.

Un servidor remoto MCP (Model Context Protocol) que brinda a los agentes de IA acceso a generación de imágenes, creación de vídeo, generación de texto, voz, traducción, procesamiento de imágenes, OCR, conversión de audiolibros, correo electrónico, SMS, clonación de voz y más; todo pagado por uso con micropagos de Lightning Network.

Configuración rápida

Claude Desktop

Añadir a tu claude_desktop_config.json:

{
  "mcpServers": {
    "sats4ai": {
      "url": "https://sats4ai.com/api/mcp"
    }
  }
}

Claude Code

claude mcp add sats4ai --transport http https://sats4ai.com/api/mcp

Cursor

Añadir a tu configuración de MCP:

{
  "mcpServers": {
    "sats4ai": {
      "url": "https://sats4ai.com/api/mcp"
    }
  }
}

Proxy stdio (clientes MCP heredados)

Para clientes que no admiten servidores HTTP remotos, utiliza el proxy stdio incluido:

npx sats4ai-mcp

O en tu configuración:

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

Cualquier cliente MCP

La URL del servidor es:

https://sats4ai.com/api/mcp

Este es un servidor HTTP remoto: sin procesos locales, sin dependencias, sin necesidad de instalación.

Related MCP server: PDF Reader MCP Server

Herramientas disponibles

Generación de IA

Audio y voz

Procesamiento de imágenes

Visión y documentos

Comunicación

Herramientas auxiliares

Cómo funciona

1. El agente llama a list_models para descubrir los modelos disponibles y los precios.

2. El agente llama a create_payment y obtiene una factura Lightning.

3. Se realiza el pago a través de la billetera Lightning del agente (p. ej., lightning-wallet-mcp).

4. El agente llama a la herramienta (p. ej., image, text) con el paymentId.

5. Se devuelve el resultado: imagen en base64, texto, URL, etc.

Sin claves API. Sin cuentas. Sin límites de tasa vinculados a la identidad. Solo Bitcoin e IA.

Manejo de errores y reembolsos

Cuando una herramienta de pago falla después del pago, la respuesta de error JSON-RPC incluye información de reembolso:

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32603,
    "message": "Image generation failed",
    "data": {
      "refund": {
        "charge_id": 12345,
        "refund_amount": 200,
        "lnurl_withdraw": "lnurl1dp68gurn8ghj7..."
      }
    }
  }
}

Reclama el reembolso usando cualquier billetera compatible con LNURL o la herramienta claim_lnurl_withdraw de lightning-wallet.

Pago a través de billeteras de agente

Combínalo con un servidor MCP de billetera Lightning para que tu agente pueda pagar de forma autónoma:

{
  "mcpServers": {
    "sats4ai": {
      "url": "https://sats4ai.com/api/mcp"
    },
    "lightning-wallet": {
      "command": "npx",
      "args": ["lightning-wallet-mcp"]
    }
  }
}

El agente utiliza lightning-wallet para pagar facturas de sats4ai, lo que permite el uso de herramientas de IA totalmente autónomas.

API L402

Para una integración HTTP directa sin MCP, utiliza la API L402:

# Step 1: Request -> get 402 + Lightning invoice
curl -X POST https://sats4ai.com/api/l402/generate-image \
  -H "Content-Type: application/json" \
  -d '{"input": {"prompt": "a cat in space"}}' -i

# Step 2: Pay the invoice with any Lightning wallet

# Step 3: Re-send with proof
curl -X POST https://sats4ai.com/api/l402/generate-image \
  -H "Content-Type: application/json" \
  -H "Authorization: L402 <macaroon>:<preimage>" \
  -d '{"input": {"prompt": "a cat in space"}}'

Documentación completa de L402: sats4ai.com/l402 | Ejemplos de código: sats4ai-l402-examples

Descubrimiento de servicios

Endpoints legibles por máquina para el descubrimiento de agentes:

# Full service catalog with pricing, quality benchmarks, and performance metadata
GET https://sats4ai.com/.well-known/l402-services

# MCP tool catalog with latency (p50/p95), reliability, and failure modes
GET https://sats4ai.com/api/mcp/discovery

# Semantic search — find tools by capability
GET https://sats4ai.com/api/discover?q=translate

# Per-service metadata with enums and input schemas
GET https://sats4ai.com/api/l402/{service}

Cada herramienta de pago incluye metadatos de rendimiento (latencia p50/p95, calificación de fiabilidad, modos de fallo conocidos) para que los agentes puedan tomar decisiones informadas sobre qué herramientas llamar y cuánto tiempo esperar.

Uso programático

const { SERVER_URL, TOOLS, getClaudeConfig } = require("sats4ai-mcp");

console.log(SERVER_URL);       // "https://sats4ai.com/api/mcp"
console.log(TOOLS);            // ["image", "video", "text", ...]
console.log(getClaudeConfig()) // { mcpServers: { sats4ai: { url: "..." } } }

Enlaces

• Sitio web: sats4ai.com

• Documentación MCP: sats4ai.com/mcp

• Documentación API L402: sats4ai.com/l402

• Ejemplos de código L402: github.com/cnghockey/sats4ai-l402-examples

• Descubrimiento de servicios: sats4ai.com/.well-known/l402-services

• Búsqueda semántica: sats4ai.com/api/discover

Licencia

MIT