Skip to main content
Glama

Crypto & Macro Market Data (Tanod)

get_protocol_tvl

Read-onlyIdempotent

chainpeek: Get protocol or chain TVL with 1d and 7d change. For fees and revenue use get_protocol_fees; for DEX volume use get_dex_volume. Returns the TVL of a protocol or chain with 1d and 7d change, the protocol's chains or the chain's largest protocols, or the largest chains and protocols, from Tanod's cache of DefiLlama data. Input: optional protocol, optional chain and limit; give one, both or neither. Cached DefiLlama data (refreshed every few hours), never live; as_of shows its age; an unknown name is a 422 with suggestions and a missing or over-2-day-old cache a 503 (neither charged). Informational only. Typically under 1 s (a local cache read). Price: USD 0.004. Free: 10 chain reads per IP per UTC day. Docs: https://tanod.dev/learn/defi-data-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_protocol_tvl"
  }
}

Input Schema

NameRequiredDescriptionDefault
chainNoChain name, e.g. Ethereum, Base, Solana, BSC, Arbitrum (common aliases such as bnb and eth work). With protocol: that protocol's TVL on the chain. Alone: the chain and its largest protocols.
limitNoRows in a ranking or a breakdown.
protocolNoProtocol name or slug, e.g. aave, uniswap-v3, lido (a parent such as aave sums its versions). Omit for a chain or the overview. An unknown name is a 422 with suggestions.

Output Schema

NameRequiredDescriptionDefault
noteNo
as_ofNo
chainNo
errorNoOnly on an error result: an object {code, message}, or the reason string of an x402 PaymentRequired object.
scopeNo
staleNo
reasonNo
sourceNo
protocolNo
top_chainsNo
other_matchesNo
top_protocolsNo
cache_age_hoursNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed12 schema fields changed
    • removedInput schema / properties / chain / default
      Removed value: -null
    • removedInput schema / properties / chain / title
      Removed value: -"Chain"
    • changedInput schema / properties / limit / description
      Previous value: -"Rows in a ranking or a breakdown, 1-50 (default 10)."New value: +"Rows in a ranking or a breakdown."
    • removedInput schema / properties / limit / title
      Removed value: -"Limit"
    • removedInput schema / properties / protocol / default
      Removed value: -null
    • removedInput schema / properties / protocol / title
      Removed value: -"Protocol"
    • removedInput schema / title
      Removed value: -"get_protocol_tvlArguments"
    • removedOutput schema / properties / chain / properties
      Removed value: -{
      -  "change_1d_pct": {
      -    "type": [
      -      "number",
      -      "null"
      -    ]
      -  },
      -  "change_7d_pct": {
      -    "type": [
      -      "number",
      -      "null"
      -    ]
      -  },
      -  "name": {
      -    "type": [
      -      "string",
      -      "null"
      -    ]
      -  },
      -  "rank": {
      -    "type": [
      -      "integer",
      -      "null"
      -    ]
      -  },
      -  "token_symbol": {
      -    "type": [
      -      "string",
      -      "null"
      -    ]
      -  },
      -  "tvl_usd": {
      -    "type": [
      -      "integer",
      -      "null"
      -    ]
      -  }
      -}
    • removedOutput schema / properties / other_matches / items
      Removed value: -{
      -  "type": [
      -    "string",
      -    "null"
      -  ]
      -}
    • removedOutput schema / properties / protocol / properties
      Removed value: -{
      -  "category": {
      -    "type": [
      -      "string",
      -      "null"
      -    ]
      -  },
      -  "chain_count": {
      -    "type": [
      -      "integer",
      -      "null"
      -    ]
      -  },
      -  "chains": {
      -    "items": {
      -      "properties": {
      -        "chain": {
      -          "type": [
      -            "string",
      -            "null"
      -          ]
      -        },
      -        "share_pct": {
      -          "type": [
      -            "number",
      -            "null"
      -          ]
      -        },
      -        "tvl_usd": {
      -          "type": [
      -            "integer",
      -            "null"
      -          ]
      -        }
      -      },
      -      "type": [
      -        "object",
      -        "null"
      -      ]
      -    },
      -    "type": [
      -      "array",
      -      "null"
      -    ]
      -  },
      -  "change_1d_pct": {
      -    "type": [
      -      "number",
      -      "null"
      -    ]
      -  },
      -  "change_7d_pct": {
      -    "type": [
      -      "number",
      -      "null"
      -    ]
      -  },
      -  "name": {
      -    "type": [
      -      "string",
      -      "null"
      -    ]
      -  },
      -  "slug": {
      -    "type": [
      -      "string",
      -      "null"
      -    ]
      -  },
      -  "tvl_on_chain_usd": {
      -    "type": [
      -      "integer",
      -      "null"
      -    ]
      -  },
      -  "tvl_usd": {
      -    "type": [
      -      "integer",
      -      "null"
      -    ]
      -  },
      -  "type": {
      -    "enum": [
      -      "protocol",
      -      "parent",
      -      null
      -    ]
      -  },
      -  "versions": {
      -    "items": {
      -      "properties": {
      -        "change_1d_pct": {
      -          "type": [
      -            "number",
      -            "null"
      -          ]
      -        },
      -        "change_7d_pct": {
      -          "type": [
      -            "number",
      -            "null"
      -          ]
      -        },
      -        "name": {
      -          "type": [
      -            "string",
      -            "null"
      -          ]
      -        },
      -        "slug": {
      -          "type": [
      -            "string",
      -            "null"
      -          ]
      -        },
      -        "tvl_usd": {
      -          "type": [
      -            "integer",
      -            "null"
      -          ]
      -        }
      -      },
      -      "type": [
      -        "object",
      -        "null"
      -      ]
      -    },
      -    "type": [
      -      "array",
      -      "null"
      -    ]
      -  }
      -}
    • removedOutput schema / properties / top_chains / items
      Removed value: -{
      -  "properties": {
      -    "change_1d_pct": {
      -      "type": [
      -        "number",
      -        "null"
      -      ]
      -    },
      -    "change_7d_pct": {
      -      "type": [
      -        "number",
      -        "null"
      -      ]
      -    },
      -    "name": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "rank": {
      -      "type": [
      -        "integer",
      -        "null"
      -      ]
      -    },
      -    "token_symbol": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "tvl_usd": {
      -      "type": [
      -        "integer",
      -        "null"
      -      ]
      -    }
      -  },
      -  "type": [
      -    "object",
      -    "null"
      -  ]
      -}
    • removedOutput schema / properties / top_protocols / items
      Removed value: -{
      -  "properties": {
      -    "category": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "chain_count": {
      -      "type": [
      -        "integer",
      -        "null"
      -      ]
      -    },
      -    "chains": {
      -      "items": {
      -        "properties": {
      -          "chain": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "share_pct": {
      -            "type": [
      -              "number",
      -              "null"
      -            ]
      -          },
      -          "tvl_usd": {
      -            "type": [
      -              "integer",
      -              "null"
      -            ]
      -          }
      -        },
      -        "type": [
      -          "object",
      -          "null"
      -        ]
      -      },
      -      "type": [
      -        "array",
      -        "null"
      -      ]
      -    },
      -    "change_1d_pct": {
      -      "type": [
      -        "number",
      -        "null"
      -      ]
      -    },
      -    "change_7d_pct": {
      -      "type": [
      -        "number",
      -        "null"
      -      ]
      -    },
      -    "name": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "slug": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "tvl_on_chain_usd": {
      -      "type": [
      -        "integer",
      -        "null"
      -      ]
      -    },
      -    "tvl_usd": {
      -      "type": [
      -        "integer",
      -        "null"
      -      ]
      -    },
      -    "type": {
      -      "enum": [
      -        "protocol",
      -        "parent",
      -        null
      -      ]
      -    },
      -    "versions": {
      -      "items": {
      -        "properties": {
      -          "change_1d_pct": {
      -            "type": [
      -              "number",
      -              "null"
      -            ]
      -          },
      -          "change_7d_pct": {
      -            "type": [
      -              "number",
      -              "null"
      -            ]
      -          },
      -          "name": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "slug": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "tvl_usd": {
      -            "type": [
      -              "integer",
      -              "null"
      -            ]
      -          }
      -        },
      -        "type": [
      -          "object",
      -          "null"
      -        ]
      -      },
      -      "type": [
      -        "array",
      -        "null"
      -      ]
      -    }
      -  },
      -  "type": [
      -    "object",
      -    "null"
      -  ]
      -}
  2. Added

