Muss ich die Datei zuerst in PDF umwandeln?

Nein. Senden Sie die originale Word-, Excel-, PowerPoint-, RTF-, Text-, Bild- oder PDF-Datei. Wir konvertieren vor dem Versand. Bitte nicht selbst vorher in PDF umwandeln.

Kann ich eine große Datei aus Grok oder ChatGPT faxen?

Chat-MCP kann typische Dokumente nicht als Base64 transportieren; Clients hängen oft schon bei einigen zehn KB. Der Assistent ruft create_upload auf und liefert einen Uploadlink ohne Anmeldung. Nach Ihrem Upload sendet er mit uploadToken. Skripte können Rohdaten per HTTP PUT an uploadUrl senden, ohne Authorization-Header.

Welchen Weg sollte mein Agent nutzen?

Chat-Apps (Cursor, Claude, Codex, ChatGPT) nutzen MCP: Das Werkzeug liefert einen Checkout-Link oder nutzt Ihr Abo-Seitenkontingent. Autonome Skripte, die Stripe Shared Payment Tokens erzeugen oder Tempo USDC bezahlen können, nutzen den REST-Maschinenendpunkt mit MPP. Backend-Aufgaben verwenden API-Schlüssel und Prepaid-Guthaben; siehe /developers.

Kann Cursor selbst mit Stripe MPP bezahlen?

Nein. Cursor hat keine Stripe-Wallet. Nutzen Sie MCP mit Checkout, installieren Sie Stripe Link CLI (npx skills add stripe/link-cli) und führen Sie link-cli mpp pay für die REST-Maschinen-URL aus oder bezahlen Sie die Tempo-USDC.e-Anforderung über Tempo Wallet, Privy, AgentCash oder Kite Passport.

Kann ich mit Krypto oder Tempo bezahlen?

Ja, im maschinellen Faxablauf. POST /api/v1/machine/faxes liefert HTTP 402 mit Tempo USDC.e neben Stripe SPT. Tempo Wallet, Privy, AgentCash und Kite Passport können zahlen. Website-Checkout nutzt weiterhin Karte, Apple Pay, Google Pay oder Link, nicht Bitcoin.

Brauche ich ein Konto?

MCP verwendet OAuth, daher melden Sie sich im Zustimmungsfenster an oder erstellen ein Konto. MPP-Maschinenversand benötigt keinen API-Schlüssel. REST und CLI mit Guthaben brauchen einen Schlüssel aus dem Kundenkonto, siehe /developers.

Ist das HIPAA-konform?

Nein. Keine PHI über MCP, MPP oder öffentliche API senden. HIPAA-pflichtige Einrichtungen nutzen HIPAA Secure Mode auf der Website mit elektronischem BAA.

MCP · Stripe MPP

SingleFax-MCP-Server

Verbinden Sie Cursor, Claude, Codex, ChatGPT oder VS Code per MCP mit SingleFax. Der Assistent lädt die Originaldatei (Word, Excel, PDF oder Bild ohne vorherige Konvertierung) hoch, erstellt ein Angebot und öffnet Checkout oder nutzt Ihr Seitenkontingent.

Zu Cursor hinzufügen Zu VS Code hinzufügen

Cursor und VS Code lassen sich mit einem Klick einrichten. Für Claude, Codex und ChatGPT wird das Beispiel kopiert und die passende Einstellungsseite geöffnet. Cursor-Deeplink, wenn die Web-Installationsseite die App nicht öffnet.

https://singlefax.com/mcp

Chat-Apps

Cursor, Claude, Codex, ChatGPT. MCP mit OAuth. Sie bestätigen die Zahlung, sofern keine Abo-Seiten übrig sind.

Skripte und Backends

API-Schlüssel mit Prepaid-Guthaben. Keine Checkout-Weiterleitung. Für eigene Hintergrundprozesse geeignet.

API, CLI und Sprachbeispiele

Autonome Zahlung

Stripe MPP (HTTP 402). Link CLI für Karten oder Tempo USDC für Tempo Wallet / Privy / AgentCash / Kite.

Maschinen-URL, Link CLI, Tempo

Installation nach Client

Streamable HTTP unter https://singlefax.com/mcp. Nach Installation startet der Client OAuth; melden Sie sich mit Ihrem SingleFax-Konto an. Auch im Smithery-Katalog als @singlefax/fax verfügbar.

Oben auf Zu Cursor hinzufügen klicken oder dies in ~/.cursor/mcp.json speichern.
SingleFax-OAuth-Zustimmung bestätigen.
Bitten Sie den Agenten um einen Faxversand. Bei üblichen Dokumenten ruft er create_upload auf und gibt Ihnen einen Uploadlink, danach create_fax_draft mit uploadToken. Originaldatei senden, nicht vorher in PDF umwandeln.

~/.cursor/mcp.json

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

Cursor kann nicht Stripe Shared Payment Tokens erzeugen. Nutzen Sie bevorzugt den Checkout-Link von create_fax_draft. Für MPP-Zahlungen im Cursor-Terminal siehe MPP weiter unten. Cursor-MCP-Dokumentation.

Claude Code

Befehl ausführen und danach OAuth in der Sitzung mit /mcp abschließen.

terminal

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

Claude.ai / Desktop

Anpassen → Konnektoren öffnen.
Fügen Sie einen benutzerdefinierten Konnektor namens singlefax mit der URL https://singlefax.com/mcp hinzu.
Verbinden und den Konnektor im Chat aktivieren.

Kostenlose Claude.ai-Konten unterstützen nur einen eigenen Konnektor. Claude hat keinen Installations-Deeplink; die Schaltfläche kopiert den CLI-Befehl und öffnet die Konnektoren. Claude-Code-MCP-Dokumentation.

