P402

io.github.Z333Q由 GitHub 账号 Z333Q 发布v1.0.0更新于 Nov 10, 2026

Multi-provider AI router with x402 micropayment settlement on Base L2. 1% flat fee.

已验证STDIO仅桌面金融AI 与机器学习

概览

AI 生成的概览

P402 是一个本地 MCP 服务器,让助手在 300 多个大模型供应商之间路由请求,并通过 Base 上的 x402 以 USDC 按次结算。

可以做什么
  • 通过一个兼容 OpenAI 的端点发送对话请求,按成本、质量、速度或均衡模式选择供应商
  • 创建并查看会话预算,为自主代理设定消费上限
  • 经 x402 facilitator 在链上按次结算,在 Base 上使用免 gas 的 USDC 转账
  • 通过 A2A JSON-RPC 协议与其他代理交换结构化任务
  • 查看实时花费分析与成本优化建议
适用场景
当你希望助手用一个密钥调用多家大模型供应商、把请求导向更便宜或更快的模型,或为自主代理设定硬性消费上限并进行链上结算时,适合使用。
运行要求
以 stdio 在本地运行,通常通过 npx 启动 @p402/mcp-server 包,因此需要 Node.js。需要 P402 账户,并通过 P402_API_KEY 环境变量提供 API 密钥。需要能访问 P402 路由器的网络;可用 P402_ROUTER_URL 覆盖基础地址。VS Code 扩展也内置了同一服务器。
安装前请注意
请求会产生费用:收取 1% 固定手续费,且每次调用都在 Base 上以 USDC 结算,会动用真实资金。API 密钥是有效凭证,应避免写入共享配置。会话预算是防止代理失控消费的主要手段,让代理无人值守运行前应先设定。提示词与回复会经过 P402 路由器及第三方模型供应商。

安装

在 SourceWeft 中

  1. 打开 控制台中的 P402,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

P402 Protocol

[npm @p402/sdk] [npm @p402/cli] [npm @p402/mcp-server] [npm @p402/mpp-method] [VS Code Marketplace] [License: MIT] [Docs]

AI payment router. Route across 300+ models, settle per request in USDC on Base or USDC.e on Tempo.

P402 sits between your AI application and every LLM provider. It handles intelligent multi-provider routing (cost / quality / speed / balanced), on-chain micropayment settlement via the x402 protocol and mppx on Base and Tempo, and spending guardrails for autonomous agents.


Why P402

ProblemP402 Solution
Hardcoded to one AI providerRoute across 300+ models automatically
$0.30 payment fees kill micropaymentsUSDC on Base: fractions of a cent per settlement
No spending limits for AI agentsSession budgets + AP2 mandate governance
Fragmented provider APIsOne OpenAI-compatible endpoint
No visibility into AI costsReal-time analytics + optimization suggestions

Quick Start (VS Code / Cursor / Windsurf)

Install the extension — the MCP server is embedded, tools appear in Copilot agent mode immediately, no config files required:

ext install p402-protocol.p402

Then run P402: Configure API Key from the command palette.

→ VS Code Marketplace · Open VSX


Quick Start (Claude Desktop / any MCP client)

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

→ MCP docs · MCP Registry


Quick Start (SDK)

bash
npm install @p402/sdk
typescript
import P402Client from '@p402/sdk';
const p402 = new P402Client({ apiKey: process.env.P402_API_KEY });
// Drop-in OpenAI replacement — P402 picks the best providerconst 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 }

Quick Start (CLI)

bash
# Authenticate oncenpx p402 login
# Chat using the cheapest providernpx p402 chat "What is x402?" --mode cost
# Check facilitator healthnpx p402 health

Routing Modes

ModeOptimizes ForTypical Provider
costLowest priceDeepSeek V3, Haiku 4.5, GPT-4o-mini
qualityBest outputClaude Opus 4.6, GPT-5, Gemini 3 Pro
speedLowest latencyGroq LPU, Flash models
balancedEqual weight (default)Sonnet 4.6, GPT-4o, Gemini Flash

Session Budgets

Enforce hard spending caps for autonomous agents:

typescript
// Create a $10 session — agent cannot spend a cent moreconst session = await p402.createSession({ budget_usd: 10 });
// All chat requests are deducted from the sessionconst response = await p402.chat({  messages,  p402: { session_id: session.id, mode: 'cost' }});
// Check remaining budgetconst { budget } = await p402.getSession(session.id);console.log(`$${budget.remaining_usd} remaining`);

x402 Payments

x402 is a machine-native payment protocol using HTTP 402. AI agents pay for resources using gasless EIP-3009 USDC transfers on Base L2.

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

Network: Base Mainnet (Chain ID: 8453) · Asset: USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

→ x402 payments guide


A2A Protocol

P402 implements the Google A2A spec over JSON-RPC 2.0. Agents communicate through structured tasks, discover capabilities via /.well-known/agent.json, and settle payments via the x402 extension.

typescript
// Discover P402's capabilitiesGET https://p402.io/.well-known/agent.json
// Submit a taskPOST https://p402.io/api/a2a{ "jsonrpc": "2.0", "method": "tasks/send", "params": { ... } }

→ A2A protocol guide


Packages

PackageDescriptionVersion
@p402/sdkTypeScript SDK — P402Client, types, EIP-712 mandate helpers[npm]
@p402/cliCLI tool — login, chat, sessions, mandates, analytics[npm]
@p402/mcp-serverstdio MCP server — 6 tools over Model Context Protocol[npm]
@p402/mpp-methodmppx payment methods — Base EIP-3009 and Tempo TIP-20 multi-rail settlement[npm]
p402 VS Code extensionEmbedded MCP server for VS Code, Cursor, and Windsurf — zero config[Marketplace]

Examples

ExampleWhat It Shows
01-quickstartLogin → chat → view spend in ~20 lines
02-openai-migrationDrop-in OpenAI SDK replacement
03-nextjs-session-budgetBudget-capped AI in a Next.js App Router project
04-a2a-agentsTwo agents communicating with x402 payment gate

Docs

Guide
Getting StartedAccount, API key, first request
AuthenticationAPI keys, env vars, security
Routing GuideModes, scoring, providers, models
x402 PaymentsEIP-3009, wire format, settlement
SessionsSession lifecycle + budget enforcement
A2A ProtocolJSON-RPC, mandates, Bazaar
CLI ReferenceFull CLI command reference
OpenAPI SpecMachine-readable API schema

Community


License

MIT © P402 Protocol

来源:README.md,提交 94c8cc9

工具

0
SourceWeft 尚未在沙箱中启动过该软件包,因此其工具未知。

版本历史

1
  1. v1.0.0最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手;SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分