Devo convertire prima in PDF?

No. Invia Word, Excel, PowerPoint, RTF, testo, immagine o PDF originali. Convertiamo prima dell’invio: non farlo tu.

Posso inviare file grandi da Grok o ChatGPT?

MCP chat non trasporta un documento normale in base64: i client si bloccano su decine di KB. L’assistente chiama create_upload e dà un link senza accesso. Dopo il caricamento originale invia con uploadToken. Gli script possono fare HTTP PUT dei byte su uploadUrl senza Authorization.

Quale percorso deve usare il mio agente?

Le chat (Cursor, Claude, Codex, ChatGPT) usano MCP: restituisce Checkout o usa le pagine dell’abbonamento. Script autonomi che generano SPT Stripe o pagano Tempo USDC chiamano l’endpoint REST macchina con MPP. I processi backend usano chiave API e credito prepagato, vedi /developers.

Cursor può pagare da solo con Stripe MPP?

No, Cursor non ha un wallet Stripe. Usa MCP + Checkout, installa Stripe Link CLI (npx skills add stripe/link-cli) ed esegui link-cli mpp pay sull’URL REST macchina, oppure paga la richiesta Tempo USDC.e da Tempo Wallet, Privy, AgentCash o Kite Passport.

Posso pagare con crypto o Tempo?

Sì, sul percorso macchina. POST /api/v1/machine/faxes restituisce HTTP 402 con Tempo USDC.e e Stripe SPT. Possono pagare Tempo Wallet, Privy, AgentCash e Kite Passport. Checkout sul sito resta carta, Apple Pay, Google Pay o Link, non Bitcoin.

MCP usa OAuth, quindi sì: accedi o registrati dalla schermata di consenso. Gli invii MPP non richiedono chiave API. REST e CLI a crediti richiedono una chiave dal pannello (vedi /developers).

No. Non inviare PHI via MCP, MPP o API pubblica. Gli enti soggetti usano HIPAA Secure sul sito con BAA elettronico.

MCP · Stripe MPP

Server MCP SingleFax

Collega Cursor, Claude, Codex, ChatGPT o VS Code via MCP. L’assistente carica l’originale (Word, Excel, PDF o immagine, senza prima convertirlo), calcola il prezzo e apre Checkout o usa le tue pagine.

Aggiungi a Cursor Aggiungi a VS Code

Cursor e VS Code installano in un clic. Claude, Codex e ChatGPT copiano il frammento e aprono le impostazioni corrette. Deeplink Cursor se la pagina web non apre l’app.

https://singlefax.com/mcp

App di chat

Cursor, Claude, Codex, ChatGPT. MCP + OAuth. L’utente conferma il pagamento salvo pagine residue dell’abbonamento.

Script e backend

Chiave API e credito prepagato. Senza reindirizzare al pagamento, ideale per i tuoi processi.

API, CLI ed esempi di linguaggio

Pagamento autonomo

Stripe MPP (HTTP 402). Link CLI per carte, Tempo USDC per Tempo Wallet / Privy / AgentCash / Kite.

URL macchina, Link CLI, Tempo

Installa per client

Streamable HTTP su https://singlefax.com/mcp. Dopo l’installazione il client avvia OAuth: accedi a SingleFax. Anche nel catalogo Smithery come @singlefax/fax.

Clicca Aggiungi a Cursor sopra o salva in ~/.cursor/mcp.json.
Approva il consenso OAuth SingleFax.
Chiedi un fax all’agente. Per documenti normali chiama create_upload, offre un link di caricamento, poi create_fax_draft con uploadToken. Invia l’originale, senza convertirlo prima in PDF.

~/.cursor/mcp.json

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

Cursor non genera Stripe Shared Payment Token. Preferisci il link Checkout di create_fax_draft. Per pagare MPP dal terminale Cursor, vedi MPP sotto. Documentazione MCP Cursor.

Claude Code

Esegui il comando, poi completa OAuth con /mcp nella sessione.

terminal

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

Claude.ai / Desktop

Apri Customize → Connectors.
Aggiungi un connettore personalizzato chiamato singlefax con URL https://singlefax.com/mcp.
Connetti, poi abilita il connettore nella chat.

Gli account Claude.ai gratuiti hanno un solo connettore personalizzato. Claude non ha deeplink d’installazione: il pulsante copia il comando CLI e apre Connectors. Documentazione MCP Claude Code.

Incolla i comandi nel terminale (CLI, estensione IDE e ChatGPT desktop condividono ~/.codex/config.toml).
codex mcp login singlefax avvia OAuth se non già avviato nell’aggiunta.
In una sessione Codex, esegui /mcp per verificare gli strumenti.

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"

