{
  "markdown": "# P402 Protocol\n\n[![npm @p402/sdk](https://img.shields.io/npm/v/@p402/sdk?label=%40p402%2Fsdk&color=B6FF2E)](https://www.npmjs.com/package/@p402/sdk)\n[![npm @p402/cli](https://img.shields.io/npm/v/@p402/cli?label=%40p402%2Fcli&color=B6FF2E)](https://www.npmjs.com/package/@p402/cli)\n[![npm @p402/mcp-server](https://img.shields.io/npm/v/@p402/mcp-server?label=%40p402%2Fmcp-server&color=B6FF2E)](https://www.npmjs.com/package/@p402/mcp-server)\n[![npm @p402/mpp-method](https://img.shields.io/npm/v/@p402/mpp-method?label=%40p402%2Fmpp-method&color=B6FF2E)](https://www.npmjs.com/package/@p402/mpp-method)\n[![VS Code Marketplace](https://img.shields.io/visual-studio-marketplace/v/p402-protocol.p402?label=VS%20Code&color=B6FF2E)](https://marketplace.visualstudio.com/items?itemName=p402-protocol.p402)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)\n[![Docs](https://img.shields.io/badge/docs-p402.io-black)](https://p402.io/docs)\n\n**AI payment router.** Route across 300+ models, settle per request in USDC on Base or USDC.e on Tempo.\n\nP402 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](https://x402.org) and [mppx](https://mpp.dev) on Base and Tempo, and spending guardrails for autonomous agents.\n\n---\n\n## Why P402\n\n| Problem | P402 Solution |\n|---|---|\n| Hardcoded to one AI provider | Route across 300+ models automatically |\n| $0.30 payment fees kill micropayments | USDC on Base: fractions of a cent per settlement |\n| No spending limits for AI agents | Session budgets + AP2 mandate governance |\n| Fragmented provider APIs | One OpenAI-compatible endpoint |\n| No visibility into AI costs | Real-time analytics + optimization suggestions |\n\n---\n\n## Quick Start (VS Code / Cursor / Windsurf)\n\nInstall the extension — the MCP server is embedded, tools appear in Copilot agent mode immediately, no config files required:\n\n```\next install p402-protocol.p402\n```\n\nThen run `P402: Configure API Key` from the command palette.\n\n→ [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=p402-protocol.p402) · [Open VSX](https://open-vsx.org/extension/p402-protocol/p402)\n\n---\n\n## Quick Start (Claude Desktop / any MCP client)\n\n```json\n{\n  \"mcpServers\": {\n    \"p402\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@p402/mcp-server\"],\n      \"env\": { \"P402_API_KEY\": \"p402_live_...\" }\n    }\n  }\n}\n```\n\n→ [MCP docs](https://p402.io/docs/mcp) · [MCP Registry](https://registry.modelcontextprotocol.io)\n\n---\n\n## Quick Start (SDK)\n\n```bash\nnpm install @p402/sdk\n```\n\n```typescript\nimport P402Client from '@p402/sdk';\n\nconst p402 = new P402Client({ apiKey: process.env.P402_API_KEY });\n\n// Drop-in OpenAI replacement — P402 picks the best provider\nconst response = await p402.chat({\n  messages: [{ role: 'user', content: 'Explain x402 payments in one sentence.' }],\n  p402: { mode: 'cost' }   // cost | quality | speed | balanced\n});\n\nconsole.log(response.choices[0].message.content);\n// p402_metadata: { provider: 'deepseek', cost_usd: 0.00031, latency_ms: 412 }\n```\n\n---\n\n## Quick Start (CLI)\n\n```bash\n# Authenticate once\nnpx p402 login\n\n# Chat using the cheapest provider\nnpx p402 chat \"What is x402?\" --mode cost\n\n# Check facilitator health\nnpx p402 health\n```\n\n---\n\n## Routing Modes\n\n| Mode | Optimizes For | Typical Provider |\n|---|---|---|\n| `cost` | Lowest price | DeepSeek V3, Haiku 4.5, GPT-4o-mini |\n| `quality` | Best output | Claude Opus 4.6, GPT-5, Gemini 3 Pro |\n| `speed` | Lowest latency | Groq LPU, Flash models |\n| `balanced` | Equal weight (default) | Sonnet 4.6, GPT-4o, Gemini Flash |\n\n---\n\n## Session Budgets\n\nEnforce hard spending caps for autonomous agents:\n\n```typescript\n// Create a $10 session — agent cannot spend a cent more\nconst session = await p402.createSession({ budget_usd: 10 });\n\n// All chat requests are deducted from the session\nconst response = await p402.chat({\n  messages,\n  p402: { session_id: session.id, mode: 'cost' }\n});\n\n// Check remaining budget\nconst { budget } = await p402.getSession(session.id);\nconsole.log(`$${budget.remaining_usd} remaining`);\n```\n\n---\n\n## x402 Payments\n\nx402 is a machine-native payment protocol using HTTP 402. AI agents pay for resources using gasless EIP-3009 USDC transfers on Base L2.\n\n```\nClient → signs EIP-3009 authorization\n       → POST /api/v1/facilitator/verify\n       → POST /api/v1/facilitator/settle\nFacilitator → executes transferWithAuthorization\n            → pays gas (user pays zero gas)\n            → returns { success, txHash, receipt }\n```\n\nNetwork: **Base Mainnet** (Chain ID: 8453) · Asset: **USDC** `0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913`\n\n→ [x402 payments guide](docs/x402-payments.md)\n\n---\n\n## A2A Protocol\n\nP402 implements the [Google A2A spec](https://github.com/google-a2a) over JSON-RPC 2.0. Agents communicate through structured tasks, discover capabilities via `/.well-known/agent.json`, and settle payments via the x402 extension.\n\n```typescript\n// Discover P402's capabilities\nGET https://p402.io/.well-known/agent.json\n\n// Submit a task\nPOST https://p402.io/api/a2a\n{ \"jsonrpc\": \"2.0\", \"method\": \"tasks/send\", \"params\": { ... } }\n```\n\n→ [A2A protocol guide](docs/a2a-protocol.md)\n\n---\n\n## Packages\n\n| Package | Description | Version |\n|---|---|---|\n| [`@p402/sdk`](packages/sdk/) | TypeScript SDK — P402Client, types, EIP-712 mandate helpers | [![npm](https://img.shields.io/npm/v/@p402/sdk)](https://www.npmjs.com/package/@p402/sdk) |\n| [`@p402/cli`](packages/cli/) | CLI tool — login, chat, sessions, mandates, analytics | [![npm](https://img.shields.io/npm/v/@p402/cli)](https://www.npmjs.com/package/@p402/cli) |\n| [`@p402/mcp-server`](packages/mcp-server/) | stdio MCP server — 6 tools over Model Context Protocol | [![npm](https://img.shields.io/npm/v/@p402/mcp-server)](https://www.npmjs.com/package/@p402/mcp-server) |\n| [`@p402/mpp-method`](packages/mpp-method/) | mppx payment methods — Base EIP-3009 and Tempo TIP-20 multi-rail settlement | [![npm](https://img.shields.io/npm/v/@p402/mpp-method)](https://www.npmjs.com/package/@p402/mpp-method) |\n| [`p402` VS Code extension](packages/vscode/) | Embedded MCP server for VS Code, Cursor, and Windsurf — zero config | [![Marketplace](https://img.shields.io/visual-studio-marketplace/v/p402-protocol.p402)](https://marketplace.visualstudio.com/items?itemName=p402-protocol.p402) |\n\n---\n\n## Examples\n\n| Example | What It Shows |\n|---|---|\n| [01-quickstart](examples/01-quickstart/) | Login → chat → view spend in ~20 lines |\n| [02-openai-migration](examples/02-openai-migration/) | Drop-in OpenAI SDK replacement |\n| [03-nextjs-session-budget](examples/03-nextjs-session-budget/) | Budget-capped AI in a Next.js App Router project |\n| [04-a2a-agents](examples/04-a2a-agents/) | Two agents communicating with x402 payment gate |\n\n---\n\n## Docs\n\n| Guide | |\n|---|---|\n| [Getting Started](docs/getting-started.md) | Account, API key, first request |\n| [Authentication](docs/authentication.md) | API keys, env vars, security |\n| [Routing Guide](docs/routing-guide.md) | Modes, scoring, providers, models |\n| [x402 Payments](docs/x402-payments.md) | EIP-3009, wire format, settlement |\n| [Sessions](docs/sessions.md) | Session lifecycle + budget enforcement |\n| [A2A Protocol](docs/a2a-protocol.md) | JSON-RPC, mandates, Bazaar |\n| [CLI Reference](docs/cli-reference.md) | Full CLI command reference |\n| [OpenAPI Spec](docs/openapi.yaml) | Machine-readable API schema |\n\n---\n\n## Community\n\n- **Dashboard:** [p402.io/dashboard](https://p402.io/dashboard)\n- **Docs:** [p402.io/docs](https://p402.io/docs)\n- **Issues:** [GitHub Issues](https://github.com/Z333Q/p402-protocol/issues)\n- **Security:** See [SECURITY.md](SECURITY.md) for responsible disclosure\n- **Contributing:** See [CONTRIBUTING.md](CONTRIBUTING.md)\n\n---\n\n## License\n\nMIT © [P402 Protocol](https://p402.io)\n",
  "bytes": 7932,
  "sha": "fef315e4270653593b345919899b5463889ad75ba460c684b56659d55efc3842",
  "repo_slug": "z333q/p402-protocol",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_z333q_p402_5b51ad8d/readme"
}