prime-agent-stripe-mcp
prime-agent-stripe-mcp
Prime Agent 向けの公式 Stripe MCP 統合。
Prime Agent は、Stripe の公式リモート MCP サーバー https://mcp.stripe.com に接続します。エージェントは、他の MCP クライアントと同じ API サーフェスを通じて Stripe リソースを検査および管理できます。
[!NOTE] Stripe の MCP サーバーはパブリックプレビュー中です。読み取りと書き込みの両方のツールを公開しています。 開発中は接続をテストモードに保ってください。
┌─────────────────────────────────┐ ┌─────────────────────────────────┐
│ │ from stripe import │ │ │ │ mcp.stripe.com │ │
│ │ stripe │ │ │ │ API · billing · reporting │ │
│ │ await stripe.list_tools() │──┼ OAuth 2.1 + PKCE │ │ products · customers │ │
│ │ await stripe.call_tool( │ │ │ │ subscriptions · events │ │
│ auth.json: mcp:stripe │ │ │ documentation search │ │
└─────────────────────────────────┘ └─────────────────────────────────┘この統合の理由
Stripe ホスト型サーバー — このリポジトリには自己ホスト型プロキシも Stripe API キーもありません。
Prime Agent ネイティブ — このモジュールは
McpIntegrationを拡張し、Python カーネルからライブツールインベントリを公開します。OAuth 2.1 with PKCE — ブラウザでの承認は、Prime Agent のプライベートな
auth.jsonのmcp:stripeにのみ保存されます。テストモード対応 — Liminal Stripe アカウントを承認し、開発中はテストモードのリソースのみを使用します。
Related MCP server: Stripe MCP Server
インストール
Python カーネルと Python 3.10 以降を備えた Prime Agent が必要です。
リポジトリをクローンし、スキルを所定の場所にリンクします:
git clone https://github.com/gbrlpzz/prime-agent-stripe-mcp.git ~/prime-agent-stripe-mcp rm -rf ~/.agents/skills/stripe ln -s ~/prime-agent-stripe-mcp ~/.agents/skills/stripePrime Agent のカーネル環境に編集可能なパッケージをインストールします:
uv pip install --python ~/.prime/agent/kernel-venv/bin/python -e ~/prime-agent-stripe-mcpPrime Agent の MCP 設定にリモートサーバーを一度追加します:
{ "mcpServers": { "stripe": { "type": "http", "url": "https://mcp.stripe.com", "oauth": true } } }Prime Agent をリロードし、Stripe アカウントを承認します:
/reload /mcp login stripe
Liminal Stripe アカウントを承認してください。この開発ワークフローの外に置くべき個人用や本番用のアカウントではありません。Prime Agent は資格情報を mcp:stripe として保存します。このリポジトリに書き込まれることはありません。
使用方法
from stripe import stripe, auth_status
print(auth_status()) # credential state, no token values
tools = await stripe.list_tools() # live Stripe MCP inventory
# Inspect the live schema before calling a read or write tool.
result = await stripe.call_tool("<live-tool-name>", {"<live-argument>": "..."})auth_status() はシークレットを含まない小さな dict を返します:
{"enabled": True, "expires_fresh": True, "type": "oauth"}ツール名とパラメータは Stripe に属し、パブリックプレビュー中に変更される可能性があります。最初に list_tools() を呼び出すか、ライブインベントリから自動的にバインドされたメソッドを使用してください。
サーバーには、Stripe API の検出、API の読み取りと書き込み、アカウント情報、請求リソース、ドキュメント、レポートのためのツールが含まれています。書き込み操作は Stripe データを変更します。作成、更新、キャンセル、返金、削除を行う前に、人間の確認を求めてください。
トークン更新のフォールバック
Prime Agent は保存されたトークンを自動的に更新します。それが利用できないホストでは、モジュールレベルのフォールバックを呼び出してください:
from stripe import refresh
refresh() # exchanges the stored refresh token; rewrites auth.json with mode 600Liminal 開発ワークフロー
個人ユーザーを Liminal Stripe アカウントのチームメンバーとして追加します。
そのユーザーとしてこの統合を承認します。
Stripe ダッシュボードがテストモードであることを確認します。
テスト用の商品、価格、顧客、サブスクリプションのみを作成します。
Supabase の
stripe-webhook関数を、結果のテスト用ウェブフック署名シークレットで個別に設定します。MCP 資格情報は、サーバー側のSTRIPE_SECRET_KEYやSTRIPE_WEBHOOK_SECRETを置き換えるものではありません。
トラブルシューティング
症状 | 修正 |
|
|
長い一時停止の後に呼び出しが失敗する |
|
ツール名が不明である |
|
開発
python3 tests/test_skill.py # standalone suite, no Prime Agent needed
~/.prime/agent/kernel-venv/bin/python -m pytest tests/ # inside Prime Agent's kernelCI は main へのプッシュのたびにスタンドアロンスイートを実行します。
セキュリティ
このリポジトリや Git 履歴には資格情報は存在しません。
OAuth トークンは Prime Agent のプライベートな
auth.jsonにのみ保存されます。モジュールは
https://mcp.stripe.comと Stripe の OAuth 認可サーバーとのみ通信します。すべての開発用変更は Stripe テストモードで行ってください。
Stripe のシークレット値や秘密鍵の素材をソース、テスト、ドキュメント、Git 履歴に置かないでください。
ライセンス
MIT — LICENSE を参照してください。Stripe は Stripe, Inc. の商標です。これは Stripe の公式 MCP サーバー向けの独立したクライアント統合です (NOTICE を参照)。
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Connect any AI agent to 1,000+ apps and 27,000+ actions through one remote MCP server (OAuth).
Search and discover Agent Skills from the skills.sh registry. Powered by HAPI MCP server.
Chat with your Zihin.ai agents, list them and load platform skills from any MCP client.
Spacebring MCP server. Look up members, bookings, invoices, subscriptions, events and more, and take everyday actions such as creating events or replying to support tickets, from MCP-compatible AI assistants that support remote servers with OAuth.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceA remote MCP server implementation that integrates with Stripe, enabling AI assistants to interact with the Stripe API for payment processing functionality.-
- AlicenseNot gradedqualityDmaintenanceEnables natural language interaction with Stripe accounts to query customers, revenue, invoices, subscriptions, disputes, and issue refunds.1MIT
- AlicenseNot gradedqualityDmaintenanceEnables integration with Stripe APIs through function calling, supporting operations on customers, products, invoices, subscriptions, and more.31,367 npmMIT
- AlicenseAqualityCmaintenanceEnables AI agents to query Stripe operations such as customers, recent charges, duplicate charges, and revenue summaries through read-only MCP tools.4MIT