Yield.xyz AgentKit (MCP + x402)

Overview

Yield.xyz launched AgentKit on x402 on 2026-07-30. It exposes its yield API as one MCP server that agents can call without an API key, paying in USDC on Base through the CDP facilitator (CoinbaseDev on X). The live manifest at mcp.yield.xyz/.well-known/x402 lists tools including yields_get, yields_get_risk, actions_enter, actions_exit and actions_manage. The docs describe it as an API for non-custodial staking, restaking, liquid staking, lending, RWA yields and vaults across 70-80+ networks. Execution stays non-custodial: the API returns actions and the agent signs them.

Tool inventory — 22 tools, probed live 2026-09-23

• yields_get_all — Discover yield opportunities across all supported networks and protocols. Use this to find yield IDs before calling yields_get, actions_enter, or any balance/validator tools. Filter by network, token
• yields_get — Get full metadata for a single yield opportunity: fees, lock-up and cooldown periods, reward mechanics, and whether entry/exit is currently open. Show this to the user before they commit to entering a
• yields_get_validators — List validators for delegation-based yields such as Cosmos native staking or ETH native staking. Use the validator address when calling actions_enter or actions_exit. Filter by preferred=true to show
• yields_get_balances — Get current balances and pending actions for a wallet address across one or more yields. Always call this before actions_exit or actions_manage — the passthrough value required by those tools comes fr
• actions_enter — Construct unsigned transactions to stake or deposit into a yield. Does NOT execute — the user must sign each transaction exactly as returned (never modify unsignedTransaction). Amounts are human-reada
• actions_exit — Construct unsigned transactions to unstake or withdraw from a yield. Does NOT execute — the user must sign each transaction exactly as returned (never modify unsignedTransaction). Amounts are human-re
• actions_manage — Construct unsigned transactions for a pending action such as claiming rewards, restaking, or unlocking funds. Does NOT execute — the user must sign. The action type and passthrough must come from yiel
• submit_hash — Submit the on-chain transaction hash after the user has signed and broadcasted a transaction. This updates the transaction status internally and enables tracking. Call this once per transaction, using
• get_transaction — Poll the status of a single transaction by its ID. Use after submit_hash to confirm on-chain success. status is one of: NOT_FOUND, CREATED, BLOCKED, WAITING_FOR_SIGNATURE, SIGNED, BROADCASTED, PENDING
• actions_get — Get the current status and transactions of a specific action by its ID. Use this to check whether an action is CREATED, PROCESSING, SUCCESS, or FAILED. Essential for async execution patterns and semi-
• actions_get_all — List past and pending actions for a wallet address. Filter by status, intent, type, or yieldId. Use this to answer "show me my pending actions", "what did I do recently?", or to find actions waiting f
• networks_get_all — Discover all supported networks with their IDs, names, and categories. Use this to get valid network slugs before calling yields_get_all, yields_get_balances, or any other tool that requires a network
• yields_get_reward_rate_history — Get historical APY/reward rate snapshots for a yield over time. Use this to answer "has this yield's APY been stable?" or to chart APY trends. Defaults to last 30 days, daily interval.
• yields_get_tvl_history — Get historical Total Value Locked snapshots for a yield. Use this to assess protocol health — a declining TVL is a warning sign. Defaults to last 30 days, daily interval.
• yields_get_risk — Get detailed risk parameters for a yield. More granular than the risk field in yields_get — returns individual risk items by category (e.g. smart contract, liquidity, counterparty). Use this when the
• providers_get_all — Discover all supported protocols and validator providers (e.g. Lido, Aave, Morpho). Returns name, id, description, website, TVL, and type. Use this to answer "what protocols does Yield.xyz support?" o
• yields_get_kyc_status — Get the normalized KYC status of a wallet address for a yield. Use this before actions_enter on yields that gate deposits behind KYC (e.g. RWAs like Securitize/Superstate). Yields without a KYC requir
• yield_get_api_spec — 🔧 BUILDER TOOL — fetches the live Yield.xyz OpenAPI spec (https://api.yield.xyz/docs.json). Use when you need: exact request body schemas, field constraints (min/max/enum), error response shapes, or
• yield_lookup_docs — 🔧 BUILDER TOOL — use when developing an integration, NOT for end-user actions or live data. Searches the live Yield.xyz documentation index (llms.txt) in real time and returns the most relevant page
• yield_fetch_doc — 🔧 BUILDER TOOL — fetches the full markdown content of any Yield.xyz documentation page. Use after yield_lookup_docs returns a URL. Returns authoritative spec with exact field names, types, and exampl
• yield_troubleshoot_error — Diagnoses API errors, HTTP status codes, or unexpected responses from the Yield.xyz API. Use when developer says: "I'm getting a 422", "400 error", "rate limited", "transaction failed", "FAILED status
• yield_list_repos — 🔧 BUILDER TOOL — public Yield.xyz GitHub repos to use as a code reference for integrations. Use this when you are stuck on an integration and the other docs tools (yield_lookup_docs, yield_fetch_doc,

Answers a handshake

yes · 2026-09-23

Answers a call

not asked — no read-named tool takes zero arguments and declares none that touch keys, addresses or amounts

Live probe verifies the interface responds — not what the tools do, their safety, or their output quality. The call is one read-only tool named by this server's own list (list_/get_/search_, no mutating verb anywhere in the name, no required arguments and none that look like a key, an address or an amount), asked once a day with no arguments. Not asked is not a failure.

Where Yield.xyz AgentKit (MCP + x402) fits

Related concepts: How Agents Interact With Smart Contracts, How Agents Use Wallets, What Are Onchain Agents?