sats4ai

Mercado de ferramentas com tecnologia Bitcoin. Imagem, texto, vídeo, música, fala, 3D, conversão de arquivos, SMS — tudo via micropagamentos Lightning. Sem necessidade de cadastro.

Documentação

sats4ai-mcp

O supercarregador de comunicação sem permissão para agentes de IA. Mais de 40 ferramentas pagas com Bitcoin Lightning. Sem cadastro, sem chaves de API, sem KYC.

Um servidor remoto MCP (Model Context Protocol) que dá aos agentes de IA acesso a chamadas telefônicas com IA em qualquer idioma, voz em 602 idiomas, tradução em 119, fax, SMS, transcrição, audiolivros, geração de imagens, música, extração de documentos e muito mais — tudo pago por uso com micropagamentos via Lightning Network.

Configuração Rápida

Claude Desktop

Adicione ao seu claude_desktop_config.json (~/Library/Application Support/Claude/claude_desktop_config.json no macOS, %APPDATA%\Claude\claude_desktop_config.json no Windows):

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

Claude Code

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

Verifique a conexão: pergunte ao agente "liste os primeiros 3 modelos Sats4AI" — ele deve chamar list_models e retornar resultados. Para agentes que pagam faturas de forma autônoma, adicione também um MCP de carteira Lightning (veja Pagamento via Carteiras de Agente).

Cursor

Configurações → MCP → Editar Config, e então adicione:

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

Reinicie o Cursor. Em um novo chat, pergunte "quais ferramentas Sats4AI estão disponíveis?" para confirmar a descoberta de ferramentas. Para pagamentos autônomos, combine com um MCP de carteira Lightning (veja Pagamento via Carteiras de Agente).

Windsurf

Edite ~/.codeium/windsurf/mcp_config.json (crie se não existir). Importante: o Windsurf usa serverUrl (não url) para servidores MCP HTTP remotos:

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

Reinicie o Windsurf. As ferramentas Sats4AI aparecem na lista de ferramentas do Cascade. O Cascade tem um limite de 100 ferramentas em todos os MCPs, então mantenha o conjunto ativo enxuto. Para pagamentos autônomos, combine com um MCP de carteira Lightning (veja Pagamento via Carteiras de Agente).

Proxy stdio (clientes MCP legados)

Para clientes que não suportam servidores HTTP remotos, use o proxy stdio incluído:

npx sats4ai-mcp

Ou na sua configuração:

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

Qualquer Cliente MCP

A URL do servidor é:

https://sats4ai.com/api/mcp

Este é um servidor HTTP remoto — sem processo local, sem dependências, sem necessidade de instalação.

O Que Ele Pode Fazer?

Uma vez conectado, basta pedir ao seu agente. Estes prompts exercitam o fluxo completo — descobrir, pagar a fatura Lightning, obter o resultado:

  • "Traduza este parágrafo para espanhol com Sats4AI — crie o pagamento, pague a fatura com minha carteira lightning e então execute a tradução."
  • "Verifique quanto custa um SMS para +33612345678 e então envie: 'Sua consulta está confirmada para amanhã às 15h.'"
  • "Gere uma imagem de um farol em uma tempestade — pague a fatura e me mostre o resultado."
  • "Envie um agente de voz com IA para ligar para +14155551234 e remarcar minha consulta no dentista, e então me dê a transcrição."
  • "Transforme este EPUB em um audiolivro — crie o pagamento e então consulte check_job_status até que esteja pronto."
  • "Remova o fundo desta imagem."
  • "Transcreva este arquivo de áudio e então traduza a transcrição para inglês."
  • "Obtenha um orçamento para enviar por fax este PDF de 3 páginas para +4930123456 e então envie."

Ferramentas Disponíveis

Geração com IA

