sats4ai-mcp

El supercargador de comunicación sin permisos para agentes de IA. Más de 40 herramientas pagadas con Bitcoin Lightning. Sin registro, sin claves API, sin KYC.

Un servidor MCP (Model Context Protocol) remoto que brinda a los agentes de IA acceso a llamadas telefónicas de IA en cualquier idioma, voz en 602 idiomas, traducción en 119, fax, SMS, transcripción, audiolibros, generación de imágenes, música, extracción de documentos y más; todo pagado por uso con micropagos de Lightning Network.

Configuración rápida

Claude Desktop

Añade 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

Verifica la conexión: pídele al agente "list the first 3 Sats4AI models" (lista los 3 primeros modelos de Sats4AI); debería llamar a list_models y devolver resultados. Para agentes que pagan facturas de forma autónoma, añade también un MCP de monedero Lightning (consulta Pago mediante monederos de agente).

Cursor

Settings → MCP → Edit Config, y luego añade:

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

Reinicia Cursor. En un chat nuevo, pregunta "what Sats4AI tools are available?" (¿qué herramientas de Sats4AI están disponibles?) para confirmar el descubrimiento de herramientas. Para pagos autónomos, vincúlalo con un MCP de monedero Lightning (consulta Pago mediante monederos de agente).

Windsurf

Edita ~/.codeium/windsurf/mcp_config.json (créalo si no existe). Importante: Windsurf utiliza serverUrl (no url) para servidores MCP HTTP remotos:

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

Reinicia Windsurf. Las herramientas de Sats4AI aparecerán en la lista de herramientas de Cascade. Cascade tiene un límite de 100 herramientas en todos los MCP, así que mantén el conjunto activo reducido. Para pagos autónomos, vincúlalo con un MCP de monedero Lightning (consulta Pago mediante monederos de agente).

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 del monedero 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 monedero compatible con LNURL o la herramienta claim_lnurl_withdraw de lightning-wallet.

Pago mediante monederos de agente

Vincula con un servidor MCP de monedero 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: "..." } } }

Seguridad

¿Has encontrado una vulnerabilidad? No abras un issue público. Envía un correo electrónico a sats4ai@gmail.com. Consulta SECURITY.md para conocer la política de divulgación completa y el alcance.

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

• Política de seguridad: SECURITY.md

Licencia

MIT