Documentazione MCP Codex.

Abilita Modalità sviluppatore (Impostazioni → Sicurezza e accesso).
Apri Connectors / Plugins e crea un connettore personalizzato.
Nome: SingleFax. URL MCP: https://singlefax.com/mcp. Autenticazione: OAuth.
In chat abilita modalità sviluppatore e connettore SingleFax prima di chiedere un fax.

MCP server URL

https://singlefax.com/mcp

MCP personalizzato in ChatGPT è per la modalità sviluppatore, non Instant Checkout. L’agente restituisce comunque un URL Checkout SingleFax da pagare. Documentazione connettori ChatGPT.

Clicca Aggiungi a VS Code o Tavolozza comandi → MCP: Add Server.
Oppure salva in .vscode/mcp.json del workspace o nella configurazione MCP utente.

.vscode/mcp.json

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

Documentazione MCP VS Code.

Cosa chiedere

Una volta collegato il server, basta una richiesta come questa. Per un normale documento l'agente chiama create_upload, fornisce uploadPageUrl per caricare l'originale e poi create_fax_draft con uploadToken. Le app di chat non possono trasportare un file normale in base64 in una chiamata a uno strumento. Non convertire prima Word, Excel o immagini: lo facciamo noi prima dell'invio. Il sistema calcola il preventivo, poi apre Checkout o usa il tuo monte pagine.

example prompt

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

list_skus, Catalogo con prezzi. HIPAA, EIN e IRS restano solo sul sito (URL inclusi)

quote_fax, Preventivo al dettaglio. Passa to; facoltativi pages o base64 per conteggio pagine effettivo

create_fax_draft, Invia con to + uploadToken dopo create_upload: usa crediti/pagine disponibili, altrimenti restituisce Checkout URL. base64 solo per file minimi. Invia Word, Excel, PDF o immagini originali, senza conversione preventiva.

create_inbound_number, Ottieni un numero dedicato. Predefinito 30 giorni ($4.99). Restituisce Checkout URL e numero riservato. Dopo il pagamento chiama list_numbers.

list_numbers, Elenca i numeri attivi dell’account

create_checkout, Crediti o altri SKU; per un numero preferisci create_inbound_number

create_upload, File grandi: uploadPageUrl per l’utente senza accesso, uploadUrl per PUT di byte grezzi senza Authorization. Usa uploadToken per verificare lo stato

get_fax_status, Controlla la consegna di un tuo ordine

get_credits, Leggi il saldo prepagato

create_machine_fax, Richiesta MPP JSON. Link CLI (SPT) o wallet Tempo. REST 402 è il percorso di pagamento effettivo

MPP, pagamento autonomo

Machine Payment Protocol è un protocollo dell’acquirente: il server restituisce HTTP 402, l’agente aggiunge SPT Stripe o pagamento Tempo USDC e riprova. È POST https://singlefax.com/api/v1/machine/faxes, non gli strumenti MCP chat.

Cursor, Claude Code e Codex possono eseguire call su quell’URL dal terminale, ma non generare SPT senza un wallet. Il percorso carta Stripe è Link CLI (account Link USA). Approva ogni spesa nell’app Link. Tempo Wallet, Privy, AgentCash e Kite Passport pagano la richiesta Tempo sullo stesso URL.

MPP e Instant Checkout a confronto Stripe MPP Paga con Link CLI Shared Payment Token Repository link-cli Tempo CLI Specifica mpp.dev SingleFax mpp.md

Installa la skill: npx skills add stripe/link-cli, oppure aggiungi MCP npx @stripe/link-cli --mcp.
Accedi e paga l’endpoint macchina: E.164 valido, vero base64 del documento originale, non segnaposto +1555, senza conversione preventiva salvo sorgente già PDF.
Non puntare mpp pay a /mcp. Link CLI vuole un URL che restituisca HTTP 402 + 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."

Strutture complete, validazione, stato e rimborsi: mpp.md. Minimo SPT $0.50, Tempo USDC $0.01; minimo al dettaglio SingleFax $0.99.

REST API + CLI

Per il backend crea una chiave limitata e acquista crediti, senza reindirizzamento Checkout. Esempi pronti curl, Node, Python, Go e PHP nella pagina sviluppatori.

Documentazione sviluppatori Crea una chiave API CLI SingleFax Specifica OpenAPI 3 Procedura di approvazione Agent Auth

Domande frequenti

Documentazione leggibile dagli agenti

Markdown semplice per crawler e agenti di programmazione. Stesse informazioni della pagina.

llms.txt agents.md developers.md mpp.md auth.md openapi.json versioning.md Specifica MCP