Skip to main content
Glama

@pay-skill/mcp

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)に保存します。以降の実行では自動的に読み込まれます。

Related MCP server: @arispay/payagent-mcp

設定

環境変数

必須

デフォルト

説明

PAYSKILL_SIGNER_KEY

いいえ

—

オプションの上書き設定。生の16進数キーまたは .enc キーストアパスワード。通常の使用では不要です。

PAY_NETWORK

いいえ

mainnet

mainnet (Base) または testnet (Base Sepolia)

キーの解決順序(以下の順で確認されます)

  1. OSキーチェーン(デフォルト) — keytar を介してOSの認証情報ストアから読み込みます。初回実行時に新しいキーペアが生成され、自動的に保存されます。

  2. 暗号化キーストア — ~/.pay/keys/default.enc が存在する場合、PAYSKILL_SIGNER_KEY が復号パスワードとして使用されます。

  3. 生の16進数キー — PAYSKILL_SIGNER_KEY が64文字の16進数文字列である場合、それが直接使用されます。開発・テスト用、または既存のウォレットをインポートする場合に使用します。

  4. 自動生成 — 上記のいずれも該当しない場合、新しいキーペアを生成して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_TESTNET_KEY)

ライセンス

MIT

Payの一部として

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

Related MCP Connectors

Related MCP Servers