PayAgents MCP Server (payagents-mCP)

PayAgents 公式の Model Context Protocol (MCP) サーバーです。AIエージェント（Claude Desktop、Cursor、Windsurf、Zed、LangChain、OpenDevin）にポリシー制御されたウォレットを提供し、Bitcoin Lightning (L402) と Base USDC (x402) を介してAPIやツールに自律的に支払いを行えるようにします。

⚡ Claude Desktop のクイックスタート

payagents-mcp を claude_desktop_config.json に追加します:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "payagents": {
      "command": "npx",
      "args": ["-y", "payagents-mcp"],
      "env": {
        "PAYAGENTS_API_KEY": "pa_live_your_api_key_here"
      }
    }
  }
}

Claude Desktop を再起動すると、AIアシスタントが PayAgents の支払いツールに自動的にアクセスできるようになります。

Related MCP server: @arispay/payagent-mcp

🛠️ 利用可能なMCPツール

1. payagents_pay_url

任意のAPIエンドポイントまたはペイウォール付きリソースに対してHTTPリクエストを実行し、エンタープライズの支出制限内でHTTP 402 / L402 / x402の支払いチャレンジを自動的に解決して支払います。

• パラメータ:

  • url (必須, 文字列): 対象のAPI URL。

  • method (任意, デフォルト: "GET"): GET, POST, PUT, DELETE。

  • body (任意, オブジェクト/文字列): リクエストボディのペイロード。

  • headers (任意, オブジェクト): 追加のHTTPヘッダー。

  • max_amount (任意, 文字列): 支払ってもよい最大金額 (例: "0.01 USD")。

2. payagents_get_balance

エージェントの利用可能な支出残高、サブスクリプションプラン、アクティブな支出ポリシー（取引ごとの上限と1日の制限）を確認します。

3. payagents_get_transaction

過去の取引の詳細を照会し、支払いレール、決済方法（🟢 ダイレクト非カストディアル と プラットフォーム管理）、暗号検証証明を表示します。

💰 独自のMCPツールの収益化

MCPサーバーを構築していて、他のエージェントがツールを呼び出す際に少額の手数料を請求したい場合は、次のようにします:

npm install payagents-mcp @modelcontextprotocol/sdk zod

import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
import { mcpCharge } from 'payagents-mcp';
import { z } from 'zod';

const server = new McpServer({ name: 'weather-mcp', version: '1.0.0' });

// Gate your tool behind $0.002 micro-payment
server.tool(
  'get_forecast',
  'Retrieve real-time radar forecast data',
  { city: z.string() },
  mcpCharge({ price: '0.002 USD' }, async ({ city }) => {
    return {
      content: [{ type: 'text', text: `Forecast data for ${city}` }],
    };
  })
);

🔒 セキュリティと支出ポリシー

すべてのエージェント支払いは、PayAgents ダッシュボードのポリシーエンジンによって強制されます:

• 取引ごとの制限: 上限を超える個々の呼び出しをブロックします（例: 最大$0.01）。

• 1日の予算上限: 暴走する再帰ループを防ぎます（例: 1日最大$5.00）。

• ドメイン許可リスト: エージェントの支出を検証済みドメインのみに制限します。

• 人間の承認トリガー: 高額な呼び出しは自動的に一時停止され、人間の承認を待ちます。

ライセンス

MIT © PayAgents