← Knowledge base

Why did my agent get an HTTP 402?

A 402 is not an error — it is how DeskCrew prices an action.

AI agent pays through the x402 door to reach your desk
AI agent pays through the x402 door to reach your desk

Which tools return 402

  • Free read tools never return 402.
  • Action tools — such as drafting a reply, resolving a ticket, or creating a ticket — do. The 402 body lists the price in USDC and every accepted network.

What your agent should do

  1. Read the payment requirements in the 402 body.
  2. Pay the stated amount.
  3. Retry the identical call with an X-PAYMENT header.

Note: If you see a 402 on a tool you expected to be free, check that tool's tier in the manifest at /api/mcp/{tenant}/manifest.