Configure x402

Overview

Configures the x402 HTTP-native payment protocol for agent-to-agent micropayments settled on Base. x402 uses the HTTP 402 "Payment Required" status code to enable pay-per-request billing — agents pay fractions of a cent per API call in USDC, with ~200ms settlement, no API keys, no accounts, and no subscriptions.

This skill supports two modes:

• Pay mode: Configure your agent to pay for MCP tool calls and external API access via x402
• Accept mode: Configure your agent as an x402 service provider that accepts micropayments for its services
• Both: Enable bidirectional x402 payments

x402 has processed 100M+ agent-to-agent transactions across 80+ ecosystem projects (Feb 2026). It eliminates API key onboarding friction and creates revenue streams from every agent interaction.

When to Use

Activate when the user says:

• "Set up x402 payments for my agent"
• "Enable pay-per-swap via x402"
• "Configure my agent to accept x402 payments"
• "Set up micropayments on Base"
• "Enable x402 for my MCP server"
• "Monetize my agent's API"
• "Configure pay-per-request billing"
• "Set up agent-to-agent payments"

Parameters

Recommended Pricing (Accept Mode)

Workflow

1. Parse configuration from the user's request. Determine the payment mode, wallet address, chain, pricing, and tool scope. Validate the wallet address format.

1. Validate wallet: Verify the wallet address exists on the target chain and has a USDC balance (for pay mode) or can receive USDC (for accept mode). Check that the chain supports x402 settlement.

1. Write x402 configuration: Generate the x402 configuration file at .uniswap/x402-config.json with:
• Payment mode (pay/accept/both)
• Wallet address and chain
• Facilitator endpoint
• Per-tool pricing (accept mode)
• Spending limits (pay mode)
• Supported tools list

For accept mode, also generate the .well-known/x402-manifest.json that advertises the agent's x402-enabled endpoints to other agents.

1. Verify setup: Confirm the configuration is valid by checking:
• Wallet connectivity on the settlement chain
• Facilitator availability
• USDC token approval for the facilitator contract (if pay mode)
• Configuration file is properly formatted

Output Format

x402 Configuration Complete

  Mode:         Both (pay + accept)
  Chain:        Base (8453)
  Wallet:       0x1234...abcd
  Facilitator:  Auto-selected (Coinbase x402)

  Pay Mode:
    Max Spend:  $1.00/hour
    USDC Balance: $50.00 (sufficient)

  Accept Mode:
    Pricing:
      Price quotes:       $0.001/call
      Pool analytics:     $0.003/call
      Route optimization: $0.005/call
      Simulation:         $0.010/call
      Execution:          $0.050/call
    Tools Gated:  All (17 tools)

  Config Files:
    .uniswap/x402-config.json
    .well-known/x402-manifest.json

  Status: Ready for x402 payments

Important Notes

• x402 settles on Base by default (~200ms). Ethereum mainnet settlement is possible but slower and more expensive.
• USDC is the only supported payment token for x402. The wallet must hold USDC on the settlement chain.
• The maxSpendPerHour safety limit prevents runaway costs in pay mode. Adjust based on expected usage.
• x402 uses the HTTP 402 "Payment Required" status code. When a client hits an x402-gated endpoint without payment, it receives a 402 response with payment instructions.
• Facilitators handle the payment settlement. The "auto" option selects the best available facilitator on the target chain.
• For accept mode, the .well-known/x402-manifest.json file makes your agent discoverable on Coinbase Bazaar (12,365+ services).
• x402 payments are per-request. There are no subscriptions, API keys, or accounts. Each request includes a micropayment.
• All x402 transactions are logged for treasury management and can be tracked via the manage-treasury skill.
• This skill does not execute any on-chain transactions. It only generates configuration files. The actual x402 payment flow happens at runtime when the MCP server processes requests.

Error Handling