x402 Payments & Pricing

Yield.xyz MCP supports x402, an open protocol for AI-native, per-call payments. Most tools are free to call within generous limits; a small set of wallet-specific tools require a micro-payment once the free tier is used up. x402 is live on Base and X Layer.

You don't need x402 to get started — bring your own API key and all metering is bypassed (see Bring Your Own Key below).

Two tiers

Tier	Tools	Free allowance
Paid	`actions_enter`, `actions_exit`, `actions_manage`, `yields_get_balances`	30 free calls per tool, per wallet, rolling 24h
Freemium	All discovery/read tools (`yields_get_all,` `yields_get`, `yields_get_risk`, `networks_get_all`, `providers_get_all`, `get_transaction`, etc.)	1,000 free calls per wallet, rolling 24h (effectively free)

Pricing beyond the free tier

Field	Value
Price per call	`$0.001`
Payment asset (Base)	USDC
Payment assets (X Layer)	USDC, USDT0, USDG
Networks	Base and X Layer

Bring your own key (bypass)

Sending your Yield.xyz API key as an x-api-key header on the MCP path bypasses x402 metering entirely — no free-tier limits, no payments.

Example (Claude Code):

claude mcp add --transport http yield-agentkit https://mcp.yield.xyz/mcp \
  --header "x-api-key: YOUR_API_KEY"

Don't have an API key yet? Register at the Yield.xyz dashboard to create an account and get your key.

Wire format

http-x402 — standard HTTP 402 response plus a PAYMENT-SIGNATURE header (used on the REST endpoints under https://mcp.yield.xyz/x402/*).

Discovery

Agents can auto-discover pricing, tiers, and supported chains from the manifest at:

https://mcp.yield.xyz/.well-known/x402

Listings

The Yield.xyz MCP server is listed on: