@p402/mcp Server

P402 Protocol

AI 決済ルーター。 300 以上のモデルをルーティングし、リクエストごとに Base 上の USDC または Tempo 上の USDC.e で決済します。

P402 は、AI アプリケーションとあらゆる LLM プロバイダーの間に位置します。インテリジェントなマルチプロバイダーのルーティング（コスト／品質／速度／バランス）、Base および Tempo 上の x402 protocol と mppx を介したオンチェーンの少額決済、そして自律型エージェント向けの支出制限を処理します。

---

P402 を選ぶ理由

問題	P402 の解決策
1 つの AI プロバイダーにハードコードされている	300 以上のモデルに自動でルーティング
0.30 ドルの決済手数料が少額決済の妨げになる	Base 上の USDC：決済あたり 1 セント未満
AI エージェントに支出上限がない	セッション予算＋AP2 による指示書ガバナンス
プロバイダー API が分断されている	OpenAI 互換の単一エンドポイント
AI コストを把握できない	リアルタイム分析＋最適化の提案

---

クイックスタート（VS Code / Cursor / Windsurf）

拡張機能をインストールすると、MCP サーバーが組み込まれ、Copilot のエージェントモードにツールがすぐに表示されます。設定ファイルは不要です。

ext install p402-protocol.p402

次に、コマンドパレットから P402: Configure API Key を実行します。

→ VS Code Marketplace · Open VSX

---

クイックスタート（Claude Desktop / あらゆる MCP クライアント）

{
  "mcpServers": {
    "p402": {
      "command": "npx",
      "args": ["-y", "@p402/mcp-server"],
      "env": { "P402_API_KEY": "p402_live_..." }
    }
  }
}

→ MCP ドキュメント · MCP Registry

---

クイックスタート（SDK）

npm install @p402/sdk

import P402Client from '@p402/sdk';

const p402 = new P402Client({ apiKey: process.env.P402_API_KEY });

// Drop-in OpenAI replacement — P402 picks the best provider
const response = await p402.chat({
  messages: [{ role: 'user', content: 'Explain x402 payments in one sentence.' }],
  p402: { mode: 'cost' }   // cost | quality | speed | balanced
});

console.log(response.choices[0].message.content);
// p402_metadata: { provider: 'deepseek', cost_usd: 0.00031, latency_ms: 412 }

---

クイックスタート（CLI）

# Authenticate once
npx p402 login

# Chat using the cheapest provider
npx p402 chat "What is x402?" --mode cost

# Check facilitator health
npx p402 health

---

ルーティングモード

モード	最適化対象	一般的なプロバイダー
cost	最低価格	DeepSeek V3、Haiku 4.5、GPT-4o-mini
quality	最高品質の出力	Claude Opus 4.6、GPT-5、Gemini 3 Pro
speed	最低レイテンシ	Groq LPU、Flash モデル
balanced	均等な重み付け（デフォルト）	Sonnet 4.6、GPT-4o、Gemini Flash

---

セッション予算

自律型エージェントに厳格な支出上限を設定します。

// Create a $10 session — agent cannot spend a cent more
const session = await p402.createSession({ budget_usd: 10 });

// All chat requests are deducted from the session
const response = await p402.chat({
  messages,
  p402: { session_id: session.id, mode: 'cost' }
});

// Check remaining budget
const { budget } = await p402.getSession(session.id);
console.log(`$${budget.remaining_usd} remaining`);

---

x402 決済

x402 は HTTP 402 を使用する、マシンネイティブな決済プロトコルです。AI エージェントは Base L2 上で、ガス代不要の EIP-3009 USDC 送金を利用してリソースの料金を支払います。

Client → signs EIP-3009 authorization
       → POST /api/v1/facilitator/verify
       → POST /api/v1/facilitator/settle
Facilitator → executes transferWithAuthorization
            → pays gas (user pays zero gas)
            → returns { success, txHash, receipt }

ネットワーク：Base Mainnet（Chain ID：8453） · 資産：USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

→ x402 決済ガイド

---

A2A プロトコル

P402 は JSON-RPC 2.0 上で Google A2A spec を実装しています。エージェントは構造化されたタスクを通じて通信し、/.well-known/agent.json で機能を検出し、x402 拡張機能を介して決済します。

// Discover P402's capabilities
GET https://p402.io/.well-known/agent.json

// Submit a task
POST https://p402.io/api/a2a
{ "jsonrpc": "2.0", "method": "tasks/send", "params": { ... } }

→ A2A プロトコルガイド

---

パッケージ

パッケージ	説明	バージョン
@p402/sdk	TypeScript SDK — P402Client、型、EIP-712 マンデートヘルパー
@p402/cli	CLI ツール — ログイン、チャット、セッション、マンデート、分析
@p402/mcp-server	stdio MCP サーバー — Model Context Protocol 経由の 6 つのツール
@p402/mpp-method	mppx 決済方式 — Base EIP-3009 と Tempo TIP-20 によるマルチレール決済
p402 VS Code 拡張機能	VS Code、Cursor、Windsurf 向けの組み込み MCP サーバー — 設定不要

---

サンプル

サンプル	内容
01-quickstart	約 20 行でログイン → チャット → 利用額の確認
02-openai-migration	OpenAI SDK のドロップイン置き換え
03-nextjs-session-budget	Next.js App Router プロジェクトで予算上限を設定した AI
04-a2a-agents	x402 の決済ゲートを介して通信する 2 つのエージェント

---

ドキュメント

ガイド
はじめに	アカウント、API キー、最初のリクエスト
認証	API キー、環境変数、セキュリティ
ルーティングガイド	モード、スコアリング、プロバイダー、モデル
x402 決済	EIP-3009、ワイヤーフォーマット、決済処理
セッション	セッションのライフサイクルと予算の適用
A2A プロトコル	JSON-RPC、マンデート、Bazaar
CLI リファレンス	CLI コマンドの完全なリファレンス
OpenAPI 仕様	機械可読な API スキーマ

---

コミュニティ

• ダッシュボード： p402.io/dashboard
• ドキュメント： p402.io/docs
• 課題： GitHub Issues
• セキュリティ： 責任ある脆弱性開示については SECURITY.md をご覧ください
• 貢献： CONTRIBUTING.md をご覧ください

---

ライセンス

MIT © P402 Protocol