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_statusaté 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
| Ferramenta | Descrição | Preço |
|---|---|---|
image | Gera imagens a partir de prompts de texto | 100-200 sats |
video | Gera vídeos a partir de prompts de texto | ~250-400 sats/seg por resolução (768p 250 / 2K 400) |
video_from_image | Anima uma imagem estática em vídeo | ~250-400 sats/seg por resolução (768p 250 / 2K 400) |
text | Converse com modelos de linguagem de IA (Kimi K3, contexto de 1M, visão) | ~1 sat/10 caracteres (melhor) · ~1 sat/1000 (padrão) |
translate_text | Traduz texto em 119 idiomas | a partir de 1 sat/1000 caracteres |
translate_rare_language | Traduz 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 medida | a partir de 50 sats |
music | Gera 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 |
3d | Converte uma foto em um modelo 3D GLB | 1.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/languagesretorna 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
| Ferramenta | Descrição | Preço |
|---|---|---|
tts | Texto para fala (3 níveis, 602+ idiomas) | por caractere, a partir de 1 sat |
transcription | Fala para texto (13 idiomas) | 10 sats/min |
voice_clone | Clona uma voz a partir de uma amostra de áudio | 7.500 sats |
epub_to_audiobook | Converte livros (EPUB/PDF/TXT) em audiolivros narrados por IA | 500+ sats |
translate_epub | Traduz 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
| Ferramenta | Descrição | Preço |
|---|---|---|
remove_background | Remove o fundo de qualquer imagem (BiRefNet, SOTA) | 44 sats |
upscale_image | Aumenta a resolução de imagens 2x/4x com Real-ESRGAN | 5 sats |
restore_face | Restaura rostos desfocados/danificados (CodeFormer) | 25 sats |
colorize_image | Coloriza fotos em P&B (DDColor, ICCV 2023) | 5 sats |
deblur_image | Remove desfoque por tremor de câmera (NAFNet, ECCV 2022) | 110 sats |
render_card | Cartão de título tipográfico (PNG/JPEG) — layout determinístico, o texto que você envia é o texto que aparece | 5 sats |
detect_nsfw | Classifica a segurança da imagem (normal/sugestivo/explícito) | 2 sats |
detect_objects | Detecta objetos com caixas delimitadoras (Grounding DINO) | 5 sats |
remove_object | Remove objetos por descrição — sem necessidade de máscara | 130 sats |
image_edit | Edita imagens com instruções de IA | Dinâmico (varia por modelo) — verifique get_model_pricing |
Visão e Documentos
| Ferramenta | Descrição | Preço |
|---|---|---|
vision | Analisa e descreve o conteúdo da imagem | 21 sats |
ocr | Extrai texto de PDFs e imagens | 10 sats/página |
extract_receipt | Recibo para JSON estruturado | 25 sats/página |
file_convert | Converte entre mais de 200 formatos de arquivo | 100 sats |
pdf_merge | Mescla vários PDFs em um só | 100 sats |
convert_html_to_pdf | HTML/Markdown para PDF | 50 sats |
e_signature | Assina um PDF com assinatura digitada ou desenhada | 1.000 sats |
boardingpass_wallet | Cartão de embarque de companhia aérea (PDF/captura de tela) para um passe do Google Wallet | 100 sats/passe |
Comunicação
| Ferramenta | Descrição | Preço |
|---|---|---|
send_email | Envia e-mail para qualquer endereço | 200 sats |
send_sms | Envia SMS mundialmente | Dinâmico (varia por destino) — create_payment retorna a cotação exata |
place_call | Faz chamadas telefônicas automatizadas | Dinâmico (varia por destino) — create_payment retorna a cotação exata |
ai_call | Envia um agente de voz com IA para fazer uma chamada bidirecional | Varia por destino e duração — create_payment retorna a cotação exata |
send_fax | Envia fax mundialmente (URL de PDF ou texto digitado) | 500 sats (≤10 páginas), +50 sats/página depois |
receive_fax | Abre uma janela de 24h para receber fax, entregue por e-mail | 500 sats (+200 complemento OCR) |
Ferramentas Auxiliares
| Ferramenta | Descrição |
|---|---|
list_models | Navega pelos modelos de IA disponíveis e preços |
get_model_pricing | Obtém preços para um modelo específico |
create_payment | Cria uma fatura Lightning para um serviço |
check_payment_status | Verifica se o pagamento foi recebido |
check_job_status | Consulta trabalhos assíncronos (vídeo, 3D, audiolivro, tradução de EPUB) |
get_job_result | Obtém resultados de trabalhos concluídos |
request_refund | Solicita reembolso para um serviço com falha |
vote_on_service | Vota a favor ou contra um serviço planejado |
list_planned_services | Vê serviços futuros e vota |
Como Funciona
- O agente chama
list_modelspara descobrir modelos disponíveis e preços - O agente chama
create_payment— obtém uma fatura Lightning - O pagamento é feito via carteira Lightning do agente (ex.: lightning-wallet-mcp)
- O agente chama a ferramenta (ex.:
image,text) com opaymentId - 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
- Site: sats4ai.com
- Docs MCP: sats4ai.com/mcp
- Docs da API L402: sats4ai.com/l402
- Exemplos de Código L402: github.com/cnghockey/sats4ai-l402-examples
- Descoberta de Serviços: sats4ai.com/.well-known/l402-services
- Busca Semântica: sats4ai.com/api/discover
- Política de Segurança: SECURITY.md
Licença
MIT