MCP · Stripe MPP

Servidor MCP do SingleFax

Conecte Cursor, Claude, Codex, ChatGPT ou VS Code ao SingleFax por MCP. O assistente envia Word, Excel, PDF ou imagem original, sem conversão prévia, calcula o preço e abre Checkout ou usa sua franquia.

Adicionar ao CursorAdicionar ao VS Code

Cursor e VS Code instalam em um clique. Claude, Codex e ChatGPT copiam o código e abrem as configurações certas. Link direto do Cursor se a instalação web não abrir o aplicativo.

https://singlefax.com/mcp

Aplicativos de chat

Cursor, Claude, Codex e ChatGPT: MCP com OAuth. Uma pessoa confirma o pagamento, salvo se houver páginas da assinatura.

Scripts e backends

Chave de API e créditos pré-pagos, sem redirecionamento de pagamento. Ideal para seus processos de backend.

API, CLI e exemplos por linguagem

Pagamento autônomo

Stripe MPP, HTTP 402. Link CLI para cartões ou Tempo USDC para Tempo Wallet, Privy, AgentCash e Kite.

URL automatizada, Link CLI e Tempo

Instalação por cliente

Streamable HTTP em https://singlefax.com/mcp. Após instalar, o cliente inicia OAuth: entre com sua conta SingleFax. Também está no catálogo Smithery como @singlefax/fax.

O que pedir

Com o servidor conectado, basta uma instrução como esta. Para um documento comum, o agente deve chamar create_upload, fornecer uploadPageUrl para você enviar o arquivo original e, depois, chamar create_fax_draft com uploadToken. Aplicativos de chat não conseguem incluir um arquivo comum em base64 em uma chamada de ferramenta. Não converta Word, Excel ou imagens em PDF antes: fazemos a conversão antes do envio. O agente calcula o preço e abre Checkout ou envia usando sua franquia de páginas.

example prompt
Send this document as a fax to +1-415-555-2671 using SingleFax.
list_skus, Catálogo com preços. HIPAA, EIN e IRS são só pelo site; inclui URLs
quote_fax, Preço de envio avulso. Passe to e, opcionalmente, pages ou base64 para calcular páginas reais
create_fax_draft, Envie com to e uploadToken após create_upload: usa créditos ou franquia, ou retorna URL de Checkout. base64 só para arquivos minúsculos. Mande Word, Excel, PDF ou imagens originais; não converta antes.
create_inbound_number, Obtenha número exclusivo, padrão de 30 dias, $4.99. Retorna URL de Checkout e número reservado. Após pagar, use list_numbers.
list_numbers, Lista os números ativos desta conta
create_checkout, Créditos ou outros SKUs do catálogo; para número, prefira create_inbound_number
create_upload, Arquivos grandes: retorna uploadPageUrl para envio humano sem login e uploadUrl para PUT de bytes sem Authorization. Passe uploadToken para consultar o status stored
get_fax_status, Consulte o status de entrega de um pedido seu
get_credits, Consulte o saldo de créditos pré-pagos
create_machine_fax, JSON de desafio MPP. Link CLI, SPT, ou carteiras Tempo. REST 402 é a via real de pagamento

MPP: pagamento autônomo

Machine Payment Protocol é um protocolo do comprador: o servidor retorna HTTP 402, o agente anexa Stripe Shared Payment Token ou pagamento Tempo USDC e tenta novamente. Esse caminho é POST https://singlefax.com/api/v1/machine/faxes, não as ferramentas MCP de chat.

Cursor, Claude Code e Codex podem call essa URL no terminal, mas não geram SPT sem carteira. A via de cartão Stripe é Link CLI, para contas Link dos EUA. Aprove cada gasto no Link. Tempo Wallet, Privy, AgentCash e Kite Passport pagam o desafio Tempo na mesma URL.

  1. Instale a skill com npx skills add stripe/link-cli ou adicione MCP npx @stripe/link-cli --mcp.
  2. Entre e pague o endpoint automatizado: E.164 válido e base64 real do arquivo original, não +1555 de exemplo nem PDF pré-convertido, salvo se a origem já for PDF.
  3. Não direcione mpp pay para /mcp. Link CLI exige uma URL que retorne HTTP 402 e WWW-Authenticate.
link-cli mpp pay
npx @stripe/link-cli auth login

npx @stripe/link-cli mpp pay https://singlefax.com/api/v1/machine/faxes \
  -X POST \
  -d '{"to":"+14155552671","base64":"<document-bytes>","request_id":"mpp-1"}' \
  --context "Send a fax via SingleFax after the user asked this agent to pay for the send."

Formato dos desafios, validação, status e reembolsos: mpp.md. Mínimo SPT $0.50, Tempo USDC $0.01 e preço mínimo SingleFax $0.99.

API REST e CLI

No seu backend, crie chave limitada e compre créditos, sem redirecionamento de pagamento. Exemplos curl, Node, Python, Go e PHP estão na página de desenvolvedores.

Perguntas frequentes

Documentos legíveis para agentes

Markdown simples para rastreadores e agentes de programação. Os mesmos dados desta página.