FerramentaDescriçãoPreço
imageGera imagens a partir de prompts de texto100-200 sats
videoGera vídeos a partir de prompts de texto~250-400 sats/seg por resolução (768p 250 / 2K 400)
video_from_imageAnima uma imagem estática em vídeo~250-400 sats/seg por resolução (768p 250 / 2K 400)
textConverse com modelos de linguagem de IA (Kimi K3, contexto de 1M, visão)~1 sat/10 caracteres (melhor) · ~1 sat/1000 (padrão)
translate_textTraduz texto em 119 idiomasa partir de 1 sat/1000 caracteres
translate_rare_languageTraduz para 452 idiomas que os modelos de fronteira não atendem — Bhojpuri, Maithili, Magahi, Manipuri, Quechua, Shan… cada um com uma pontuação de qualidade medidaa partir de 50 sats
musicGera músicas com vocais de IA, ou instrumental (tags de estrutura, sem palavras)5 sats/seg, 15-300s (75-1.500 sats) · letras escritas +25
3dConverte uma foto em um modelo 3D GLB1.600 sats

O preço da tradução varia por idioma. O idioma de destino escolhe o mecanismo, então um idioma atendido por um modelo mais forte custa mais do que o padrão de 1 sat/1000 caracteres. GET /api/languages retorna o preço exato, o modelo e sua pontuação chrF medida para cada idioma, e o desafio 402 sempre cotiza o valor real antes de você pagar.

Áudio e Fala

FerramentaDescriçãoPreço
ttsTexto para fala (3 níveis, 602+ idiomas)por caractere, a partir de 1 sat
transcriptionFala para texto (13 idiomas)10 sats/min
voice_cloneClona uma voz a partir de uma amostra de áudio7.500 sats
epub_to_audiobookConverte livros (EPUB/PDF/TXT) em audiolivros narrados por IA500+ sats
translate_epubTraduz um EPUB inteiro para outro idioma — EPUB entra, EPUB sai, marcação intacta (assíncrono; create_payment precisa de characterCount + targetLanguage)por caractere na taxa do mecanismo do idioma de destino, mínimo 50 sats

Processamento de Imagem

FerramentaDescriçãoPreço
remove_backgroundRemove o fundo de qualquer imagem (BiRefNet, SOTA)44 sats
upscale_imageAumenta a resolução de imagens 2x/4x com Real-ESRGAN5 sats
restore_faceRestaura rostos desfocados/danificados (CodeFormer)25 sats
colorize_imageColoriza fotos em P&B (DDColor, ICCV 2023)5 sats
deblur_imageRemove desfoque por tremor de câmera (NAFNet, ECCV 2022)110 sats
render_cardCartão de título tipográfico (PNG/JPEG) — layout determinístico, o texto que você envia é o texto que aparece5 sats
detect_nsfwClassifica a segurança da imagem (normal/sugestivo/explícito)2 sats
detect_objectsDetecta objetos com caixas delimitadoras (Grounding DINO)5 sats
remove_objectRemove objetos por descrição — sem necessidade de máscara130 sats
image_editEdita imagens com instruções de IADinâmico (varia por modelo) — verifique get_model_pricing

Visão e Documentos

FerramentaDescriçãoPreço
visionAnalisa e descreve o conteúdo da imagem21 sats
ocrExtrai texto de PDFs e imagens10 sats/página
extract_receiptRecibo para JSON estruturado25 sats/página
file_convertConverte entre mais de 200 formatos de arquivo100 sats
pdf_mergeMescla vários PDFs em um só100 sats
convert_html_to_pdfHTML/Markdown para PDF50 sats
e_signatureAssina um PDF com assinatura digitada ou desenhada1.000 sats
boardingpass_walletCartão de embarque de companhia aérea (PDF/captura de tela) para um passe do Google Wallet100 sats/passe

Comunicação

FerramentaDescriçãoPreço
send_emailEnvia e-mail para qualquer endereço200 sats
send_smsEnvia SMS mundialmenteDinâmico (varia por destino) — create_payment retorna a cotação exata
place_callFaz chamadas telefônicas automatizadasDinâmico (varia por destino) — create_payment retorna a cotação exata
ai_callEnvia um agente de voz com IA para fazer uma chamada bidirecionalVaria por destino e duração — create_payment retorna a cotação exata
send_faxEnvia fax mundialmente (URL de PDF ou texto digitado)500 sats (≤10 páginas), +50 sats/página depois
receive_faxAbre uma janela de 24h para receber fax, entregue por e-mail500 sats (+200 complemento OCR)

Ferramentas Auxiliares

