@pay-skill/mcp

Name: pay-mcp
Author: pay-skill

Pay用MCPサーバー — AIエージェントのための完全なx402決済スタック。Base上のUSDCに対応。

MCP互換クライアント（Claude Desktop、Cursor、VS Code、カスタムフレームワークなど）に、Payの全機能（直接決済、タブ、x402ペイウォール、サービスディスカバリー、ウォレット管理）を提供します。CLIバイナリは不要です。

セットアップ

Claude Desktop

claude_desktop_config.json に以下を追加します：

{
  "mcpServers": {
    "pay": {
      "command": "npx",
      "args": ["-y", "@pay-skill/mcp"]
    }
  }
}

VS Code / Cursor

.vscode/mcp.json に以下を追加します：

{
  "servers": {
    "pay": {
      "command": "npx",
      "args": ["-y", "@pay-skill/mcp"]
    }
  }
}

Claude Code

claude mcp add pay -- npx -y @pay-skill/mcp

以上です。初回実行時にサーバーがウォレットを生成し、OSのキーチェーン（Windows Hello、macOS Keychain、Linux Secret Service）に保存します。以降の実行では自動的に読み込まれます。

設定

環境変数	必須	デフォルト	説明
`PAYSKILL_SIGNER_KEY`	いいえ	—	オプションの上書き。生の16進数キーまたは `.enc` キーストアパスワード。通常の使用では不要です。
`PAY_NETWORK`	いいえ	`mainnet`	`mainnet` (Base) または `testnet` (Base Sepolia)

キーの解決順序（以下の順に確認されます）

OSキーチェーン（デフォルト） — keytar を介してOSの認証情報ストアから読み込みます。初回実行時に新しいキーペアが生成され、自動的に保存されます。
暗号化キーストア — ~/.pay/keys/default.enc が存在する場合、PAYSKILL_SIGNER_KEY が復号パスワードとして使用されます。
生の16進数キー — PAYSKILL_SIGNER_KEY が64文字の16進数文字列である場合、それが直接使用されます。開発/テスト用、または既存のウォレットをインポートする場合に使用します。
自動生成 — 上記のいずれも該当しない場合、新しいキーペアを生成してOSキーチェーンに保存します。

診断チェック

設定が正しく行われているか確認します：

npx @pay-skill/mcp --check

出力：

pay-mcp diagnostic check
  network: Base (chain 8453)
  api:     https://pay-skill.com/api/v1
  wallet:  0x1234...
  key:     keychain
  server:  OK (router: 0xABCD...)
  auth:    OK (balance: $50.00)

All checks passed. MCP server is ready.

ツール (15)

決済

ツール	説明
`pay_send`	直接USDC決済（最低1ドル）。確認しきい値：10ドル未満は自動、10〜100ドルはプラン確認、100ドル超は明示的な承認が必要。
`pay_request`	x402自動決済付きHTTPリクエスト。402検出、直接/タブ決済、価格の妥当性チェックを処理します。

タブ（従量課金アカウント）

ツール	説明
`pay_tab_open`	事前チャージ型タブを開く（最低5ドル、50ドル推奨）。プロバイダーが呼び出しごとに課金します。
`pay_tab_close`	タブを閉じる。分配の内訳（プロバイダー99%、手数料1%、エージェント残高）を返します。
`pay_tab_charge`	開いているタブに対して課金する（プロバイダーのみ）。
`pay_tab_topup`	開いているタブに資金を追加する（エージェントのみ）。
`pay_tab_list`	アイドル状態や残高不足のフラグが付いたタブを一覧表示します。

ウォレット

ツール	説明
`pay_status`	残高、ロック中/利用可能な資金、実行可能な提案を表示します。
`pay_fund`	1時間有効な入金リンク（Coinbase Onrampまたは直接USDC）を生成します。
`pay_withdraw`	1時間有効な出金リンクを生成します。
`pay_mint`	テストネット用USDCをミントします（Base Sepoliaのみ）。

ディスカバリーとWebhook

ツール	説明
`pay_discover`	キーワードやカテゴリで有料APIサービスを検索します。
`pay_webhook_register`	決済イベント用のWebhookを登録します（HMAC署名付き）。
`pay_webhook_list`	登録済みWebhookを一覧表示します。
`pay_webhook_delete`	Webhookを削除します。

リソース (5)

URI	説明
`pay://wallet/status`	残高、タブ、ロック中/利用可能な資金
`pay://wallet/tabs`	すべてのオープン中のタブ
`pay://tab/{tab_id}`	個別のタブ詳細
`pay://wallet/address`	ウォレットアドレス
`pay://network`	ネットワーク設定とコントラクトアドレス

プロンプト (3)

プロンプト	説明
`pay-for-service`	ガイド付き：サービスの検索、価格評価、リクエストの実行
`review-tabs`	タブの確認、アイドル状態のフラグ立て、クローズ/チャージの提案
`fund-wallet`	入金リンクの生成、入金プロセスの説明

開発

git clone https://github.com/pay-skill/pay-mcp.git
cd pay-mcp
npm install
npm run build
npm test                    # unit tests (mocked)
npm run test:acceptance     # testnet (requires PAYSKILL_SIGNER_KEY)

ライセンス

MIT

Payの一部として

Payは、AIエージェントがBase上のUSDCでAPIの支払いを行えるようにする、ゲートウェイ、ファシリテーター、SDK、CLI、MCPサーバーを含む完全なx402決済スタックです。

ドキュメント
アーキテクチャ
SDK -- Python + TypeScript
CLI -- コマンドラインツール
pay-gate -- x402決済ゲートウェイ
プロトコル -- スマートコントラクト

pay-mcp