Paying for MCP tools with USDC as a developer
On this page
A developer pays for an MCP tool in USDC when the gateway asks for payment. The server returns HTTP 402 Payment Required with the price. The client signs a stablecoin transfer and retries the request with proof of payment. Listed tool prices range from 0 to 29.99 USD.
What USDC does in a paid MCP tool call
USDC is a stablecoin pegged to the US dollar. Circle issues it, as described at https://www.circle.com/usdc. A developer uses USDC when a tool should bill per call without a card form.
The payment happens inside the HTTP exchange. The agent does not paste a card number into a settings page. The client holds a wallet, reads the quote, and pays for the single call it makes.
This model suits agents. An agent runs many short calls, and each call carries its own price. A funded wallet covers those calls from one balance.
Set up the wallet before the first paid call
Start with a wallet that holds USDC on a network the gateway accepts. Check the tool listing for the accepted network before you send any funds. Fund the wallet with a small amount first.
- Create a dedicated wallet for agent spending.
- Keep a small USDC balance for test calls.
- Confirm the accepted network matches the wallet network.
Keep the signing key out of the repository. Load it from an environment variable or a secret manager at runtime.
How the 402 handshake works
The client and server exchange a short sequence of messages. Each step has one job. The sequence runs the same way for every paid tool.
- The agent sends the normal tool request.
- The server returns HTTP 402 Payment Required with the price and payment terms.
- The client signs a USDC transfer for that price.
- The client retries the request and attaches the payment proof.
- The server runs the tool and returns the result.
HTTP status 402 is a reserved code in the HTTP specification. Most web traffic never triggers it. The x402 pattern uses that code to request a machine payment before a server does work.
Read the price and payment terms from the 402 response before signing. Reject the request if the terms differ from the listing in a way the agent did not expect.
Set a price ceiling in the agent
An agent should read every quote before it signs. Set a maximum amount in the agent configuration. Reject any quote above that amount and log the rejection.
Log each quote with the tool name, the amount, and the timestamp. The log shows which tool spent how much. It also shows when a price moved between calls.
Listed prices run from 0 to 29.99 USD. The quote in the response sets the amount for that call. Treat the listing as a guide, not a guarantee.
Test with small calls before automation
Run the first calls by hand. Pick a tool with a low listed price. Confirm each stage of the flow: the 402 response, the signed retry, and the final result.
Then move the same flow into the agent loop. Keep the price ceiling in place during tests. Remove the manual step only after the logs match the expected sequence.
Test failure paths as well. Use a wallet with an empty balance and confirm that the tool call does not run.
Limits of USDC billing for developers
USDC billing carries limits that card billing does not. Plan for them before the agent goes into production.
- The wallet balance must cover the quoted amount plus any network fee.
- A failed or rejected payment leaves the tool call unexecuted.
- USDC tracks the dollar under normal conditions, but no gateway can guarantee the peg.
Card billing needs a card form and a billing contact. USDC billing needs a funded wallet and a signing key. Pick the model that matches the team's controls and its audit needs.
Which tools fit USDC billing
Small, frequent calls fit USDC billing best. Search, data lookup, and format conversion tools match that pattern. Each call returns a result quickly, so the payment step adds little delay.
Heavier jobs with long run times need a clear quote before work starts. A tool that quotes before the call gives the agent a clear decision point. An agent without that point cannot judge the cost of the work it started.
Check each listing for its quote method. If the listing shows no quote method, test the tool with a small amount first.
Keep the payment key safe
Treat the signing key as a payment instrument. Anyone with the key can spend the wallet balance.
- Use a separate wallet for agent spending.
- Cap the balance at the amount the agent needs for one day.
- Rotate the key when a developer leaves the project.
Store logs that show each signed payment. Review the logs on a fixed schedule. A short review catches a runaway loop before it drains the balance.
Live pricing — developer
Data source: live tool catalog snapshot, fetched 2026-11-13.
Chart data as a table
| Tool | Price per call | Cache-hit price |
|---|---|---|
| Usage Time Series | $0.0 | $0.0 |
| Per-Tool Usage Breakdown | $0.0 | $0.0 |
| Usage Summary | $0.0 | $0.0 |
| Discover Tools | $0.0 | $0.0 |
| Batch Tool Calls | $0.0 | $0.0 |
| Tool Quality Metrics | $0.0 | $0.0 |
| Tool Quality Rankings | $0.0 | $0.0 |
| List Programming Languages | $0.001 | $0.0001 |
| Check CVE ID Reservation Status | $0.001 | $0.0001 |
| Security Advisories (deps.dev) | $0.001 | $0.0001 |
| Dependency Tree (deps.dev) | $0.001 | $0.0001 |
| Package Info (deps.dev) | $0.001 | $0.0001 |
| Tool | Provider | Price/call | Cache-hit |
|---|---|---|---|
| Usage Time Series | account | $0 | $0 |
| Per-Tool Usage Breakdown | account | $0 | $0 |
| Usage Summary | account | $0 | $0 |
| Discover Tools | apibase | $0 | $0 |
| Batch Tool Calls | platform | $0 | $0 |
| Tool Quality Metrics | platform | $0 | $0 |
| Tool Quality Rankings | platform | $0 | $0 |
| List Programming Languages | judge0 | $0.001 | $0.0001 |
| Check CVE ID Reservation Status | cve-mitre | $0.001 | $0.0001 |
| Security Advisories (deps.dev) | depsdev | $0.001 | $0.0001 |
| Dependency Tree (deps.dev) | depsdev | $0.001 | $0.0001 |
| Package Info (deps.dev) | depsdev | $0.001 | $0.0001 |
Connect via MCP
Data source: gateway design, no measured values.
$ curl -X POST https://apibase.pro/api/v1/tools/account.timeseries/call \
-H "Content-Type: application/json" -d '{"params": {}}'FAQ
Can an agent pay for an MCP tool in USDC?
Yes. The agent signs a USDC payment when the tool returns HTTP 402 Payment Required, then retries the request with proof of payment.
What does DC mean in this keyword?
This guide reads DC as the developer side of USDC billing: wallet setup, funding, and paid tool calls. It does not cover Washington, DC or data center topics.
What does a paid call cost?
Listed prices run from 0 to 29.99 USD. The quote in the 402 response sets the amount for each call.
Is USDC a stablecoin?
Yes. USDC is a stablecoin pegged to the US dollar and issued by Circle, as described at https://www.circle.com/usdc.
Does the wallet need a second token for fees?
Some networks charge a fee in their native token. Check the rules of the accepted network before funding the wallet, and keep a small balance of that token for fees.
Recommended next step
- STEP 1/2 Connect your MCP client
- STEP 2/2 Browse the full catalog
Related guides
Written with AI assistance from APIbase's published documentation and public data; checked automatically against them. Corrections: https://apibase.pro/
Published: 2026-11-13Source: live apibase.pro catalog snapshot