@p402/mcp Server

P402 Protocol

AI 支付路由器。 在 300 多种模型之间路由，并在 Base 上以 USDC 或在 Tempo 上以 USDC.e 按请求结算。

P402 位于你的 AI 应用与各个大模型提供商之间。它负责智能多提供商路由（成本 / 质量 / 速度 / 均衡）、通过 x402 protocol 和 mppx 在 Base 和 Tempo 上进行链上微支付结算，以及为自主 Agent 设置支出防护。

---

为什么选择 P402

问题	P402 解决方案
被硬编码为单一 AI 提供商	自动在 300 多种模型之间路由
$0.30 的支付手续费让微支付难以为继	Base 上的 USDC：每次结算手续费不到一美分
AI Agent 没有支出限额	会话预算 + AP2 授权治理
提供商 API 各不相同	一个兼容 OpenAI 的端点
无法了解 AI 成本	实时分析 + 优化建议

---

快速开始（VS Code / Cursor / Windsurf）

安装扩展——MCP 服务已内置，工具会立即显示在 Copilot Agent 模式中，无需配置文件：

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

---

会话预算

为自主 Agent 强制设置支出上限：

// 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 Agent 使用 Base L2 上免 Gas 的 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 主网（链 ID：8453） · 资产：USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

→ x402 支付指南

---

A2A 协议

P402 通过 JSON-RPC 2.0 实现了 Google A2A 规范。Agent 通过结构化任务进行通信，通过 /.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	两个 Agent 通过 x402 支付门控进行通信

---

文档

指南
入门指南	账户、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