Servidor MCP

Seu agente de IA,
conectado aos pagamentos

O servidor MCP da SatsRail é hospedado e remoto — 53 ferramentas para pedidos, faturas, links de pagamento, produtos e webhooks em um único endpoint ao qual qualquer cliente MCP pode se conectar. Nada para instalar. Conecte com uma URL e uma chave de API. Ele vem com o plano Pro.

Leia a documentação Obtenha uma chave de API

Uma API de pagamentos para Bitcoin, pela Lightning ou on-chain (acesso antecipado) — pense no Stripe, mas sem custódia e feita para agentes.

Um endpoint. A API inteira.

O Model Context Protocol é o padrão aberto para dar ferramentas a agentes. Este é o nosso.

Hospedado, não instalado

Sem pacote npm, sem processo local para rodar ou manter atualizado. O servidor vive dentro da API. Você se conecta a uma URL.

53 ferramentas

Todo o ciclo de vida do pagamento — a mesma API de estabelecimento que o seu painel usa, exposta como ferramentas que um agente pode chamar diretamente.

Qualquer cliente MCP

Claude Code, Claude Desktop, Cursor, Windsurf e qualquer cliente que fale Streamable HTTP. Clientes stdio se conectam com uma ponte de uma linha.

Três passos

Do zero a um agente que consegue receber um pagamento.

1

Crie uma chave de API

Gere uma chave no seu painel. Use uma chave de teste enquanto desenvolve e uma chave de produção quando entrar no ar. Ative a verificação em duas etapas nas configurações da sua conta: seu agente precisa dela para criar pedidos e fazer outras alterações.

2

Cole um bloco de configuração

Aponte seu cliente MCP para o endpoint, com a sua chave como cabeçalho. Essa é toda a configuração.

3

Seu agente cobra

Ele cria pedidos, gera faturas Lightning ou endereços on-chain (acesso antecipado) e consulta o status dos pagamentos. A Lightning liquida em segundos; o on-chain é definitivo depois de confirmado. Os fundos vão para a carteira do próprio estabelecimento.

Conecte em segundos

A configuração completa para um cliente HTTP nativo.

{
  "mcpServers": {
    "satsrail": {
      "type": "http",
      "url": "https://app.satsrail.com/api/v1/mcp",
      "headers": { "Authorization": "Bearer sk_live_your_key" }
    }
  }
}

Funciona no Claude Code, no Claude Desktop, no Cursor, no Windsurf e em qualquer cliente MCP com Streamable HTTP. Clientes que só falam stdio se conectam pelo mcp-remote.

Sem chave para colar? Um cliente compatível com OAuth se conecta só com a URL: você entra, escolhe o estabelecimento e aprova. Essas conexões só gerenciam o seu catálogo, e você pode revogá-las quando quiser em Configurações → Assistentes de IA.

O que os agentes podem fazer

Todas as funções do estabelecimento, agrupadas.

Pedidos e faturas

Monte pedidos item por item, com impostos, e envie um único link de pagamento ou um e-mail com a sua marca, gere faturas Lightning ou endereços on-chain, consulte o status do pagamento em tempo real e acompanhe a entrega. Veja o ciclo de um pedido.

Checkout e solicitações de pagamento

Crie sessões de checkout hospedadas e solicitações de pagamento em uma só chamada, e depois acompanhe os pagamentos confirmados.

Produtos e catálogo

Gerencie produtos, tipos de produto e o catálogo inteiro, e crie links de pagamento para enviar aos clientes.

Webhooks

Crie, atualize e exclua endpoints de webhook para que os agentes reajam a eventos em tempo real.

Conta e uso

Consulte o perfil do estabelecimento, as carteiras conectadas, os documentos e o uso das chaves de API, para acompanhar tudo por conta própria.

Acesso e planos

Verifique tokens de acesso a conteúdo restrito e consulte os planos de assinatura públicos sem autenticação.

Veja o catálogo completo das 53 ferramentas
Agentes que compram

Envie o link, não o dinheiro

Um agente que compra algo para você não precisa de uma carteira nem do seu cartão. Ele envia para você o link de pagamento do estabelecimento, e você paga com a sua própria carteira.

