Skip to main content
Glama

Crypto & Macro Market Data (Tanod)

get_lending_yields

Read-onlyIdempotent

chainpeek: Use when an agent must choose where to lend or borrow: supply and borrow APY on Aave, Compound and Morpho. For protocol TVL use get_protocol_tvl; for perp funding use get_funding_rates. Returns current lending supply and borrow APY on Aave V3, Compound V3 and Morpho by chain and asset, or the best stablecoin supply rate (USDC, USDT, DAI, USDS, USDe) across them. Snapshot refreshed about every 5 minutes (as_of, stale); Aave, Compound and Morpho on Ethereum, Base, Arbitrum, Optimism and Polygon; APY excludes rewards. Informational only, not investment advice. Bad input is a 422 (not charged). Typically under 1 s. Price: USD 0.001. Free: 10 chain reads per IP per UTC day. Docs: https://tanod.dev/learn/defi-lending-rates-api.html

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "get_lending_yields"
  }
}

Input Schema

NameRequiredDescriptionDefault
viewNoall: every matching rate, highest supply APY first. best_stablecoin: USDC, USDT, DAI, USDS and USDe ranked by supply APY across the three protocols (canonical token addresses only).all
limitNoRows returned.
assetsNoAsset symbols such as USDC or WETH (case-insensitive, at most 20). In best_stablecoin only USDC, USDT, DAI, USDS and USDe are ranked.
chainsNoSubset of ethereum, base, arbitrum, polygon, optimism. Default: all. Aave V3, Compound V3 and Morpho cover all five.
protocolsNoSubset of aave_v3, compound_v3, morpho. Default: all.
min_tvl_usdNoOnly rows with at least this many USD supplied (rows with an unknown USD size are dropped when it is above 0). Default 0; best_stablecoin defaults to 1,000,000.

Output Schema

