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.
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 linguagemPagamento 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 TempoInstalaçã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.
- Clique em Adicionar ao Cursor acima ou salve isto em
~/.cursor/mcp.json. - Aprove a tela de consentimento OAuth do SingleFax.
- Peça ao agente para enviar fax. Para um documento comum, ele chama
create_upload, fornece um link de envio e depois usacreate_fax_draftcomuploadToken. Envie o original sem converter antes em PDF.
{
"mcpServers": {
"singlefax": {
"url": "https://singlefax.com/mcp"
}
}
}Cursor não gera Stripe Shared Payment Tokens. Prefira o link de Checkout de create_fax_draft. Para pagar MPP pelo terminal, veja MPP abaixo. documentação MCP do Cursor.
Claude Code
- Execute o comando e complete OAuth com
/mcpna sessão.
claude mcp add --transport http singlefax https://singlefax.com/mcpClaude.ai ou Desktop
- Abra Personalizar → Conectores.
- Adicione um conector personalizado chamado
singlefaxcom o URL https://singlefax.com/mcp. - Conecte e ative o conector no chat.
Contas grátis do Claude.ai permitem um conector personalizado. Claude não tem link direto de instalação: o botão copia o comando e abre Conectores. documentação MCP do Claude Code.
- Cole os comandos no terminal. CLI, extensão IDE e ChatGPT desktop compartilham
~/.codex/config.toml. codex mcp login singlefaxinicia OAuth se a etapa de adicionar não iniciou.- Em uma sessão Codex, execute
/mcppara verificar as ferramentas.
codex mcp add singlefax --url https://singlefax.com/mcp
codex mcp login singlefax[mcp_servers.singlefax]
url = "https://singlefax.com/mcp"- Ative Modo de desenvolvedor em Configurações → Segurança e login.
- Abra Conectores ou Plugins e crie um conector personalizado.
- Nome:
SingleFax. URL MCP: https://singlefax.com/mcp. Autenticação: OAuth. - No chat, ative o modo de desenvolvedor e SingleFax antes de pedir um fax.
https://singlefax.com/mcpO MCP personalizado do ChatGPT usa modo de desenvolvedor, não Instant Checkout. O agente ainda retorna uma URL do SingleFax para você pagar. documentação de conectores ChatGPT.
- Clique em Adicionar ao VS Code ou abra Paleta de comandos →
MCP: Add Server. - Ou salve em
.vscode/mcp.jsondo projeto ou na configuração MCP do usuário.
{
"servers": {
"singlefax": {
"type": "http",
"url": "https://singlefax.com/mcp"
}
}
}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.
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 URLsquote_fax, Preço de envio avulso. Passe to e, opcionalmente, pages ou base64 para calcular páginas reaiscreate_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 contacreate_checkout, Créditos ou outros SKUs do catálogo; para número, prefira create_inbound_numbercreate_upload, Arquivos grandes: retorna uploadPageUrl para envio humano sem login e uploadUrl para PUT de bytes sem Authorization. Passe uploadToken para consultar o status storedget_fax_status, Consulte o status de entrega de um pedido seuget_credits, Consulte o saldo de créditos pré-pagoscreate_machine_fax, JSON de desafio MPP. Link CLI, SPT, ou carteiras Tempo. REST 402 é a via real de pagamentoMPP: 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.
- Instale a skill com
npx skills add stripe/link-cliou adicione MCPnpx @stripe/link-cli --mcp. - Entre e pague o endpoint automatizado: E.164 válido e base64 real do arquivo original, não
+1555de exemplo nem PDF pré-convertido, salvo se a origem já for PDF. - Não direcione
mpp paypara/mcp. Link CLI exige uma URL que retorne HTTP 402 eWWW-Authenticate.
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.