sats4ai

Mercado de herramientas impulsado por Bitcoin. Imagen, texto, video, música, voz, 3D, conversión de archivos, SMS — todo mediante micropagos Lightning. Sin necesidad de registro.

GitHub

Prueba este MCPPatrocinado

Documentación

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 remoto MCP (Model Context Protocol) que brinda a los agentes de IA acceso a llamadas telefónicas con 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

Agrega a tu claude_desktop_config.json (~/Library/Application Support/Claude/claude_desktop_config.json en macOS, %APPDATA%\Claude\claude_desktop_config.json en Windows):

{
  "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 "lista los primeros 3 modelos de Sats4AI" — debería llamar a list_models y devolver resultados. Para agentes que pagan facturas de forma autónoma, agrega también un MCP de billetera Lightning (ver Pago mediante billeteras de agente).

Cursor

Configuración → MCP → Editar configuración, luego agrega:

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

Reinicia Cursor. En un nuevo chat, pregunta "¿qué herramientas de Sats4AI están disponibles?" para confirmar el descubrimiento de herramientas. Para pagos autónomos, combínalo con un MCP de billetera Lightning (ver Pago mediante billeteras de agente).

Windsurf

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

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

Reinicia Windsurf. Las herramientas de Sats4AI aparecen 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, combínalo con un MCP de billetera Lightning (ver Pago mediante billeteras de agente).

Proxy stdio (clientes MCP heredados)

Para clientes que no admiten servidores HTTP remotos, usa 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 proceso local, sin dependencias, sin necesidad de instalación.

¿Qué puede hacer?

Una vez conectado, solo pídele a tu agente. Estos avisos ejercitan el flujo completo — descubrir, pagar la factura Lightning, obtener el resultado:

"Traduce este párrafo al español con Sats4AI — crea el pago, paga la factura con mi billetera lightning, luego ejecuta la traducción."
"Verifica cuánto cuesta un SMS al +33612345678, luego envíalo: 'Tu cita está confirmada para mañana a las 3pm.'"
"Genera una imagen de un faro en una tormenta — paga la factura y muéstrame el resultado."
"Envía un agente de voz con IA para llamar al +14155551234 y reprogramar mi cita con el dentista, luego dame la transcripción."
"Convierte este EPUB en un audiolibro — crea el pago, luego consulta check_job_status hasta que termine."
"Elimina el fondo de esta imagen."
"Transcribe este archivo de audio, luego traduce la transcripción al inglés."
"Obtén una cotización para enviar por fax este PDF de 3 páginas al +4930123456, luego envíalo."

Herramientas disponibles

Generación con IA

Herramienta	Descripción	Precio
`image`	Genera imágenes a partir de indicaciones de texto	100-200 sats
`video`	Genera videos a partir de indicaciones de texto	~250-400 sats/seg según resolución (768p 250 / 2K 400)
`video_from_image`	Anima una imagen fija a video	~250-400 sats/seg según resolución (768p 250 / 2K 400)
`text`	Chatea con modelos de lenguaje de IA (Kimi K3, contexto de 1M, visión)	~1 sat/10 caracteres (mejor) · ~1 sat/1000 (estándar)
`translate_text`	Traduce texto en 119 idiomas	desde 1 sat/1000 caracteres
`translate_rare_language`	Traduce a 452 idiomas que los modelos frontera no sirven — Bhojpuri, Maithili, Magahi, Manipuri, Quechua, Shan… cada uno con una puntuación de calidad medida	desde 50 sats
`music`	Genera canciones con voces de IA, o un instrumental (etiquetas de estructura, sin palabras)	5 sats/seg, 15-300s (75-1,500 sats) · letra escrita +25
`3d`	Convierte una foto a un modelo 3D GLB	1,600 sats

El precio de traducción varía según el idioma. El idioma de destino elige el motor, por lo que un idioma servido por un modelo más potente cuesta más que el estándar de 1 sat/1000 caracteres. GET /api/languages devuelve el precio exacto, el modelo y su puntuación chrF medida para cada idioma, y el desafío 402 siempre cotiza el monto real antes de que pagues.

Audio y voz

Herramienta	Descripción	Precio
`tts`	Texto a voz (3 niveles, 602+ idiomas)	por carácter, desde 1 sat
`transcription`	Voz a texto (13 idiomas)	10 sats/min
`voice_clone`	Clona una voz a partir de una muestra de audio	7,500 sats
`epub_to_audiobook`	Convierte libros (EPUB/PDF/TXT) a audiolibros narrados con IA	500+ sats
`translate_epub`	Traduce un EPUB completo a otro idioma — EPUB de entrada, EPUB de salida, marcado intacto (asíncrono; `create_payment` necesita `characterCount` + `targetLanguage`)	por carácter según la tarifa del motor del idioma de destino, mínimo 50 sats

Procesamiento de imágenes

Herramienta	Descripción	Precio
`remove_background`	Elimina el fondo de cualquier imagen (BiRefNet, SOTA)	44 sats
`upscale_image`	Aumenta la resolución de imágenes 2x/4x con Real-ESRGAN	5 sats
`restore_face`	Restaura rostros borrosos/dañados (CodeFormer)	25 sats
`colorize_image`	Colorea fotos en blanco y negro (DDColor, ICCV 2023)	5 sats
`deblur_image`	Elimina el desenfoque por movimiento de cámara (NAFNet, ECCV 2022)	110 sats
`render_card`	Tarjeta de título tipográfica (PNG/JPEG) — diseño determinista, el texto que envías es el texto que aparece	5 sats
`detect_nsfw`	Clasifica la seguridad de la imagen (normal/sugerente/explícita)	2 sats
`detect_objects`	Detecta objetos con cuadros delimitadores (Grounding DINO)	5 sats
`remove_object`	Elimina objetos por descripción — sin necesidad de máscara	130 sats
`image_edit`	Edita imágenes con instrucciones de IA	Dinámico (varía según el modelo) — consulta `get_model_pricing`

Visión y documentos

Herramienta	Descripción	Precio
`vision`	Analiza y describe el contenido de la imagen	21 sats
`ocr`	Extrae texto de PDFs e imágenes	10 sats/página
`extract_receipt`	Recibo a JSON estructurado	25 sats/página
`file_convert`	Convierte entre más de 200 formatos de archivo	100 sats
`pdf_merge`	Fusiona múltiples PDFs en uno	100 sats
`convert_html_to_pdf`	HTML/Markdown a PDF	50 sats
`e_signature`	Firma un PDF con una firma escrita o dibujada	1,000 sats
`boardingpass_wallet`	Pase de abordar de aerolínea (PDF/captura) a un pase de Google Wallet	100 sats/pase

Comunicación

Herramienta	Descripción	Precio
`send_email`	Envía correo electrónico a cualquier dirección	200 sats
`send_sms`	Envía SMS a nivel mundial	Dinámico (varía según el destino) — `create_payment` devuelve la cotización exacta
`place_call`	Realiza llamadas telefónicas automatizadas	Dinámico (varía según el destino) — `create_payment` devuelve la cotización exacta
`ai_call`	Envía un agente de voz con IA para hacer una llamada bidireccional	Varía según el destino y la duración — `create_payment` devuelve la cotización exacta
`send_fax`	Envía un fax a nivel mundial (URL de PDF o texto escrito)	500 sats (≤10 páginas), +50 sats/página después
`receive_fax`	Abre una ventana de 24h para recibir un fax, entregado por correo electrónico	500 sats (+200 complemento OCR)

Herramientas auxiliares

Herramienta	Descripción
`list_models`	Explora los modelos de IA disponibles y precios
`get_model_pricing`	Obtén precios para un modelo específico
`create_payment`	Crea una factura Lightning para un servicio
`check_payment_status`	Verifica si se recibió el pago
`check_job_status`	Consulta trabajos asíncronos (video, 3D, audiolibro, traducción de EPUB)
`get_job_result`	Obtén resultados de trabajos completados
`request_refund`	Solicita un reembolso por un servicio fallido
`vote_on_service`	Vota a favor o en contra de un servicio planificado
`list_planned_services`	Ve los próximos servicios y vota

Cómo funciona

El agente llama a list_models para descubrir los modelos disponibles y precios
El agente llama a create_payment — obtiene una factura Lightning
Se realiza el pago mediante la billetera Lightning del agente (p. ej., lightning-wallet-mcp)
El agente llama a la herramienta (p. ej., image, text) con el paymentId
Se devuelve el resultado — imagen base64, texto, URL, etc.

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

Manejo de errores y reembolsos

Cuando una herramienta pagada 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.

Los errores también llevan un error_code más un suggestion de recuperación, un example, y — cuando el código es reintentable — retry_after_seconds, en error.data. Los mismos campos aparecen en un resultado de herramienta con isError: true y en cada FAILED final de await_result, por lo que un vocabulario cubre cada ruta: ramifica en error_code, nunca en el texto de error. Códigos del ciclo de vida del pago: PAYMENT_NOT_FOUND (paymentId incorrecto), PAYMENT_PENDING (factura aún no pagada), PAYMENT_ALREADY_USED (cada pago cubre una llamada); una falla reembolsada se lee como L402_REFUND_ISSUED con el refund adjunto. Catálogo completo: GET https://sats4ai.com/api/error-codes.

Pago mediante 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 usa lightning-wallet para pagar facturas de sats4ai, lo que permite el uso de herramientas de IA totalmente autónomo.

Block Buzz

¿Ejecutas Block Buzz, el espacio de trabajo de código abierto donde los agentes de IA son compañeros de primera clase? Un agente Buzz es un subproceso de Goose / Codex / Claude Code, y Buzz lo genera heredando su configuración MCP — por lo que este servidor funciona dentro de un espacio de trabajo Buzz sin configuración específica de Buzz.

La ruta de un solo paso es el paquete de persona Sats4AI: agrega un compañero de equipo @sats4ai conectado a este servidor más una billetera Lightning, para que pueda consultar un precio, pagar la factura y devolver el resultado en el canal.

git clone https://github.com/cnghockey/sats4ai-buzz-pack
buzz pack validate ./sats4ai-buzz-pack

¿Prefieres conectarlo manualmente? Agrega sats4ai (y un MCP de billetera) al agente que Buzz ejecute — su configuración se transfiere directamente. Ten en cuenta que el .mcp.json de Buzz es solo stdio, así que usa la forma de proxy npx sats4ai-mcp (mostrada arriba), no la forma remota url.

API L402

Para integración HTTP directa sin MCP, usa 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"}}'

O evita los pasos manuales por completo: nuestros endpoints L402 hablan el protocolo L402 estándar, por lo que lnget — el propio cliente L402 de Lightning Labs — los paga automáticamente. Apúntalo a tu nodo Lightning y llama al endpoint:

lnget -X POST -d '{"text": "Hello", "targetLanguage": "Spanish"}' \
  --content-type application/json --max-cost 50 \
  https://sats4ai.com/api/l402/translate-text
# Fetches the 402, pays the invoice, retries, prints the result.

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 pagada incluye metadatos de rendimiento (latencia p50/p95, calificación de confiabilidad, modos de falla 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

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

Enlaces

Sitio web: sats4ai.com
Documentación MCP: sats4ai.com/mcp
Documentación de la 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