{ "live": { "slug": "yield-xyz-mcp", "probe": { "target": "https://mcp.yield.xyz/mcp", "method": "mcp-initialize", "lastAt": "2026-11-09T02:11:39.146232408Z", "lastOk": true, "lastStatus": 200, "lastMs": 92, "lastNote": "initialize answered", "authRequired": false, "uptime24h": 100, "uptime30d": 100, "p50ms24h": 82, "p95ms24h": 139, "samples24h": 244, "samples30d": 319, "days": [ { "date": "2026-11-07", "probes": 53, "ok": 53 }, { "date": "2026-11-08", "probes": 243, "ok": 243 }, { "date": "2026-11-09", "probes": 23, "ok": 23 } ], "since": "2026-11-07T00:00:00Z" }, "vendorStatus": { "page": "https://status.yield.xyz", "indicator": "unknown", "summary": "no machine-readable status found", "checkedAt": "2026-11-08T17:50:40.925967204Z" }, "securityTxt": { "url": "https://yield.xyz/.well-known/security.txt", "state": "none", "checkedAt": "2026-11-08T16:03:13.895453212Z" }, "llmsTxt": { "url": "https://docs.yield.xyz/llms.txt", "ok": true, "status": 200, "checkedAt": "2026-11-08T15:37:54.414483046Z" }, "domain": { "domain": "yield.xyz", "registered": "2014-07-05", "source": "https://rdap.centralnic.com/xyz/domain/yield.xyz", "checkedAt": "2026-11-08T15:05:41.031749261Z" }, "pages": [ { "url": "https://docs.yield.xyz/changelog", "kind": "changelog", "status": 200, "checkedAt": "2026-11-08T15:00:02.094916367Z", "changedAt": "0001-01-01T00:00:00Z", "fingerprint": "693fc7871e57" }, { "url": "https://docs.yield.xyz/legal/privacy-policy", "kind": "privacy", "status": 200, "checkedAt": "2026-11-08T15:00:04.704025777Z", "changedAt": "0001-01-01T00:00:00Z", "fingerprint": "ce9eaa612e8f" }, { "url": "https://docs.yield.xyz/legal/terms-of-service", "kind": "terms", "status": 200, "checkedAt": "2026-11-08T15:00:06.342376145Z", "changedAt": "0001-01-01T00:00:00Z", "fingerprint": "872a2ed66604" } ], "mcpTools": { "url": "https://mcp.yield.xyz/mcp", "checkedAt": "2026-11-08T02:03:17.109840195Z", "status": "ok", "protocol": "2025-11-25", "tools": [ { "name": "yields_get_all", "title": "List Yield Opportunities", "description": "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 symbol, or type to narrow results. For RWA yields (types [\"real_world_asset\"]) each item also includes a full kyc object (eligibility, investor tiers, jurisdictions, authorizeUrl) — read it directly instead of calling yields_get per yield.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "hasCooldownPeriod": { "description": "Filter by whether the yield has a cooldown period.", "type": "boolean" }, "hasWarmupPeriod": { "description": "Filter by whether the yield has a warmup period.", "type": "boolean" }, "inputTokens": { "description": "Filter by one or more accepted deposit token symbols or addresses e.g. [\"USDC\"] or [\"USDC\", \"ETH\"]. Yields matching any of the tokens are returned.", "items": { "type": "string" }, "type": "array" }, "limit": { "default": 20, "description": "Max results per page (1-50, default 20).", "maximum": 50, "minimum": 1, "type": "integer" }, "networks": { "description": "Filter by one or more networks e.g. [\"base\", \"arbitrum\"] or [\"ethereum\"]. Use a single-element array for one network. Never make multiple calls per network — pass all networks in one array.", "items": { "type": "string" }, "type": "array" }, "offset": { "default": 0, "description": "Pagination offset. Increment by limit to fetch the next page.", "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "providers": { "description": "Filter by one or more provider IDs e.g. [\"lido\", \"aave\"].", "items": { "type": "string" }, "type": "array" }, "search": { "description": "Free-text search across yield names, token names, provider names, and metadata descriptions.", "type": "string" }, "sort": { "description": "Server-side sort order. Results are returned pre-sorted by the server, do not re-sort client-side.", "enum": [ "statusEnterAsc", "statusEnterDesc", "statusExitAsc", "statusExitDesc", "rewardRateAsc", "rewardRateDesc" ], "type": "string" }, "token": { "description": "Token symbol e.g. \"ETH\", \"USDC\" or a contract address, to filter by output/reward token.", "type": "string" }, "types": { "description": "Filter by one or more yield types e.g. [\"staking\", \"lending\"]. Values: staking, fixed_yield, lending, restaking, vault, concentrated_liquidity_pool, liquidity_pool, real_world_asset.", "items": { "enum": [ "staking", "lending", "restaking", "vault", "concentrated_liquidity_pool", "liquidity_pool", "real_world_asset", "fixed_yield" ], "type": "string" }, "type": "array" }, "yieldIds": { "description": "Batch fetch up to 100 specific yields by ID.", "items": { "type": "string" }, "maxItems": 100, "type": "array" } }, "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": true, "readOnlyHint": true } }, { "name": "yields_get", "title": "Get Yield Metadata", "description": "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 position.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "yieldId": { "description": "Yield ID e.g. \"ethereum-eth-lido-staking\"", "type": "string" } }, "required": [ "yieldId" ], "type": "object" }, "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "chainId": { "type": "string" }, "curator": { "additionalProperties": {}, "properties": { "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "logoURI": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "type": "object" }, "id": { "type": "string" }, "inputTokens": { "items": { "additionalProperties": {}, "properties": { "address": { "type": "string" }, "coinGeckoId": { "type": "string" }, "decimals": { "type": "number" }, "isPoints": { "type": "boolean" }, "logoURI": { "type": "string" }, "name": { "type": "string" }, "network": { "type": "string" }, "symbol": { "type": "string" } }, "required": [ "symbol", "name", "decimals", "network" ], "type": "object" }, "type": "array" }, "mechanics": { "additionalProperties": {}, "properties": { "arguments": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, "cooldownPeriod": { "additionalProperties": {}, "properties": { "seconds": { "type": "number" } }, "required": [ "seconds" ], "type": "object" }, "entryLimits": { "additionalProperties": {}, "properties": { "maximum": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "minimum": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "subsequentMinimum": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "minimum", "maximum" ], "type": "object" }, "extraTransactionFormatsSupported": { "items": { "type": "string" }, "type": "array" }, "fee": { "additionalProperties": {}, "properties": { "deposit": { "type": "string" }, "management": { "type": "string" }, "performance": { "type": "string" }, "withdrawal": { "type": "string" } }, "type": "object" }, "gasFeeToken": { "additionalProperties": {}, "properties": { "address": { "type": "string" }, "coinGeckoId": { "type": "string" }, "decimals": { "type": "number" }, "isPoints": { "type": "boolean" }, "logoURI": { "type": "string" }, "name": { "type": "string" }, "network": { "type": "string" }, "symbol": { "type": "string" } }, "required": [ "symbol", "name", "decimals", "network" ], "type": "object" }, "lockupPeriod": { "additionalProperties": {}, "properties": { "seconds": { "type": "number" } }, "required": [ "seconds" ], "type": "object" }, "possibleFeeTakingMechanisms": { "additionalProperties": { "type": "boolean" }, "propertyNames": { "type": "string" }, "type": "object" }, "requirements": { "additionalProperties": {}, "properties": { "kyc": { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, "kycRequired": { "type": "boolean" }, "kycUrl": { "type": "string" } }, "required": [ "kycRequired" ], "type": "object" }, "requiresValidatorSelection": { "type": "boolean" }, "rewardClaiming": { "type": "string" }, "rewardSchedule": { "type": "string" }, "supportsLedgerWalletApi": { "type": "boolean" }, "type": { "type": "string" }, "warmupPeriod": { "additionalProperties": {}, "properties": { "seconds": { "type": "number" } }, "required": [ "seconds" ], "type": "object" } }, "required": [ "type", "rewardClaiming", "rewardSchedule", "gasFeeToken" ], "type": "object" }, "metadata": { "additionalProperties": {}, "properties": { "deprecated": { "type": "boolean" }, "description": { "type": "string" }, "documentation": { "type": "string" }, "logoURI": { "type": "string" }, "name": { "type": "string" }, "supportedStandards": { "items": { "type": "string" }, "type": "array" }, "underMaintenance": { "type": "boolean" } }, "required": [ "name", "logoURI", "description", "documentation", "underMaintenance", "deprecated", "supportedStandards" ], "type": "object" }, "network": { "type": "string" }, "outputToken": { "additionalProperties": {}, "properties": { "address": { "type": "string" }, "coinGeckoId": { "type": "string" }, "decimals": { "type": "number" }, "isPoints": { "type": "boolean" }, "logoURI": { "type": "string" }, "name": { "type": "string" }, "network": { "type": "string" }, "symbol": { "type": "string" } }, "required": [ "symbol", "name", "decimals", "network" ], "type": "object" }, "providerId": { "type": "string" }, "rewardRate": { "additionalProperties": {}, "properties": { "components": { "items": { "additionalProperties": {}, "properties": { "description": { "type": "string" }, "rate": { "type": "number" }, "rateType": { "type": "string" }, "token": { "additionalProperties": {}, "properties": { "address": { "type": "string" }, "coinGeckoId": { "type": "string" }, "decimals": { "type": "number" }, "isPoints": { "type": "boolean" }, "logoURI": { "type": "string" }, "name": { "type": "string" }, "network": { "type": "string" }, "symbol": { "type": "string" } }, "required": [ "symbol", "name", "decimals", "network" ], "type": "object" }, "yieldSource": { "type": "string" } }, "required": [ "rate", "rateType", "token", "yieldSource" ], "type": "object" }, "type": "array" }, "rateType": { "type": "string" }, "total": { "type": "number" } }, "required": [ "total", "rateType", "components" ], "type": "object" }, "risk": { "additionalProperties": {}, "properties": { "ratings": { "items": { "additionalProperties": {}, "properties": { "rating": { "type": "string" }, "source": { "enum": [ "credora", "stakingRewards" ], "type": "string" } }, "required": [ "rating", "source" ], "type": "object" }, "type": "array" } }, "required": [ "ratings" ], "type": "object" }, "state": { "additionalProperties": {}, "properties": { "allocations": { "items": { "additionalProperties": {}, "properties": { "address": { "type": "string" }, "allocation": { "type": "string" }, "allocationUsd": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "maxCapacity": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "name": { "type": "string" }, "network": { "type": "string" }, "providerId": { "type": "string" }, "remainingCapacity": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "rewardRate": { "anyOf": [ { "additionalProperties": {}, "properties": { "rateType": { "type": "string" }, "total": { "type": "number" } }, "required": [ "total", "rateType" ], "type": "object" }, { "type": "null" } ] }, "targetWeight": { "type": "number" }, "tvl": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "tvlUsd": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "weight": { "type": "number" }, "yieldId": { "type": "string" } }, "required": [ "address", "network", "name", "allocation", "weight", "targetWeight" ], "type": "object" }, "type": "array" }, "capacityState": { "additionalProperties": {}, "properties": { "current": { "type": "string" }, "max": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "remaining": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "required": [ "current", "max", "remaining" ], "type": "object" }, "concentratedLiquidityPoolState": { "additionalProperties": {}, "properties": { "baseApr": { "type": "number" }, "baseToken": { "additionalProperties": {}, "properties": { "address": { "type": "string" }, "coinGeckoId": { "type": "string" }, "decimals": { "type": "number" }, "isPoints": { "type": "boolean" }, "logoURI": { "type": "string" }, "name": { "type": "string" }, "network": { "type": "string" }, "symbol": { "type": "string" } }, "required": [ "symbol", "name", "decimals", "network" ], "type": "object" }, "fee24hUsd": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "feeTier": { "type": "number" }, "maxTick": { "type": "number" }, "minTick": { "type": "number" }, "price": { "type": "number" }, "quoteToken": { "additionalProperties": {}, "properties": { "address": { "type": "string" }, "coinGeckoId": { "type": "string" }, "decimals": { "type": "number" }, "isPoints": { "type": "boolean" }, "logoURI": { "type": "string" }, "name": { "type": "string" }, "network": { "type": "string" }, "symbol": { "type": "string" } }, "required": [ "symbol", "name", "decimals", "network" ], "type": "object" }, "tickSpacing": { "type": "number" }, "tvlUsd": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "volume24hUsd": { "anyOf": [ { "type": "number" }, { "type": "null" } ] } }, "required": [ "baseApr", "price", "tickSpacing", "minTick", "maxTick", "volume24hUsd", "fee24hUsd", "tvlUsd", "feeTier", "baseToken", "quoteToken" ], "type": "object" }, "liquidityState": { "additionalProperties": {}, "properties": { "liquidity": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "utilization": { "anyOf": [ { "type": "string" }, { "type": "null" } ] } }, "type": "object" }, "pricePerShareState": { "additionalProperties": {}, "properties": { "price": { "type": "number" }, "quoteToken": { "additionalProperties": {}, "properties": { "address": { "type": "string" }, "coinGeckoId": { "type": "string" }, "decimals": { "type": "number" }, "isPoints": { "type": "boolean" }, "logoURI": { "type": "string" }, "name": { "type": "string" }, "network": { "type": "string" }, "symbol": { "type": "string" } }, "required": [ "symbol", "name", "decimals", "network" ], "type": "object" }, "shareToken": { "additionalProperties": {}, "properties": { "address": { "type": "string" }, "coinGeckoId": { "type": "string" }, "decimals": { "type": "number" }, "isPoints": { "type": "boolean" }, "logoURI": { "type": "string" }, "name": { "type": "string" }, "network": { "type": "string" }, "symbol": { "type": "string" } }, "required": [ "symbol", "name", "decimals", "network" ], "type": "object" } }, "required": [ "price", "shareToken", "quoteToken" ], "type": "object" } }, "type": "object" }, "statistics": { "additionalProperties": {}, "properties": { "averagePositionSize": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "averagePositionSizeUsd": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "tvl": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "tvlRaw": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "tvlUsd": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "uniqueUsers": { "anyOf": [ { "type": "number" }, { "type": "null" } ] } }, "type": "object" }, "status": { "additionalProperties": {}, "properties": { "enter": { "type": "boolean" }, "exit": { "type": "boolean" } }, "required": [ "enter", "exit" ], "type": "object" }, "tags": { "items": { "type": "string" }, "type": "array" }, "token": { "additionalProperties": {}, "properties": { "address": { "type": "string" }, "coinGeckoId": { "type": "string" }, "decimals": { "type": "number" }, "isPoints": { "type": "boolean" }, "logoURI": { "type": "string" }, "name": { "type": "string" }, "network": { "type": "string" }, "symbol": { "type": "string" } }, "required": [ "symbol", "name", "decimals", "network" ], "type": "object" }, "tokens": { "items": { "additionalProperties": {}, "properties": { "address": { "type": "string" }, "coinGeckoId": { "type": "string" }, "decimals": { "type": "number" }, "isPoints": { "type": "boolean" }, "logoURI": { "type": "string" }, "name": { "type": "string" }, "network": { "type": "string" }, "symbol": { "type": "string" } }, "required": [ "symbol", "name", "decimals", "network" ], "type": "object" }, "type": "array" } }, "required": [ "id", "network", "token", "tokens", "inputTokens", "rewardRate", "status", "metadata", "mechanics", "providerId" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true } }, { "name": "yields_get_validators", "title": "Get Yield Validators", "description": "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 only curated validators.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "address": { "description": "Filter by validator address.", "type": "string" }, "limit": { "default": 20, "description": "Max results per page (1-50, default 20).", "maximum": 50, "minimum": 1, "type": "integer" }, "name": { "description": "Filter validators by name (case-insensitive, partial match).", "type": "string" }, "offset": { "default": 0, "description": "Pagination offset. Increment by limit to fetch the next page.", "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "preferred": { "description": "Pass true to return only curated/recommended validators.", "type": "boolean" }, "provider": { "description": "Filter by provider ID.", "type": "string" }, "status": { "description": "Filter by validator status e.g. \"active\", \"jailed\".", "type": "string" }, "yieldId": { "description": "Yield ID from yields_get_all. Must be a delegation-based yield e.g. \"cosmos-atom-native-staking\".", "type": "string" } }, "required": [ "yieldId" ], "type": "object" }, "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "items": { "items": { "additionalProperties": {}, "properties": { "address": { "type": "string" }, "commission": { "type": "number" }, "logoURI": { "type": "string" }, "minimumStake": { "type": "string" }, "name": { "type": "string" }, "nominatorCount": { "type": "number" }, "preferred": { "type": "boolean" }, "provider": { "additionalProperties": {}, "properties": { "createdAt": { "type": "string" }, "description": { "type": "string" }, "id": { "type": "string" }, "logoURI": { "type": "string" }, "name": { "type": "string" }, "preferred": { "type": "boolean" }, "rank": { "type": "number" }, "references": { "items": { "type": "string" }, "type": "array" }, "revshare": { "anyOf": [ { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, { "type": "null" } ] }, "tvlUsd": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "type": { "type": "string" }, "uniqueId": { "type": "string" }, "updatedAt": { "type": "string" }, "website": { "type": "string" } }, "required": [ "id" ], "type": "object" }, "providerId": { "type": "string" }, "remainingPossibleStake": { "type": "string" }, "remainingSlots": { "type": "number" }, "rewardRate": { "additionalProperties": {}, "properties": { "components": { "items": { "additionalProperties": {}, "properties": { "description": { "type": "string" }, "rate": { "type": "number" }, "rateType": { "type": "string" }, "token": { "additionalProperties": {}, "properties": { "address": { "type": "string" }, "coinGeckoId": { "type": "string" }, "decimals": { "type": "number" }, "isPoints": { "type": "boolean" }, "logoURI": { "type": "string" }, "name": { "type": "string" }, "network": { "type": "string" }, "symbol": { "type": "string" } }, "required": [ "symbol", "name", "decimals", "network" ], "type": "object" }, "yieldSource": { "type": "string" } }, "required": [ "rate", "rateType", "token", "yieldSource" ], "type": "object" }, "type": "array" }, "rateType": { "type": "string" }, "total": { "type": "number" } }, "required": [ "total", "rateType", "components" ], "type": "object" }, "status": { "type": "string" }, "subnet": { "additionalProperties": {}, "properties": { "id": { "type": "number" }, "name": { "type": "string" }, "pricePerShare": { "type": "string" }, "tokenSymbol": { "type": "string" }, "tvl": { "type": "string" } }, "required": [ "id" ], "type": "object" }, "tvl": { "type": "string" }, "tvlRaw": { "type": "string" }, "tvlUsd": { "type": "string" }, "votingPower": { "type": "number" }, "website": { "type": "string" } }, "required": [ "address" ], "type": "object" }, "type": "array" }, "limit": { "type": "number" }, "offset": { "type": "number" }, "total": { "type": "number" } }, "required": [ "total", "offset", "limit", "items" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true } }, { "name": "yields_get_balances", "title": "Get Yield Balances", "description": "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 from balances[].pendingActions[].passthrough.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "address": { "description": "Wallet address to query. EVM: \"0xAbc...\", Cosmos: bech32 address e.g. \"cosmos1...\".", "type": "string" }, "network": { "description": "Network to query e.g. \"base\", \"ethereum\"", "type": "string" }, "yieldIds": { "description": "Optional: filter to specific yield IDs only", "items": { "type": "string" }, "type": "array" } }, "required": [ "address", "network" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true } }, { "name": "actions_enter", "title": "Enter a Yield", "description": "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-readable strings (\"1.5\" = 1.5 tokens, not wei). Submit transactions in stepIndex order; for the synchronous execution pattern, wait for on-chain confirmation before submitting the next one. For ERC-4626 vaults (including RWAs like Midas), inspect yields_get → mechanics.arguments.enter.fields[] to discover yield-specific options (e.g. useMaxAllowance, receiverAddress).", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "address": { "description": "Wallet address that will own the position.", "type": "string" }, "amount": { "description": "Token units e.g. \"1.5\" for 1.5 ETH", "type": "string" }, "executionMode": { "description": "Transaction execution mode. Defaults to \"individual\". \"batched\" is reserved for future use — batch mode is not yet available across all yields and should not be used until fully enabled.", "enum": [ "individual", "batched" ], "type": "string" }, "inputToken": { "description": "Deposit token address, for yields that accept more than one deposit token. Required when yields_get → mechanics.arguments.enter.fields[] lists an inputToken field with required: true; that field's options[] holds the valid addresses, which also appear as yields_get → inputTokens[].address. Use \"0x\" to deposit the network's native token.", "minLength": 1, "type": "string" }, "inputTokenNetwork": { "description": "Network of the input token e.g. \"ethereum\". Only for cross-chain deposits, where the deposit token is not on the vault's own network.", "minLength": 1, "type": "string" }, "receiverAddress": { "description": "Optional. ERC-4626 vault convenience field. Address that should receive the minted vault shares. Defaults to the position owner (`address`). Honored only when listed in yields_get enter schema.", "type": "string" }, "useMaxAllowance": { "description": "Optional. ERC-4626 vault convenience flag. true = approve the maximum (uint256 max) allowance, so subsequent deposits skip a fresh APPROVAL step. false = approve only the exact amount being deposited. Honored only when listed in yields_get enter schema.", "type": "boolean" }, "validatorAddress": { "description": "Validator to delegate to. Required when yields_get returns mechanics.requiresValidatorSelection=true.", "type": "string" }, "yieldId": { "description": "Yield ID from yields_get_all e.g. \"ethereum-eth-lido-staking\".", "type": "string" } }, "required": [ "yieldId", "address", "amount" ], "type": "object" }, "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "address": { "type": "string" }, "amount": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "amountRaw": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "amountUsd": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "completedAt": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "createdAt": { "type": "string" }, "executionPattern": { "enum": [ "synchronous", "asynchronous", "batch" ], "type": "string" }, "id": { "type": "string" }, "intent": { "type": "string" }, "rawArguments": { "anyOf": [ { "additionalProperties": {}, "properties": { "amount": { "type": "string" }, "amounts": { "items": { "type": "string" }, "type": "array" }, "cAddressBech": { "type": "string" }, "cosmosPubKey": { "type": "string" }, "duration": { "type": "number" }, "executionMode": { "enum": [ "individual", "batched" ], "type": "string" }, "feeConfigurationId": { "type": "string" }, "inputToken": { "type": "string" }, "inputTokenNetwork": { "type": "string" }, "ledgerWalletAPICompatible": { "type": "boolean" }, "outputToken": { "type": "string" }, "outputTokenNetwork": { "type": "string" }, "pAddressBech": { "type": "string" }, "providerId": { "type": "string" }, "receiverAddress": { "type": "string" }, "subnetId": { "type": "number" }, "tezosPubKey": { "type": "string" }, "tronResource": { "type": "string" }, "validatorAddress": { "type": "string" }, "validatorAddresses": { "items": { "type": "string" }, "type": "array" } }, "type": "object" }, { "type": "null" } ] }, "status": { "type": "string" }, "transactions": { "items": { "additionalProperties": {}, "properties": { "annotatedTransaction": { "anyOf": [ { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, { "type": "null" } ] }, "broadcastedAt": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "createdAt": { "type": "string" }, "description": { "type": "string" }, "error": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "explorerUrl": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "gasEstimate": { "type": "string" }, "hash": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "id": { "type": "string" }, "isMessage": { "type": "boolean" }, "network": { "type": "string" }, "signedTransaction": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "status": { "type": "string" }, "stepIndex": { "type": "number" }, "structuredTransaction": { "anyOf": [ { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, { "type": "null" } ] }, "title": { "type": "string" }, "type": { "type": "string" }, "unsignedTransaction": { "anyOf": [ { "anyOf": [ { "type": "string" }, { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" } ] }, { "type": "null" } ] } }, "required": [ "id", "network", "status", "type", "title", "hash", "createdAt", "broadcastedAt", "signedTransaction" ], "type": "object" }, "type": "array" }, "type": { "type": "string" }, "yieldId": { "type": "string" } }, "required": [ "id", "intent", "type", "yieldId", "address", "amount", "amountRaw", "amountUsd", "executionPattern", "status", "transactions", "createdAt", "completedAt", "rawArguments" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false } }, { "name": "actions_exit", "title": "Exit a Yield", "description": "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-readable strings (\"1.5\" = 1.5 tokens, not wei). Submit transactions in stepIndex order. Call yields_get_balances first to verify the staked balance. To complete a PENDING withdrawal (e.g. claiming after a cooldown) that carries a passthrough value, use actions_manage — exit does NOT accept passthrough. For RWA and ERC-4626 vaults, inspect yields_get → mechanics.arguments.exit.fields[] to discover yield-specific options (e.g. useInstantExecution, useMaxAmount, receiverAddress).", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "address": { "description": "Wallet address that owns the position.", "type": "string" }, "amount": { "description": "Amount to withdraw in token units e.g. \"1.5\". Optional when useMaxAmount is true on supported yields.", "type": "string" }, "executionMode": { "description": "Transaction execution mode. Defaults to \"individual\". \"batched\" is reserved for future use — batch mode is not yet available across all yields and should not be used until fully enabled.", "enum": [ "individual", "batched" ], "type": "string" }, "outputToken": { "description": "Withdrawal token address, for yields that can pay out in more than one token. Required when yields_get → mechanics.arguments.exit.fields[] lists an outputToken field with required: true; that field's options[] holds the valid addresses. Use \"0x\" to receive the network's native token.", "minLength": 1, "type": "string" }, "outputTokenNetwork": { "description": "Network of the output token e.g. \"ethereum\". Only for cross-chain withdrawals, where the destination token is not on the vault's own network.", "minLength": 1, "type": "string" }, "receiverAddress": { "description": "Optional. ERC-4626 vault convenience field. Address that should receive the underlying token from the redemption. Defaults to the position owner (`address`). Honored only when listed in yields_get exit schema.", "type": "string" }, "useAutoClaim": { "description": "Optional. Available on yields whose exit schema lists this field (e.g. Nest RWA vaults). true = authorize the redeem operator to auto-claim settled async redemptions (adds a one-time per-wallet operator approval), so no manual claim is needed after settlement. false or omitted = claim manually once the redemption settles. Honored only when listed in yields_get exit schema.", "type": "boolean" }, "useInstantExecution": { "description": "Optional. Available on yields whose exit schema lists this field (e.g. Midas mTBILL, Upshift vaults, Marinade on Solana). true = instant redemption (settles same block, may incur a higher fee — Midas docs quote up to 50 bps for mTBILL). false or omitted = standard redemption (queues; for RWAs settlement may take 1-7 business days — poll yields_get_balances and read the \"exiting\" entry's `date` field for the expected settlement timestamp). Distinct from executionMode (which controls per-step batching, not redemption path).", "type": "boolean" }, "useMaxAmount": { "description": "Optional. ERC-4626 vault convenience flag. true = redeem the full position (overrides amount). Honored only when listed in yields_get exit schema.", "type": "boolean" }, "validatorAddress": { "description": "Validator address to undelegate from. Required for delegation-based yields.", "type": "string" }, "yieldId": { "description": "Yield ID from yields_get_all e.g. \"ethereum-eth-lido-staking\".", "type": "string" } }, "required": [ "yieldId", "address" ], "type": "object" }, "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "address": { "type": "string" }, "amount": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "amountRaw": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "amountUsd": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "completedAt": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "createdAt": { "type": "string" }, "executionPattern": { "enum": [ "synchronous", "asynchronous", "batch" ], "type": "string" }, "id": { "type": "string" }, "intent": { "type": "string" }, "rawArguments": { "anyOf": [ { "additionalProperties": {}, "properties": { "amount": { "type": "string" }, "amounts": { "items": { "type": "string" }, "type": "array" }, "cAddressBech": { "type": "string" }, "cosmosPubKey": { "type": "string" }, "duration": { "type": "number" }, "executionMode": { "enum": [ "individual", "batched" ], "type": "string" }, "feeConfigurationId": { "type": "string" }, "inputToken": { "type": "string" }, "inputTokenNetwork": { "type": "string" }, "ledgerWalletAPICompatible": { "type": "boolean" }, "outputToken": { "type": "string" }, "outputTokenNetwork": { "type": "string" }, "pAddressBech": { "type": "string" }, "providerId": { "type": "string" }, "receiverAddress": { "type": "string" }, "subnetId": { "type": "number" }, "tezosPubKey": { "type": "string" }, "tronResource": { "type": "string" }, "validatorAddress": { "type": "string" }, "validatorAddresses": { "items": { "type": "string" }, "type": "array" } }, "type": "object" }, { "type": "null" } ] }, "status": { "type": "string" }, "transactions": { "items": { "additionalProperties": {}, "properties": { "annotatedTransaction": { "anyOf": [ { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, { "type": "null" } ] }, "broadcastedAt": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "createdAt": { "type": "string" }, "description": { "type": "string" }, "error": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "explorerUrl": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "gasEstimate": { "type": "string" }, "hash": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "id": { "type": "string" }, "isMessage": { "type": "boolean" }, "network": { "type": "string" }, "signedTransaction": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "status": { "type": "string" }, "stepIndex": { "type": "number" }, "structuredTransaction": { "anyOf": [ { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, { "type": "null" } ] }, "title": { "type": "string" }, "type": { "type": "string" }, "unsignedTransaction": { "anyOf": [ { "anyOf": [ { "type": "string" }, { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" } ] }, { "type": "null" } ] } }, "required": [ "id", "network", "status", "type", "title", "hash", "createdAt", "broadcastedAt", "signedTransaction" ], "type": "object" }, "type": "array" }, "type": { "type": "string" }, "yieldId": { "type": "string" } }, "required": [ "id", "intent", "type", "yieldId", "address", "amount", "amountRaw", "amountUsd", "executionPattern", "status", "transactions", "createdAt", "completedAt", "rawArguments" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false } }, { "name": "actions_manage", "title": "Manage a Yield", "description": "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 yields_get_balances balances[].pendingActions[] — do not guess these values.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "action": { "description": "Action type from yields_get_balances balances[].pendingActions[].type e.g. \"CLAIM_REWARDS\", \"UNLOCK\".", "enum": [ "STAKE", "UNSTAKE", "WITHDRAW_REQUEST", "INSTANT_WITHDRAW", "CLAIM_REWARDS", "AUTO_SWEEP_UNSTAKE_REWARDS", "AUTO_SWEEP_WITHDRAW_REWARDS", "RESTAKE_REWARDS", "WITHDRAW", "WITHDRAW_ALL", "RESTAKE", "CLAIM_UNSTAKED", "UNLOCK_LOCKED", "STAKE_LOCKED", "VOTE", "REVOKE", "VOTE_LOCKED", "REVOTE", "REBOND", "MIGRATE", "VERIFY_WITHDRAW_CREDENTIALS", "DELEGATE", "MERGE", "CANCEL_PENDING" ], "type": "string" }, "address": { "description": "Wallet address that owns the position.", "type": "string" }, "amount": { "description": "Optional. Human-readable amount for partial reward claims e.g. \"10.5\". Omit to claim full amount.", "type": "string" }, "executionMode": { "description": "Transaction execution mode. Defaults to \"individual\". \"batched\" is reserved for future use — batch mode is not yet available across all yields and should not be used until fully enabled.", "enum": [ "individual", "batched" ], "type": "string" }, "passthrough": { "description": "Required — from yields_get_balances pendingActions[].passthrough", "type": "string" }, "yieldId": { "description": "Yield ID from yields_get_all e.g. \"ethereum-eth-lido-staking\".", "type": "string" } }, "required": [ "yieldId", "address", "action", "passthrough" ], "type": "object" }, "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "address": { "type": "string" }, "amount": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "amountRaw": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "amountUsd": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "completedAt": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "createdAt": { "type": "string" }, "executionPattern": { "enum": [ "synchronous", "asynchronous", "batch" ], "type": "string" }, "id": { "type": "string" }, "intent": { "type": "string" }, "rawArguments": { "anyOf": [ { "additionalProperties": {}, "properties": { "amount": { "type": "string" }, "amounts": { "items": { "type": "string" }, "type": "array" }, "cAddressBech": { "type": "string" }, "cosmosPubKey": { "type": "string" }, "duration": { "type": "number" }, "executionMode": { "enum": [ "individual", "batched" ], "type": "string" }, "feeConfigurationId": { "type": "string" }, "inputToken": { "type": "string" }, "inputTokenNetwork": { "type": "string" }, "ledgerWalletAPICompatible": { "type": "boolean" }, "outputToken": { "type": "string" }, "outputTokenNetwork": { "type": "string" }, "pAddressBech": { "type": "string" }, "providerId": { "type": "string" }, "receiverAddress": { "type": "string" }, "subnetId": { "type": "number" }, "tezosPubKey": { "type": "string" }, "tronResource": { "type": "string" }, "validatorAddress": { "type": "string" }, "validatorAddresses": { "items": { "type": "string" }, "type": "array" } }, "type": "object" }, { "type": "null" } ] }, "status": { "type": "string" }, "transactions": { "items": { "additionalProperties": {}, "properties": { "annotatedTransaction": { "anyOf": [ { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, { "type": "null" } ] }, "broadcastedAt": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "createdAt": { "type": "string" }, "description": { "type": "string" }, "error": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "explorerUrl": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "gasEstimate": { "type": "string" }, "hash": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "id": { "type": "string" }, "isMessage": { "type": "boolean" }, "network": { "type": "string" }, "signedTransaction": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "status": { "type": "string" }, "stepIndex": { "type": "number" }, "structuredTransaction": { "anyOf": [ { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, { "type": "null" } ] }, "title": { "type": "string" }, "type": { "type": "string" }, "unsignedTransaction": { "anyOf": [ { "anyOf": [ { "type": "string" }, { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" } ] }, { "type": "null" } ] } }, "required": [ "id", "network", "status", "type", "title", "hash", "createdAt", "broadcastedAt", "signedTransaction" ], "type": "object" }, "type": "array" }, "type": { "type": "string" }, "yieldId": { "type": "string" } }, "required": [ "id", "intent", "type", "yieldId", "address", "amount", "amountRaw", "amountUsd", "executionPattern", "status", "transactions", "createdAt", "completedAt", "rawArguments" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": false, "openWorldHint": false, "readOnlyHint": false } }, { "name": "submit_hash", "title": "Submit Transaction Hash", "description": "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 the transactionId and hash from the broadcast result.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "hash": { "description": "The on-chain transaction hash returned after broadcasting, e.g. \"0x1234…abcdef\"", "maxLength": 100, "type": "string" }, "transactionId": { "description": "The unique identifier of the transaction (UUID from the action flow)", "type": "string" } }, "required": [ "transactionId", "hash" ], "type": "object" }, "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "annotatedTransaction": { "anyOf": [ { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, { "type": "null" } ] }, "broadcastedAt": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "createdAt": { "type": "string" }, "description": { "type": "string" }, "error": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "explorerUrl": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "gasEstimate": { "type": "string" }, "hash": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "id": { "type": "string" }, "isMessage": { "type": "boolean" }, "network": { "type": "string" }, "signedTransaction": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "status": { "type": "string" }, "stepIndex": { "type": "number" }, "structuredTransaction": { "anyOf": [ { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, { "type": "null" } ] }, "title": { "type": "string" }, "type": { "type": "string" }, "unsignedTransaction": { "anyOf": [ { "anyOf": [ { "type": "string" }, { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" } ] }, { "type": "null" } ] } }, "required": [ "id", "network", "status", "type", "title", "hash", "createdAt", "broadcastedAt", "signedTransaction" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": false } }, { "name": "get_transaction", "title": "Get Transaction Status", "description": "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, CONFIRMED, FAILED, SKIPPED. Terminal states: CONFIRMED, FAILED, SKIPPED.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "transactionId": { "description": "The transaction UUID returned by actions_enter, actions_exit, or actions_manage — same ID passed to submit_hash.", "type": "string" } }, "required": [ "transactionId" ], "type": "object" }, "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "annotatedTransaction": { "anyOf": [ { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, { "type": "null" } ] }, "broadcastedAt": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "createdAt": { "type": "string" }, "description": { "type": "string" }, "error": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "explorerUrl": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "gasEstimate": { "type": "string" }, "hash": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "id": { "type": "string" }, "isMessage": { "type": "boolean" }, "network": { "type": "string" }, "signedTransaction": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "status": { "type": "string" }, "stepIndex": { "type": "number" }, "structuredTransaction": { "anyOf": [ { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, { "type": "null" } ] }, "title": { "type": "string" }, "type": { "type": "string" }, "unsignedTransaction": { "anyOf": [ { "anyOf": [ { "type": "string" }, { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" } ] }, { "type": "null" } ] } }, "required": [ "id", "network", "status", "type", "title", "hash", "createdAt", "broadcastedAt", "signedTransaction" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": true, "readOnlyHint": true } }, { "name": "actions_get", "title": "Get Action Status", "description": "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-autonomous Privy flows where approval may take time.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "actionId": { "description": "The action UUID returned by actions_enter, actions_exit, or actions_manage.", "type": "string" } }, "required": [ "actionId" ], "type": "object" }, "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "address": { "type": "string" }, "amount": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "amountRaw": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "amountUsd": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "completedAt": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "createdAt": { "type": "string" }, "executionPattern": { "enum": [ "synchronous", "asynchronous", "batch" ], "type": "string" }, "id": { "type": "string" }, "intent": { "type": "string" }, "rawArguments": { "anyOf": [ { "additionalProperties": {}, "properties": { "amount": { "type": "string" }, "amounts": { "items": { "type": "string" }, "type": "array" }, "cAddressBech": { "type": "string" }, "cosmosPubKey": { "type": "string" }, "duration": { "type": "number" }, "executionMode": { "enum": [ "individual", "batched" ], "type": "string" }, "feeConfigurationId": { "type": "string" }, "inputToken": { "type": "string" }, "inputTokenNetwork": { "type": "string" }, "ledgerWalletAPICompatible": { "type": "boolean" }, "outputToken": { "type": "string" }, "outputTokenNetwork": { "type": "string" }, "pAddressBech": { "type": "string" }, "providerId": { "type": "string" }, "receiverAddress": { "type": "string" }, "subnetId": { "type": "number" }, "tezosPubKey": { "type": "string" }, "tronResource": { "type": "string" }, "validatorAddress": { "type": "string" }, "validatorAddresses": { "items": { "type": "string" }, "type": "array" } }, "type": "object" }, { "type": "null" } ] }, "status": { "type": "string" }, "transactions": { "items": { "additionalProperties": {}, "properties": { "annotatedTransaction": { "anyOf": [ { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, { "type": "null" } ] }, "broadcastedAt": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "createdAt": { "type": "string" }, "description": { "type": "string" }, "error": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "explorerUrl": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "gasEstimate": { "type": "string" }, "hash": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "id": { "type": "string" }, "isMessage": { "type": "boolean" }, "network": { "type": "string" }, "signedTransaction": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "status": { "type": "string" }, "stepIndex": { "type": "number" }, "structuredTransaction": { "anyOf": [ { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" }, { "type": "null" } ] }, "title": { "type": "string" }, "type": { "type": "string" }, "unsignedTransaction": { "anyOf": [ { "anyOf": [ { "type": "string" }, { "additionalProperties": {}, "propertyNames": { "type": "string" }, "type": "object" } ] }, { "type": "null" } ] } }, "required": [ "id", "network", "status", "type", "title", "hash", "createdAt", "broadcastedAt", "signedTransaction" ], "type": "object" }, "type": "array" }, "type": { "type": "string" }, "yieldId": { "type": "string" } }, "required": [ "id", "intent", "type", "yieldId", "address", "amount", "amountRaw", "amountUsd", "executionPattern", "status", "transactions", "createdAt", "completedAt", "rawArguments" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": true, "readOnlyHint": true } }, { "name": "actions_get_all", "title": "Get Action History", "description": "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 for approval.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "address": { "description": "Wallet address to query actions for.", "type": "string" }, "intent": { "description": "Filter by intent: \"enter\", \"exit\", or \"manage\".", "enum": [ "enter", "manage", "exit" ], "type": "string" }, "limit": { "default": 20, "description": "Max results (1-100, default 20).", "maximum": 100, "minimum": 1, "type": "integer" }, "network": { "description": "Filter by network e.g. \"base\", \"ethereum\".", "type": "string" }, "offset": { "default": 0, "description": "Pagination offset.", "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "statuses": { "description": "Filter by one or more action statuses. Valid values: \"CREATED\" (submitted, not yet sent on-chain), \"PROCESSING\" (in-flight on-chain), \"WAITING_FOR_NEXT\" (multi-step action awaiting next tx), \"SUCCESS\" (confirmed), \"FAILED\" (reverted or errored), \"CANCELED\" (user-cancelled), \"STALE\" (timed out). Pass multiple to get all pending e.g. [\"CREATED\", \"PROCESSING\"].", "items": { "enum": [ "CANCELED", "CREATED", "WAITING_FOR_NEXT", "PROCESSING", "FAILED", "SUCCESS", "STALE" ], "type": "string" }, "type": "array" }, "type": { "description": "Filter by action type e.g. \"STAKE\", \"UNSTAKE\", \"CLAIM_REWARDS\".", "enum": [ "STAKE", "UNSTAKE", "WITHDRAW_REQUEST", "INSTANT_WITHDRAW", "CLAIM_REWARDS", "AUTO_SWEEP_UNSTAKE_REWARDS", "AUTO_SWEEP_WITHDRAW_REWARDS", "RESTAKE_REWARDS", "WITHDRAW", "WITHDRAW_ALL", "RESTAKE", "CLAIM_UNSTAKED", "UNLOCK_LOCKED", "STAKE_LOCKED", "VOTE", "REVOKE", "VOTE_LOCKED", "REVOTE", "REBOND", "MIGRATE", "VERIFY_WITHDRAW_CREDENTIALS", "DELEGATE", "MERGE", "CANCEL_PENDING" ], "type": "string" }, "yieldId": { "description": "Filter by yield ID e.g. \"base-usdc-aave-v3-lending\".", "type": "string" } }, "required": [ "address" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": true, "readOnlyHint": true } }, { "name": "networks_get_all", "title": "List Supported Networks", "description": "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 parameter.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "category": { "description": "Filter by network category. e.g. \"evm\" returns all EVM networks, \"cosmos\" returns all Cosmos chains.", "enum": [ "evm", "cosmos", "substrate", "misc" ], "type": "string" }, "search": { "description": "Filter networks by name or id (case-insensitive, min 2 chars). e.g. \"eth\", \"cosmos\", \"base\".", "minLength": 2, "type": "string" } }, "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": true, "readOnlyHint": true } }, { "name": "yields_get_reward_rate_history", "title": "Get Reward Rate History", "description": "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.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "from": { "description": "Start of time range (ISO 8601) e.g. \"2025-01-01T00:00:00Z\". Overrides period.", "type": "string" }, "interval": { "description": "Sampling resolution: \"day\", \"week\", or \"month\". Default: \"day\".", "enum": [ "day", "week", "month" ], "type": "string" }, "limit": { "default": 30, "description": "Max data points to return (1-365, default 30).", "maximum": 365, "minimum": 1, "type": "integer" }, "offset": { "default": 0, "description": "Pagination offset.", "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "period": { "description": "Predefined time window: \"1d\", \"7d\", \"30d\", \"90d\", \"1y\", \"all\". Ignored if from/to are set. Default: \"30d\".", "enum": [ "1d", "7d", "30d", "90d", "1y", "all" ], "type": "string" }, "to": { "description": "End of time range (ISO 8601). Defaults to now.", "type": "string" }, "yieldId": { "description": "Yield ID e.g. \"ethereum-eth-lido-staking\".", "type": "string" } }, "required": [ "yieldId" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": true, "readOnlyHint": true } }, { "name": "yields_get_tvl_history", "title": "Get TVL History", "description": "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.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "from": { "description": "Start of time range (ISO 8601). Overrides period.", "type": "string" }, "interval": { "description": "Sampling resolution: \"day\", \"week\", or \"month\". Default: \"day\".", "enum": [ "day", "week", "month" ], "type": "string" }, "limit": { "default": 30, "description": "Max data points to return (1-365, default 30).", "maximum": 365, "minimum": 1, "type": "integer" }, "offset": { "default": 0, "description": "Pagination offset.", "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "period": { "description": "Predefined time window: \"1d\", \"7d\", \"30d\", \"90d\", \"1y\", \"all\". Ignored if from/to are set. Default: \"30d\".", "enum": [ "1d", "7d", "30d", "90d", "1y", "all" ], "type": "string" }, "to": { "description": "End of time range (ISO 8601). Defaults to now.", "type": "string" }, "yieldId": { "description": "Yield ID e.g. \"base-usdc-aave-v3-lending\".", "type": "string" } }, "required": [ "yieldId" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": true, "readOnlyHint": true } }, { "name": "yields_get_risk", "title": "Get Yield Risk Data", "description": "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 user asks about protocol safety or risk.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "yieldId": { "description": "Yield ID e.g. \"ethereum-eth-lido-staking\".", "type": "string" } }, "required": [ "yieldId" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": true, "readOnlyHint": true } }, { "name": "providers_get_all", "title": "List Providers", "description": "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?\" or to get valid provider IDs for yields_get_all filters.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "limit": { "default": 20, "description": "Max results per page (1-100, default 20).", "maximum": 100, "minimum": 1, "type": "integer" }, "offset": { "default": 0, "description": "Pagination offset.", "maximum": 9007199254740991, "minimum": 0, "type": "integer" } }, "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": true, "readOnlyHint": true } }, { "name": "yields_get_kyc_status", "title": "Get Yield KYC Status", "description": "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 requirement return \"not_required\". When the status is \"not_started\" or \"pending\", the response may include an authorizeUrl pointing to the issuer's KYC portal.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "address": { "description": "Wallet address to check KYC status for.", "type": "string" }, "yieldId": { "description": "Yield ID from yields_get_all e.g. \"ethereum-ustb-securitize-rwa\".", "type": "string" } }, "required": [ "yieldId", "address" ], "type": "object" }, "outputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": {}, "properties": { "authorizeUrl": { "type": "string" }, "kycStatus": { "enum": [ "not_required", "not_started", "pending", "approved", "rejected" ], "type": "string" } }, "required": [ "kycStatus" ], "type": "object" }, "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": true, "readOnlyHint": true } }, { "name": "yield_get_api_spec", "title": "Fetch Yield.xyz OpenAPI Spec", "description": "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 operationIds for any endpoint. Accepts an optional `endpoint` filter (e.g. \"/v1/actions/enter\", \"/v1/yields/{yieldId}/validators\") and an optional `query` to search across paths. Returns structured field definitions, required flags, and all HTTP error codes for that endpoint. Use this instead of guessing field names — the spec is the ground truth. Also use this to look up: what errors can a specific endpoint return, what are the exact parameter constraints, what does a 400/403/422/429 response look like.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "endpoint": { "description": "Optional: filter to a specific path, e.g. \"/v1/actions/enter\" or \"/v1/yields/{yieldId}/validators\". Partial match works.", "type": "string" }, "method": { "default": "all", "description": "HTTP method filter. Default: all methods.", "enum": [ "get", "post", "put", "patch", "delete", "all" ], "type": "string" }, "query": { "description": "Optional: keyword search across path + operationId + summary. E.g. \"validator\", \"balances\", \"enter\".", "type": "string" }, "section": { "default": "all", "description": "What to return: \"endpoints\" for path+method details, \"schemas\" for component schemas, \"errors\" for all error codes across the spec, \"all\" for endpoints + errors. Component schemas are large, so \"all\" excludes them — request \"schemas\" explicitly.", "enum": [ "endpoints", "schemas", "errors", "all" ], "type": "string" } }, "type": "object" }, "annotations": { "openWorldHint": true, "readOnlyHint": true } }, { "name": "yield_lookup_docs", "title": "Search Yield.xyz Docs", "description": "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 links with title, section, and description. Pick the one or two most relevant results and read them with yield_fetch_doc. If nothing relevant is returned, use the other docs tools in this MCP (never the action tools). Use for: \"how does X work\", \"find docs on balances\", \"Solana signing format\", \"what fields does actions/enter accept\".", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "query": { "description": "Keywords or natural language question", "maxLength": 200, "minLength": 2, "type": "string" } }, "required": [ "query" ], "type": "object" }, "annotations": { "openWorldHint": true, "readOnlyHint": true } }, { "name": "yield_fetch_doc", "title": "Fetch Yield.xyz Doc Page", "description": "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 examples. Only accepts docs.yield.xyz URLs. Do NOT use this for live API calls or user transactions.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "url": { "description": "The .md URL from yield_lookup_docs, e.g. https://docs.yield.xyz/docs/actions.md", "type": "string" } }, "required": [ "url" ], "type": "object" }, "annotations": { "openWorldHint": false, "readOnlyHint": true } }, { "name": "yield_troubleshoot_error", "description": "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\", \"why did this fail\", or any error code or message from the API. For unrecognized errors, automatically looks up the live OpenAPI spec for the authoritative error shape.", "inputSchema": { "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "properties": { "context": { "description": "What endpoint was called, what arguments were passed", "type": "string" }, "error": { "description": "Error code, HTTP status, error message, or API response", "type": "string" } }, "required": [ "error" ], "type": "object" }, "annotations": { "openWorldHint": true, "readOnlyHint": true } }, { "name": "yield_list_repos", "title": "Yield.xyz Public Reference Repos", "description": "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, yield_get_api_spec, chain/transaction guides) do not give you enough to finish — then read the actual source code in these repos and base your answer on real, working code. Covers the staking/yield widget and a reference dApp, the SDK and API recipes, signing and transaction-security libraries, and an assets repo for token/provider logos. Returns each repo with a one-line description and how to fetch its raw files. Do NOT use for live data or user transactions — use the action tools for those.", "inputSchema": { "properties": {}, "type": "object" }, "annotations": { "openWorldHint": true, "readOnlyHint": true } } ], "schemaTokens": 14341, "changedAt": "2026-11-08T02:03:17.109840195Z", "check": { "checker": "anchor-check/1.0", "totalTokens": 14341, "counts": { "error": 0, "note": 1, "warn": 2 }, "findings": [ { "rule": "TC22", "severity": "warn", "tool": "actions_exit", "message": "the definition is about 1,667 tokens", "fix": "Trim the description and parameter docs, or split the tool." }, { "rule": "TC22", "severity": "warn", "tool": "yields_get", "message": "the definition is about 2,598 tokens", "fix": "Trim the description and parameter docs, or split the tool." }, { "rule": "TC24", "severity": "note", "message": "13 of 22 tools have no outputSchema", "fix": "Declare outputSchema for tools that return structured data, and return structuredContent that matches it." } ] } }, "updatedAt": "2026-11-09T02:11:39.146232408Z" }, "meta": { "attribution": "Anchor Terminal (https://www.anchorterminal.com)", "attributionRequired": true, "credit": "CC BY 4.0, credit Anchor Terminal and link the page or API address you took it from (https://www.anchorterminal.com/terms/#data)", "docs": "https://www.anchorterminal.com/docs/", "generatedAt": "2026-11-09", "license": "CC-BY-4.0", "live": true, "method": "https://www.anchorterminal.com/benchmark/", "methodology": "0.7", "note": "Live from anchor-server.", "openapi": "https://www.anchorterminal.com/openapi.json", "preview": false, "run": "2026-10-01", "runLabel": "October 2026 research run", "snapshotAt": "2026-11-09T02:14:36Z", "terms": "https://www.anchorterminal.com/terms/#data" }, "slug": "yield-xyz-mcp" }