MCP・Stripe MPP

SingleFaxのMCPサーバー

Cursor、Claude、Codex、ChatGPT、VS CodeをMCPでSingleFaxへ接続できます。アシスタントが元のファイル(Word、Excel、PDF、画像。事前変換不要)をアップロードして見積もりを提示し、決済画面を開くかページ枠で送信します。

Cursorに追加VS Codeに追加

CursorとVS Codeは1クリックでインストールできます。Claude、Codex、ChatGPTでは設定用コードをコピーして該当する設定ページを開きます。ウェブのインストールページでアプリが開かない場合はCursorのディープリンク。

https://singlefax.com/mcp

チャットアプリ

Cursor、Claude、Codex、ChatGPT。MCP + OAuth。定期プランの残ページがない場合は、人が支払いを確認します。

スクリプト・バックエンド

APIキーと前払いクレジット。決済画面への移動なし。自社の処理システム向け。

API・CLI・各プログラミング言語の使用例

自律的な支払い

Stripe MPP(HTTP 402)。カードはLink CLI、Tempo Wallet・Privy・AgentCash・KiteはTempo USDC。

機械向けURL、Link CLI、Tempo

利用するクライアントに設定

Streamable HTTP:https://singlefax.com/mcp。インストール後にクライアントがOAuthを実行するので、SingleFaxアカウントでログインしてください。Smitheryの一覧にも@singlefax/faxとして掲載しています。

伝える内容

サーバー接続後は、このような指示で十分です。通常の文書ではエージェントがcreate_uploadを呼び、元ファイルのアップロード先uploadPageUrlを渡し、その後uploadTokenを指定してcreate_fax_draftを呼びます。チャットアプリは通常のファイルをツール呼び出しのbase64として扱えません。Word、Excel、画像は先にPDF変換せず、送信前に当社で変換します。見積もり後、決済画面を開くかページ枠で送信します。

example prompt
Send this document as a fax to +1-415-555-2671 using SingleFax.
list_skus, 料金付きのサービス一覧。HIPAA・EIN・IRSはウェブサイト専用(URL付き)
quote_fax, 都度払い送信の見積もり。toを指定し、任意でpagesかbase64を渡してページ数を確認
create_fax_draft, create_uploadの後、to + uploadTokenで送信します。クレジット・ページ枠があれば送信待ちにし、それ以外は決済URLを返します。base64はごく小さいファイルに限ります。元のWord、Excel、PDF、画像を送り、先にPDF変換しないでください。
create_inbound_number, 専用FAX番号を取得します。既定は30日間($4.99)。決済URLと確保した番号を返します。支払い後にlist_numbersを呼び出してください。
list_numbers, このアカウントの利用中のFAX番号を一覧表示
create_checkout, クレジットなどの商品SKU。FAX番号にはcreate_inbound_numberを推奨
create_upload, 大きなファイル:uploadPageUrl(人がアップロード、ログイン不要)とuploadUrl(生のバイト列をPUT、Authorization不要)を返します。uploadTokenを渡して保存状態をポーリングします。
get_fax_status, 所有する注文の送信状況を定期確認
get_credits, 前払いクレジット残高を確認
create_machine_fax, MPPチャレンジのJSON。Link CLI(SPT)・Tempoウォレット用。実際の決済はREST 402

MPPによる自律的な支払い

Machine Payment Protocolは購入者側のプロトコルです。サーバーがHTTP 402を返し、エージェントがStripe Shared Payment TokenまたはTempo USDCの支払いを添付して再試行します。これはPOST https://singlefax.com/api/v1/machine/faxesであり、チャット用MCPツールとは異なります。

Cursor、Claude Code、CodexはターミナルからそのURLをcallできますが、ウォレットを与えない限りSPTは発行できません。Stripeのカード経路はLink CLI(米国のLinkアカウント)です。支払いごとにLinkアプリで承認してください。Tempo Wallet、Privy、AgentCash、Kite Passportは同じURLのTempoチャレンジに支払います。

  1. スキルをインストール:npx skills add stripe/link-cli、またはMCP npx @stripe/link-cli --mcpを追加。
  2. ログインしてからマシンエンドポイントへ支払います。有効なE.164、元ファイルの実際の文書base64を使い、+1555の仮データは使わないでください。元がPDFでない限り、事前変換したPDFは使いません。
  3. mpp payの宛先を/mcpにしないでください。Link CLIにはHTTP 402+WWW-Authenticateを返すURLが必要です。
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."

チャレンジの完全な形式、検証・状況・返金:mpp.md。SPTの最低決済額は$0.50、Tempo USDCは$0.01、SingleFaxの一般向け最低料金は$0.99です。

REST APIとCLI

独自バックエンドでは権限範囲を絞ったキーを作成し、クレジットを前払いします。決済画面への転送はありません。curl、Node、Python、Go、PHPのコピー可能なサンプルは開発者ページをご覧ください。

よくあるご質問

エージェント向けドキュメント

クローラー・コーディングエージェント向けのMarkdown。このページと同じ内容です。