Gatewards

@gatewards/mcp-server

任意のエージェント（Claude Desktop、Cursor、VS Code、または独自の MCP クライアント）が、Gatewards を通じて有料 API を検出して呼び出せる MCP サーバーです。エージェントごとの支出上限、エージェント間の重複排除、非カストディアルな x402 決済に対応しています。

エージェントは自身の API キーとウォレットを保持します。Gatewards はリクエスト処理中に支出上限を適用するため、予算超過の呼び出しは実行後に記録されるのではなく、実行前に拒否されます。

インストール

npx @gatewards/mcp-server --api-key=gw_agent_xxx --gateway=https://api.gatewards.com

Claude Desktop

claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "gatewards": {
      "command": "npx",
      "args": [
        "@gatewards/mcp-server",
        "--api-key=gw_agent_xxx",
        "--gateway=https://api.gatewards.com"
      ]
    }
  }
}

Gatewards ダッシュボードからエージェントキーを取得してください。

2 つのモード

モード	方法	利用できる機能
プロキシ（デフォルト）	--api-key=gw_agent_xxx	ゲートウェイ経由で呼び出しをルーティングします。エージェントごとの予算適用、レスポンスのキャッシュ、エージェント間の重複排除に対応します。ウォレットもオンチェーン決済も不要です。
x402（自己管理）	--private-key=0x... --rpc-url=... --usdc-address=...	エージェント自身が USDC 決済に署名します。API が 402 を返すと、決済がオンチェーンで行われ、レシートを付けてリクエストを再試行します。キーがマシンの外に出ることはありません。

ガバナンスとキャッシュが必要な場合はプロキシモードを選んでください。オンチェーンで呼び出しごとに決済する必要がある場合にのみ、x402 を追加してください。

ツール

ツール	機能
gatewards_discover_services	マーケットプレイスの有料 API サービス（名前、エンドポイント、価格）を一覧表示します。
gatewards_call_api	GET／POST 呼び出しを行います。ステータス、データ、決済が行われた場合は費用を返します。
gatewards_check_budget	現在の日次支出、残りの予算、有効なサブスクリプションを表示します。
gatewards_get_plans	サービスのプリペイドクレジットプランを一覧表示します。
gatewards_subscribe	サービスのクレジットバンドルを購入します（プロキシモードのみ）。

設定

フラグまたは環境変数を指定できます（フラグが優先されます）。

フラグ	環境変数	デフォルト	備考
--gateway	GATEWARDS_GATEWAY_URL	http://localhost:3001	ゲートウェイのベース URL です。
--api-key	GATEWARDS_API_KEY	—	エージェントキーです。プロキシモードが有効になります。
--private-key	GATEWARDS_PRIVATE_KEY	—	x402 モード用の 0x プレフィックス付きキーです。どこにも送信されません。
--rpc-url	GATEWARDS_RPC_URL	—	x402 モードで必須です。
--usdc-address	GATEWARDS_USDC_ADDRESS	—	x402 モードで必須です。
--network	GATEWARDS_NETWORK	base-sepolia	例：base、base-sepolia。
--merchant	GATEWARDS_MERCHANT_URL	—	絶対 URL をこのオリジンに制限します。

--api-key または --private-key のいずれかが必要です。

ライセンス

Apache-2.0