Befehle im Terminal einfügen. CLI, IDE-Erweiterung und ChatGPT Desktop teilen ~/.codex/config.toml.
codex mcp login singlefax startet OAuth, falls es beim Hinzufügen nicht gestartet wurde.
In einer Codex-Sitzung mit /mcp die Werkzeuge prüfen.

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"

Codex-MCP-Dokumentation.

Entwicklermodus aktivieren (Einstellungen → Sicherheit und Anmeldung).
Konnektoren/Plugins öffnen und eigenen Konnektor erstellen.
Name: SingleFax. MCP-URL: https://singlefax.com/mcp. Authentifizierung: OAuth.
Im Chat Entwicklermodus und SingleFax-Konnektor aktivieren, bevor Sie um Faxversand bitten.

MCP server URL

https://singlefax.com/mcp

Eigenes MCP in ChatGPT gehört zum Entwicklermodus, nicht Instant Checkout. Der Agent liefert weiterhin eine SingleFax-Checkout-URL zur Zahlung. ChatGPT-Konnektor-Dokumentation.

Auf Zu VS Code hinzufügen klicken oder Befehlspalette → MCP: Add Server.
Oder in .vscode/mcp.json im Projekt bzw. der persönlichen MCP-Konfiguration speichern.

.vscode/mcp.json

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

VS-Code-MCP-Dokumentation.

Beispielanfrage

Nach dem Verbinden des Servers reicht eine solche Anweisung. Für ein gewöhnliches Dokument sollte der Agent create_upload aufrufen, Ihnen uploadPageUrl zum Hochladen der Originaldatei geben und dann create_fax_draft mit uploadToken ausführen. Chat-Apps können keine normale Datei als Base64 in einem Toolaufruf übertragen. Wandeln Sie Word, Excel oder Bilder vorher nicht in PDF um; das übernehmen wir vor dem Versand. Der Agent ermittelt den Preis und öffnet dann Checkout oder nutzt Ihr Seitenkontingent.

example prompt

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

list_skus, Katalog mit Preisen. HIPAA, EIN und IRS nur auf der Website (URLs enthalten)

quote_fax, Angebot für Einzelversand. to übergeben; optional pages oder base64 für aktuelle Seitenzahl

create_fax_draft, Mit to und uploadToken nach create_upload senden; nutzt Guthaben/Seitenkontingent, sonst Checkout-URL. base64 nur für sehr kleine Dateien. Originale Word-, Excel-, PDF- oder Bilddatei senden, nicht vorher in PDF umwandeln.

create_inbound_number, Eigene Faxnummer erhalten. Standard: 30 Tage (4,99 $). Liefert Checkout-URL und reservierte Nummer. Nach Zahlung list_numbers verwenden.

list_numbers, Aktive Faxnummern dieses Kontos auflisten

create_checkout, Guthaben oder andere Katalogangebote; für Faxnummern bevorzugt create_inbound_number

create_upload, Große Dateien: liefert uploadPageUrl (manueller Upload ohne Anmeldung) und uploadUrl (PUT-Rohdaten ohne Authorization). Mit uploadToken den Speicherstatus abfragen.

get_fax_status, Zustellstatus eines eigenen Auftrags abfragen

get_credits, Prepaid-Guthaben abfragen

create_machine_fax, MPP-Challenge-JSON. Link CLI (SPT) oder Tempo-Wallets. REST 402 ist der eigentliche Zahlungsweg

MPP: autonome Zahlung

Machine Payment Protocol ist ein Käuferprotokoll: Der Server liefert HTTP 402, der Agent fügt einen Stripe Shared Payment Token oder eine Tempo-USDC-Zahlung an und wiederholt. Das ist POST https://singlefax.com/api/v1/machine/faxes, nicht die Chat-MCP-Werkzeuge.

Cursor, Claude Code und Codex können die URL im Terminal mit call aufrufen, aber ohne bereitgestellte Wallet keine SPTs erzeugen. Stripes Kartenweg ist Link CLI für US-Link-Konten. Jede Ausgabe in der Link-App freigeben. Tempo Wallet, Privy, AgentCash und Kite Passport bezahlen die Tempo-Anforderung unter derselben URL.

MPP oder Instant Checkout Stripe MPP Mit Link CLI bezahlen Shared Payment Tokens link-cli-Repository Tempo CLI mpp.dev-Spezifikation SingleFax mpp.md

Skill installieren: npx skills add stripe/link-cli, oder MCP npx @stripe/link-cli --mcp hinzufügen.
Anmelden und Maschinenendpunkt bezahlen: gültige E.164-Nummer, echtes Base64 des Originaldokuments statt Platzhalter +1555, keine vorab konvertierte PDF, sofern das Original nicht bereits PDF ist.
mpp pay nicht auf /mcp richten. Link CLI benötigt eine URL, die HTTP 402 mit WWW-Authenticate liefert.

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."

Vollständige Anforderungen, Validierung, Status und Erstattungen: mpp.md. SPT-Mindestbetrag 0,50 $, Tempo-USDC-Mindestbetrag 0,01 $; SingleFax-Einzelversand mindestens 0,99 $.

REST-API + CLI

Für eigene Backends erstellen Sie einen berechtigungseingeschränkten Schlüssel und kaufen Guthaben, ohne Checkout-Weiterleitung. Direkt nutzbare Beispiele für curl, Node, Python, Go und PHP stehen auf der Entwicklerseite.

Entwicklerdokumentation API-Schlüssel erstellen SingleFax-CLI OpenAPI-3-Spezifikation Freigabeablauf für die Agenten-Authentifizierung

Häufige Fragen

Für Agenten lesbare Dokumentation

Markdown für Crawler und Coding-Agenten. Dieselben Fakten wie auf dieser Seite.

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