TDQS

A4.8/5.0
Behavior5/5

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

Goes well past readOnlyHint/openWorldHint: discloses the data is cached and refreshed every few hours, never live, with `as_of` exposing staleness. It also documents failure modes precisely (422 with suggestions for unknown names, 503 for missing or >2-day-old cache, neither charged), latency (~1 s local cache read), and pricing ($0.004, 10 free chain reads/IP/UTC day).

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?

Front-loaded with purpose and sibling routing, then behavior, then cost/docs. Slight redundancy: the 1d/7d TVL scope is stated twice ('Get protocol or chain TVL with 1d and 7d change' and again as 'Returns the TVL of...'), which could be collapsed into one sentence.

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?

An output schema exists, so return shapes need not be described. Given that, the description covers everything an agent needs to call correctly: optional-parameter combinations, cache staleness, error codes and their billing implications, latency, and cost.

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

Parameters4/5

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

Schema coverage is 100%, so the per-parameter meanings are already documented, and the description wisely does not re-explain them. It does add a cheap synthesis the schema only implies across three fields: all parameters are optional and any combination ('one, both or neither') is valid, with `limit` governing both rankings and breakdowns.

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?

States a specific verb and resource ('Get protocol or chain TVL with 1d and 7d change') and immediately names the two nearest siblings it is not (get_protocol_fees for fees/revenue, get_dex_volume for DEX volume). An agent can select it without opening the 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?

Explicit routing: 'For fees and revenue use get_protocol_fees; for DEX volume use get_dex_volume,' plus a shape rule for the inputs ('give one, both or neither'). It also marks the tool as informational only, which tells the agent not to treat output as actionable.

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.