¿Debo convertir antes el archivo a PDF?

No. Envía Word, Excel, PowerPoint, RTF, texto, imagen o PDF original. Lo convertimos antes de enviar; no lo conviertas por tu cuenta.

¿Puedo enviar un archivo grande desde Grok o ChatGPT?

El MCP de chat no puede llevar documentos normales en base64; los clientes se atascan con decenas de KB. El asistente llama a create_upload y te da un enlace sin acceso. Tras subir el original, envía con uploadToken. Los scripts pueden hacer HTTP PUT de datos a uploadUrl sin Authorization.

¿Qué vía debe usar mi agente?

Los chats Cursor, Claude, Codex y ChatGPT usan MCP: devuelve Checkout o envía con páginas de suscripción. Los scripts autónomos que puedan generar Stripe Shared Payment Token o pagar Tempo USDC usan el endpoint REST con MPP. Los trabajos del servidor usan clave API y crédito prepago; consulta /developers.

¿Puede Cursor pagar solo con Stripe MPP?

No. Cursor no tiene cartera Stripe. Usa MCP con Checkout, instala Stripe Link CLI con npx skills add stripe/link-cli y ejecuta link-cli mpp pay contra la URL REST, o paga el desafío Tempo USDC.e desde Tempo Wallet, Privy, AgentCash o Kite Passport.

¿Puedo pagar con criptomonedas o Tempo?

Sí, en la vía automatizada. POST /api/v1/machine/faxes devuelve HTTP 402 con Tempo USDC.e y Stripe SPT. Pagan Tempo Wallet, Privy, AgentCash y Kite Passport. Checkout web sigue usando tarjeta, Apple Pay, Google Pay o Link, no Bitcoin.

¿Necesito una cuenta?

MCP usa OAuth: inicia sesión o crea cuenta al abrirse el consentimiento. Los envíos MPP no necesitan clave API. REST y CLI con crédito sí necesitan clave del panel; consulta /developers.

¿Es compatible con HIPAA?

No. No envíes PHI por MCP, MPP ni API pública. Las entidades sujetas a HIPAA deben usar HIPAA Secure en la web con BAA electrónico.

MCP · Stripe MPP

Servidor MCP de SingleFax

Conecta Cursor, Claude, Codex, ChatGPT o VS Code a SingleFax mediante MCP. El asistente sube el Word, Excel, PDF o imagen original, sin conversión previa, calcula el precio y abre Checkout o usa tu cupo de páginas.

Añadir a Cursor Añadir a VS Code

Cursor y VS Code se instalan con un clic. Claude, Codex y ChatGPT copian el código y abren los ajustes adecuados. Enlace directo de Cursor si la instalación web no abre la aplicación.

https://singlefax.com/mcp

Aplicaciones de chat

Cursor, Claude, Codex y ChatGPT: MCP con OAuth. Una persona confirma el pago salvo que queden páginas de suscripción.

Scripts y servidores

Clave API y crédito prepago, sin redirección de pago. Ideal para tus procesos del servidor.

API, CLI y ejemplos por lenguaje

Pago autónomo

Stripe MPP, HTTP 402. Link CLI para tarjetas o Tempo USDC para Tempo Wallet, Privy, AgentCash y Kite.

URL automatizada, Link CLI y Tempo

Instalación por cliente

Streamable HTTP en https://singlefax.com/mcp. Tras instalar, el cliente inicia OAuth: accede con tu cuenta SingleFax. También aparece en el catálogo Smithery como @singlefax/fax.

Pulsa Añadir a Cursor arriba o guarda esto en ~/.cursor/mcp.json.
Aprueba la pantalla de consentimiento OAuth de SingleFax.
Pide al agente enviar un fax. Para un documento habitual llama a create_upload, da un enlace de subida y después usa create_fax_draft con uploadToken. Envía el original sin convertir antes a PDF.

~/.cursor/mcp.json

{
  "mcpServers": {
    "singlefax": {
      "url": "https://singlefax.com/mcp"
    }
  }
}

Cursor no genera Stripe Shared Payment Tokens. Usa preferentemente el enlace de Checkout de create_fax_draft. Para pagar MPP desde su terminal, consulta MPP más abajo. documentación MCP de Cursor.

Claude Code

Ejecuta el comando y completa OAuth con /mcp en la sesión.

terminal

claude mcp add --transport http singlefax https://singlefax.com/mcp

Claude.ai o Desktop

Abre Personalizar → Conectores.
Añade un conector personalizado llamado singlefax con la URL https://singlefax.com/mcp.
Conecta y activa el conector en el chat.

Las cuentas gratis de Claude.ai admiten un conector personalizado. Claude no tiene enlace de instalación directo: el botón copia el comando y abre Conectores. documentación MCP de Claude Code.

Pega los comandos en el terminal. CLI, extensión IDE y ChatGPT de escritorio comparten ~/.codex/config.toml.
codex mcp login singlefax inicia OAuth si no lo hizo el paso de añadir.
En una sesión Codex, ejecuta /mcp para comprobar las herramientas.

terminal

codex mcp add singlefax --url https://singlefax.com/mcp
codex mcp login singlefax

~/.codex/config.toml

[mcp_servers.singlefax]
url = "https://singlefax.com/mcp"

documentación MCP de Codex.

Activa Modo de desarrollador en Configuración → Seguridad e inicio de sesión.
Abre Conectores o Plugins y crea un conector personalizado.
Nombre: SingleFax. URL MCP: https://singlefax.com/mcp. Autenticación: OAuth.
En el chat, activa el modo de desarrollador y SingleFax antes de pedir un fax.

MCP server URL

https://singlefax.com/mcp

El MCP personalizado de ChatGPT usa modo de desarrollador, no Instant Checkout. El agente sigue devolviendo una URL de SingleFax para que pagues. documentación de conectores ChatGPT.

Pulsa Añadir a VS Code o abre Paleta de comandos → MCP: Add Server.
O guárdalo en .vscode/mcp.json del proyecto o en tu configuración MCP.

.vscode/mcp.json

{
  "servers": {
    "singlefax": {
      "type": "http",
      "url": "https://singlefax.com/mcp"
    }
  }
}

documentación MCP de VS Code.

Qué pedir

Una vez conectado el servidor, basta una instrucción como esta. Para un documento habitual, el agente debe llamar a create_upload, proporcionarte uploadPageUrl para que subas el archivo original y llamar después a create_fax_draft con uploadToken. Las aplicaciones de chat no pueden incluir un archivo normal en base64 en una llamada a una herramienta. No conviertas antes los archivos Word, Excel o las imágenes a PDF: nosotros los convertimos antes de enviarlos. El agente calcula el precio y después abre Checkout o envía el fax usando tu cupo de páginas.

example prompt

Send this document as a fax to +1-415-555-2671 using SingleFax.

list_skus, Catálogo con precios. HIPAA, EIN e IRS solo se tramitan en la web; incluye URL

quote_fax, Precio de envío individual. Pasa to y, opcionalmente, pages o base64 para calcular páginas reales

create_fax_draft, Envía con to y uploadToken tras create_upload: usa crédito o cupo, o devuelve URL de Checkout. base64 solo para archivos diminutos. Manda Word, Excel, PDF o imágenes originales; no conviertas antes.

create_inbound_number, Consigue un número exclusivo, por defecto 30 días, $4.99. Devuelve URL de Checkout y número reservado. Tras pagar, usa list_numbers.

list_numbers, Lista los números activos de esta cuenta

create_checkout, Crédito u otros SKU del catálogo; para un número, mejor create_inbound_number

create_upload, Archivos grandes: devuelve uploadPageUrl para subida humana sin acceso y uploadUrl para PUT de datos sin Authorization. Pasa uploadToken para consultar el estado stored

get_fax_status, Consulta el estado de entrega de un pedido tuyo

get_credits, Consulta el saldo de crédito prepago

create_machine_fax, JSON de desafío MPP. Link CLI, SPT, o carteras Tempo. REST 402 es la vía real de pago

MPP: pago autónomo

Machine Payment Protocol es un protocolo del comprador: el servidor devuelve HTTP 402, el agente adjunta Stripe Shared Payment Token o un pago Tempo USDC y reintenta. Esa vía es POST https://singlefax.com/api/v1/machine/faxes, no las herramientas MCP del chat.

Cursor, Claude Code y Codex pueden call esa URL desde terminal, pero no generan SPT sin una cartera. La vía de tarjeta Stripe es Link CLI, para cuentas Link de Estados Unidos. Aprueba cada gasto en Link. Tempo Wallet, Privy, AgentCash y Kite Passport pagan el desafío Tempo en la misma URL.

MPP o pago inmediato Stripe MPP Pagar con Link CLI Shared Payment Tokens repositorio de link-cli Tempo CLI especificación mpp.dev mpp.md de SingleFax

Instala la skill con npx skills add stripe/link-cli o añade MCP npx @stripe/link-cli --mcp.
Inicia sesión y paga el endpoint automatizado: E.164 válido y base64 real del archivo original, no +1555 de ejemplo ni PDF convertido previamente, salvo que el original ya sea PDF.
No dirijas mpp pay a /mcp. Link CLI necesita una URL que devuelva HTTP 402 y 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 de desafíos, validación, estado y reembolsos: mpp.md. Mínimo SPT $0.50, Tempo USDC $0.01 y precio mínimo de SingleFax $0.99.

API REST y CLI

Para tu servidor, crea clave limitada y compra crédito, sin redirección de pago. Los ejemplos curl, Node, Python, Go y PHP están en la página de desarrolladores.

Documentación para desarrolladores Crear una clave API CLI de SingleFax Especificación OpenAPI 3 Flujo de aprobación de autenticación del agente

Preguntas frecuentes

Documentos legibles para agentes

Markdown sencillo para rastreadores y agentes de programación. Los mismos datos que esta página.

llms.txt agents.md developers.md mpp.md auth.md openapi.json versioning.md Especificación MCP