MCP · Stripe MPP

Serveur MCP SingleFax

Connectez Cursor, Claude, Codex, ChatGPT ou VS Code à SingleFax via MCP. L’assistant importe l’original Word, Excel, PDF ou image, sans conversion préalable, établit le devis puis ouvre le paiement ou utilise votre quota.

Ajouter à CursorAjouter à VS Code

Cursor et VS Code s’installent en un clic. Pour Claude, Codex et ChatGPT, le code est copié et la bonne page de réglages s’ouvre. Lien direct Cursor si l’installation web n’ouvre pas l’application.

https://singlefax.com/mcp

Applications de chat

Cursor, Claude, Codex, ChatGPT. MCP et OAuth. Vous confirmez le paiement, sauf s’il reste des pages d’abonnement.

Scripts et backends

Clé API et crédits prépayés. Sans redirection de paiement. Adapté à vos traitements serveur.

API, CLI et exemples par langage

Paiement autonome

Stripe MPP, HTTP 402. Link CLI pour les cartes, ou Tempo USDC pour Tempo Wallet, Privy, AgentCash et Kite.

URL machine, Link CLI, Tempo

Installation selon le client

Streamable HTTP sur https://singlefax.com/mcp. Après installation, le client lance OAuth : connectez-vous avec votre compte SingleFax. Également dans le catalogue Smithery sous @singlefax/fax.

Exemple de demande

Une fois le serveur connecté, une instruction comme celle-ci suffit. Pour un document courant, l’agent doit appeler create_upload, vous donner uploadPageUrl pour déposer l’original, puis appeler create_fax_draft avec uploadToken. Les applications de chat ne peuvent pas transporter un fichier normal en base64 dans un appel d’outil. Ne convertissez pas Word, Excel ou les images en PDF avant ; nous le faisons avant l’envoi. L’agent établit le devis, puis ouvre Checkout ou utilise votre quota de pages.

example prompt
Send this document as a fax to +1-415-555-2671 using SingleFax.
list_skus, Catalogue et tarifs. HIPAA, EIN et IRS uniquement sur le site, URL incluses
quote_fax, Devis d’envoi à l’unité. Fournir to ; pages ou base64 facultatifs pour un comptage réel
create_fax_draft, Envoyer avec to et uploadToken après create_upload ; utilise crédits ou quota, sinon renvoie une URL de paiement. base64 seulement pour les très petits fichiers. Envoyer l’original Word, Excel, PDF ou image sans conversion préalable.
create_inbound_number, Obtenir un numéro dédié. Par défaut 30 jours, 4,99 $. Renvoie une URL de paiement et le numéro réservé. Utiliser list_numbers après règlement.
list_numbers, Lister les numéros actifs de ce compte
create_checkout, Crédits ou autres offres du catalogue ; préférer create_inbound_number pour un numéro
create_upload, Fichiers volumineux : renvoie uploadPageUrl, dépôt humain sans connexion, et uploadUrl, PUT des octets sans Authorization. Utiliser uploadToken pour vérifier le stockage.
get_fax_status, Consulter le statut d’une commande vous appartenant
get_credits, Lire le solde de crédits prépayés
create_machine_fax, Défi MPP JSON. Link CLI, SPT, ou portefeuilles Tempo. Le REST 402 est le véritable parcours de paiement

MPP, paiement autonome

Machine Payment Protocol est un protocole côté acheteur : le serveur renvoie HTTP 402, l’agent ajoute un Stripe Shared Payment Token ou un paiement Tempo USDC et réessaie. Cela relève de POST https://singlefax.com/api/v1/machine/faxes, pas des outils MCP de chat.

Cursor, Claude Code et Codex peuvent appeler cette URL avec call dans un terminal, mais ne peuvent pas générer de SPT sans portefeuille fourni. Le parcours carte Stripe est Link CLI pour les comptes Link américains. Approuvez chaque dépense dans Link. Tempo Wallet, Privy, AgentCash et Kite Passport règlent la demande Tempo sur la même URL.

  1. Installez le skill npx skills add stripe/link-cli, ou ajoutez le MCP npx @stripe/link-cli --mcp.
  2. Connectez-vous puis payez le point machine : E.164 valide, vrai document original en base64, pas le texte fictif +1555, ni un PDF préconverti sauf si l’original est déjà un PDF.
  3. Ne dirigez pas mpp pay vers /mcp. Link CLI exige une URL renvoyant HTTP 402 avec 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."

Formats complets, validation, statuts et remboursements : mpp.md. Minimum SPT : 0,50 $ ; Tempo USDC : 0,01 $ ; prix plancher SingleFax : 0,99 $.

API REST et CLI

Pour votre backend, créez une clé à portée limitée et prépayez des crédits, sans redirection de paiement. Des exemples à copier en curl, Node, Python, Go et PHP sont sur la page développeur.

Questions fréquentes

Documentation lisible par les agents

Markdown simple pour les robots et agents de programmation. Les mêmes informations que sur cette page.