FerramentaDescrição
list_modelsNavega pelos modelos de IA disponíveis e preços
get_model_pricingObtém preços para um modelo específico
create_paymentCria uma fatura Lightning para um serviço
check_payment_statusVerifica se o pagamento foi recebido
check_job_statusConsulta trabalhos assíncronos (vídeo, 3D, audiolivro, tradução de EPUB)
get_job_resultObtém resultados de trabalhos concluídos
request_refundSolicita reembolso para um serviço com falha
vote_on_serviceVota a favor ou contra um serviço planejado
list_planned_servicesVê serviços futuros e vota

Como Funciona

  1. O agente chama list_models para descobrir modelos disponíveis e preços
  2. O agente chama create_payment — obtém uma fatura Lightning
  3. O pagamento é feito via carteira Lightning do agente (ex.: lightning-wallet-mcp)
  4. O agente chama a ferramenta (ex.: image, text) com o paymentId
  5. O resultado é retornado — imagem base64, texto, URL, etc.

Sem chaves de API. Sem contas. Sem limites de taxa vinculados à identidade. Apenas Bitcoin e IA.

Tratamento de Erros e Reembolsos

Quando uma ferramenta paga falha após o pagamento, a resposta de erro JSON-RPC inclui informações 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..."
      }
    }
  }
}

Solicite o reembolso usando qualquer carteira compatível com LNURL ou a ferramenta claim_lnurl_withdraw de lightning-wallet.

Erros também carregam um error_code além de um suggestion de recuperação, um example e — quando o código é repetível — retry_after_seconds, em error.data. Os mesmos campos aparecem em um resultado de ferramenta com isError: true e em cada FAILED final de await_result, então um vocabulário cobre todos os caminhos: ramifique em error_code, nunca no texto error. Códigos do ciclo de vida de pagamento: PAYMENT_NOT_FOUND (paymentId errado), PAYMENT_PENDING (fatura ainda não paga), PAYMENT_ALREADY_USED (cada pagamento cobre uma chamada); uma falha reembolsada lê L402_REFUND_ISSUED com o refund anexado. Catálogo completo: GET https://sats4ai.com/api/error-codes.

Pagamento via Carteiras de Agente

Combine com um servidor MCP de carteira Lightning para que seu agente possa pagar de forma autônoma:

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

O agente usa lightning-wallet para pagar faturas de sats4ai, permitindo uso totalmente autônomo de ferramentas de IA.

Block Buzz

Usando Block Buzz, o espaço de trabalho de código aberto onde agentes de IA são colegas de primeira classe? Um agente Buzz é um subprocesso Goose / Codex / Claude Code, e o Buzz o inicia herdando sua configuração MCP — então este servidor funciona dentro de um espaço de trabalho Buzz sem configuração específica do Buzz.

O caminho de uma etapa é o pacote de persona Sats4AI: ele adiciona um colega @sats4ai conectado a este servidor além de uma carteira Lightning, para que possa consultar um preço, pagar a fatura e retornar o resultado no canal.

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

Prefere configurar manualmente? Adicione sats4ai (e um MCP de carteira) ao agente que o Buzz executa — a configuração dele é transferida diretamente. Observe que o .mcp.json do Buzz é somente stdio, então use a forma de proxy npx sats4ai-mcp (mostrada acima), não a forma remota url.

API L402

Para integração HTTP direta sem MCP, use a 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"}}'

Ou pule as etapas manuais completamente: nossos endpoints L402 falam o protocolo L402 padrão, então lnget — o próprio cliente L402 da Lightning Labs — paga por eles automaticamente. Aponte-o para seu nó Lightning e chame o 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.

Documentação completa do L402: sats4ai.com/l402 | Exemplos de código: sats4ai-l402-examples

Descoberta de Serviços

Endpoints legíveis por máquina para descoberta 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 ferramenta paga inclui metadados de desempenho (latência p50/p95, classificação de confiabilidade, modos de falha conhecidos) para que os agentes possam tomar decisões informadas sobre quais ferramentas chamar e quanto tempo 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: "..." } } }

Segurança

Encontrou uma vulnerabilidade? Não abra uma issue pública. Envie um e-mail para sats4ai@gmail.com. Veja SECURITY.md para a política completa de divulgação e escopo.

Links

Licença

MIT