ext install p402-protocol.p402

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

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 }

# Authenticate once
npx p402 login

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

# Check facilitator health
npx p402 health

// 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`);

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 }

// 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": { ... } }