NameRequiredDescriptionDefault
noteNo
rowsNo
viewNo
age_sNo
as_ofNo
countNo
errorNoOnly on an error result: an object {code, message}, or the reason string of an x402 PaymentRequired object.
staleNo
sourcesNo
coverageNo
apy_basisNo
max_age_sNo
sorted_byNo
min_tvl_usdNo
stablecoinsNo
best_by_assetNo
total_matchingNo
refresh_interval_sNo
sources_unavailableNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed21 schema fields changed
    • removedInput schema / properties / assets / default
      Removed value: -null
    • changedInput schema / properties / assets / description
      Previous value: -"Optional asset symbols such as USDC or WETH (case-insensitive, at most 20). In best_stablecoin only USDC, USDT, DAI, USDS and USDe are ranked."New value: +"Asset symbols such as USDC or WETH (case-insensitive, at most 20). In best_stablecoin only USDC, USDT, DAI, USDS and USDe are ranked."
    • removedInput schema / properties / assets / title
      Removed value: -"Assets"
    • removedInput schema / properties / chains / default
      Removed value: -null
    • changedInput schema / properties / chains / description
      Previous value: -"Optional subset of ethereum, base, arbitrum, polygon, optimism. Default: all. Aave V3, Compound V3 and Morpho cover all five."New value: +"Subset of ethereum, base, arbitrum, polygon, optimism. Default: all. Aave V3, Compound V3 and Morpho cover all five."
    • removedInput schema / properties / chains / title
      Removed value: -"Chains"
    • changedInput schema / properties / limit / description
      Previous value: -"Rows returned, 1-200 (default 50)."New value: +"Rows returned."
    • removedInput schema / properties / limit / title
      Removed value: -"Limit"
    • removedInput schema / properties / min_tvl_usd / default
      Removed value: -null
    • removedInput schema / properties / min_tvl_usd / title
      Removed value: -"Min Tvl Usd"
    • removedInput schema / properties / protocols / default
      Removed value: -null
    • changedInput schema / properties / protocols / description
      Previous value: -"Optional subset of aave_v3, compound_v3, morpho. Default: all."New value: +"Subset of aave_v3, compound_v3, morpho. Default: all."
    • removedInput schema / properties / protocols / title
      Removed value: -"Protocols"
    • removedInput schema / properties / view / title
      Removed value: -"View"
    • removedInput schema / title
      Removed value: -"get_lending_yieldsArguments"
    • removedOutput schema / properties / best_by_asset / additionalProperties
      Removed value: -{
      -  "properties": {
      -    "chain": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "kind": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "name": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "protocol": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "supplied_usd": {
      -      "type": [
      -        "number",
      -        "null"
      -      ]
      -    },
      -    "supply_apy_pct": {
      -      "type": [
      -        "number",
      -        "null"
      -      ]
      -    }
      -  },
      -  "type": [
      -    "object",
      -    "null"
      -  ]
      -}
    • removedOutput schema / properties / coverage / additionalProperties
      Removed value: -{
      -  "items": {
      -    "type": [
      -      "string",
      -      "null"
      -    ]
      -  },
      -  "type": [
      -    "array",
      -    "null"
      -  ]
      -}
    • removedOutput schema / properties / rows / items
      Removed value: -{
      -  "properties": {
      -    "asset": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "asset_address": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "borrow_apy_pct": {
      -      "type": [
      -        "number",
      -        "null"
      -      ]
      -    },
      -    "borrowed_usd": {
      -      "type": [
      -        "number",
      -        "null"
      -      ]
      -    },
      -    "chain": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "collateral": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "id": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "kind": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "name": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "protocol": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "rank": {
      -      "type": [
      -        "integer",
      -        "null"
      -      ]
      -    },
      -    "stablecoin": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "supplied_usd": {
      -      "type": [
      -        "number",
      -        "null"
      -      ]
      -    },
      -    "supply_apy_pct": {
      -      "type": [
      -        "number",
      -        "null"
      -      ]
      -    },
      -    "supply_apy_with_rewards_pct": {
      -      "type": [
      -        "number",
      -        "null"
      -      ]
      -    },
      -    "utilization": {
      -      "type": [
      -        "number",
      -        "null"
      -      ]
      -    }
      -  },
      -  "type": [
      -    "object",
      -    "null"
      -  ]
      -}
    • removedOutput schema / properties / sources / items
      Removed value: -{
      -  "properties": {
      -    "age_s": {
      -      "type": [
      -        "integer",
      -        "null"
      -      ]
      -    },
      -    "as_of": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "chain": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "docs": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "name": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "protocol": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "stale": {
      -      "type": [
      -        "boolean",
      -        "null"
      -      ]
      -    },
      -    "truncated": {
      -      "type": [
      -        "boolean",
      -        "null"
      -      ]
      -    },
      -    "url": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    }
      -  },
      -  "type": [
      -    "object",
      -    "null"
      -  ]
      -}
    • removedOutput schema / properties / sources_unavailable / items
      Removed value: -{
      -  "properties": {
      -    "chain": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "protocol": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "reason": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    }
      -  },
      -  "type": [
      -    "object",
      -    "null"
      -  ]
      -}
    • removedOutput schema / properties / stablecoins / items
      Removed value: -{
      -  "type": [
      -    "string",
      -    "null"
      -  ]
      -}
  2. Added

TDQS

A4.4/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnly/idempotent/non-destructive/open-world, so the safety profile needs no restating. The description adds genuinely new behavior: a ~5 minute snapshot cadence with `as_of` and `stale` markers, APY that excludes rewards, 422 on bad input with no charge, sub-second latency, price and a 10-read/IP/day free tier. These are exactly the operational traits an agent needs before calling, though it does not describe sorting/pagination of results beyond limits.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Purpose and the two alternative routes are front-loaded in the first two sentences, then coverage, freshness and pricing follow in compact parentheticals. 'Informational only, not investment advice' and the docs URL are marginal for an agent deciding whether to call, so it is not perfectly lean.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a six-parameter, all-optional, read-only query tool with a full schema and an output schema, the description covers purpose, scope, freshness, cost and failure mode. Nothing an agent needs to invoke it correctly is missing, and return-value shape is rightly left to the output schema.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100% and every parameter, including the enum values for `view` and the best_stablecoin min_tvl default, is fully documented in the schema itself. The description restates protocol, chain and stablecoin coverage that the schema already carries, adding no format or edge-case detail beyond it. Baseline 3 applies when the schema does the heavy lifting.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description names a specific resource (lending supply and borrow APY) and the exact protocols (Aave V3, Compound V3, Morpho), plus the alternate view (best stablecoin rate). It also names two sibling tools it is not (get_protocol_tvl, get_funding_rates), so the agent can distinguish it without opening a schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It opens with the decision the tool serves ('when an agent must choose where to lend or borrow') and routes two adjacent needs to named alternatives. The one remaining ambiguity, when to pick view=best_stablecoin over view=all, is clarified in the description body and the schema rather than left to inference.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.