1. O agente recebe o link

Do estabelecimento, do site dele ou do próprio agente do estabelecimento. Acrescentar .json a um link da SatsRail diz ao agente para que ele serve, o preço e quem recebe, sem abrir um checkout.

2. Ele envia o link para você

No chat, no e-mail ou no app em que você já conversa com ele. A prévia do link mostra o item, o preço e o nome do estabelecimento.

3. Você paga com a sua carteira

Você vê o checkout, confere o preço e paga. O dinheiro vai direto para a carteira do estabelecimento. O agente nunca guarda fundos nem dados de cartão.

Está vendendo? Seu próprio agente cria o link com create_payment_link e o devolve para você enviar.

Pedidos, do início ao fim

De uma conversa a um pedido entregue

Seu agente monta o pedido, envia, vê que foi pago e faz a entrega acontecer, com ferramentas que ele já tem.

  1. 1

    Monte o pedido

    Diga ao seu agente o que o cliente quer. Ele começa um rascunho com create_order e adiciona cada item com add_order_item: produtos do catálogo ou itens avulsos, cada um com a sua quantidade e o seu preço. Os impostos são calculados item por item, pelas regras do seu catálogo.

  2. 2

    Envie um único link

    create_order_payment_link devolve um link para o pedido inteiro, com impostos, para colar num chat ou numa mensagem. Ou send_order_payment_email envia o link por e-mail por você, com o seu logo, o resumo do pedido e um botão Pagar. As respostas chegam para você.

  3. 3

    O cliente vê os seus preços e paga em bitcoin

    O link abre o pedido inteiro com preços na sua moeda. O valor em bitcoin é definido quando o cliente clica em Pagar, pela cotação daquele momento, e o pagamento vai direto para a sua carteira. Um pedido é pago uma única vez.

  4. 4

    Seu agente confirma

    get_order mostra o pedido como pago assim que o pagamento chega, para o agente avisar você, ou o cliente, na hora.

  5. 5

    E faz o pedido chegar

    list_unfulfilled_orders responde “o que ainda falta enviar?”, e mark_order_fulfilled registra cada pedido como enviado, com o código de rastreio, e depois como entregue.

Exemplo de conversa

Você: A Ada quer dois pacotes do café da casa e um moedor. Manda a conta para ela.

Agente: Pedido ORD-7F2A: 2 × Café da casa US$36,00, Moedor US$60,00, imposto US$1,80, total US$97,80. Enviei o link de pagamento para a Ada por e-mail. Ele vale por 24 horas.

Agente, mais tarde: A Ada pagou US$97,80. O pedido está esperando nos seus pedidos não entregues.

Você: Enviado, UPS 1Z999. → marcado como enviado, com o código de rastreio.

Você define as regras

Validade do pedido

Escolha por quanto tempo um link pode ser pago, de 1 hora a 7 dias. Depois disso, ele mostra que o pedido expirou. Os preços ficam na sua moeda até o clique em Pagar, então uma validade longa nunca trava uma cotação antiga.

Lembretes automáticos

Nenhum, um ou dois e-mails de lembrete para o cliente que ainda não pagou: na metade do prazo e pouco antes de ele vencer. Nunca depois que o pedido é pago, cancelado ou expira. Seu agente também pode enviar um quando você pedir.

Acompanhamento de entregas

Peça um endereço de entrega e um telefone antes do pagamento, e mantenha os pedidos pagos numa lista de Pedidos não entregues até marcá-los como enviados e entregues. Seu agente vê a mesma lista.

Referência do MCP

Endpoint, autenticação, protocolo e todas as ferramentas.

Abrir a referência →

API REST

As mesmas funções sobre HTTP simples.

Abrir a documentação da API →

Pagamentos para agentes de IA

Por que a Lightning combina com software autônomo.

Ler o guia de início rápido →

Conecte seu agente

Obtenha uma chave de API, cole um bloco de configuração e seu agente poderá aceitar Bitcoin pela Lightning ou on-chain (acesso antecipado).

Obtenha sua chave de API → Leia a documentação
Comece grátis — sem cartão de crédito