Skip to main content
Glama

Crypto & Macro Market Data (Tanod)

get_stablecoin_supply

Read-onlyIdempotent

chainpeek: Get stablecoin supply by coin and chain. For whether a coin holds its peg use check_stablecoin_peg. Returns stablecoin supply by coin and chain with 1d, 7d and 30d change: a coin's chains, a chain's coins, or the largest coins and chains, from Tanod's cache of DefiLlama data. Input: optional coin, 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.003. 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_stablecoin_supply"
  }
}

Input Schema

NameRequiredDescriptionDefault
coinNoStablecoin symbol or name, e.g. USDT, USDC, DAI, USDe, PYUSD (symbols shared by several coins return each). Omit for a chain or the overview. An unknown coin is a 422 with suggestions.
chainNoChain name, e.g. Ethereum, Tron, Solana, Base. With coin: that coin's supply on the chain. Alone: the chain's stablecoin supply and its largest coins.
limitNoRows in a ranking or a breakdown.

Output Schema

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

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed11 schema fields changed
    • removedInput schema / properties / chain / default
      Removed value: -null
    • removedInput schema / properties / chain / title
      Removed value: -"Chain"
    • removedInput schema / properties / coin / default
      Removed value: -null
    • removedInput schema / properties / coin / title
      Removed value: -"Coin"
    • 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 / title
      Removed value: -"get_stablecoin_supplyArguments"
    • removedOutput schema / properties / chain / properties
      Removed value: -{
      -  "change_1d_pct": {
      -    "type": [
      -      "number",
      -      "null"
      -    ]
      -  },
      -  "change_30d_pct": {
      -    "type": [
      -      "number",
      -      "null"
      -    ]
      -  },
      -  "change_7d_pct": {
      -    "type": [
      -      "number",
      -      "null"
      -    ]
      -  },
      -  "coin_count": {
      -    "type": [
      -      "integer",
      -      "null"
      -    ]
      -  },
      -  "name": {
      -    "type": [
      -      "string",
      -      "null"
      -    ]
      -  },
      -  "total_usd": {
      -    "type": [
      -      "integer",
      -      "null"
      -    ]
      -  }
      -}
    • removedOutput schema / properties / coins / items
      Removed value: -{
      -  "properties": {
      -    "chain_count": {
      -      "type": [
      -        "integer",
      -        "null"
      -      ]
      -    },
      -    "chains": {
      -      "items": {
      -        "properties": {
      -          "chain": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "change_1d_pct": {
      -            "type": [
      -              "number",
      -              "null"
      -            ]
      -          },
      -          "change_30d_pct": {
      -            "type": [
      -              "number",
      -              "null"
      -            ]
      -          },
      -          "change_7d_pct": {
      -            "type": [
      -              "number",
      -              "null"
      -            ]
      -          },
      -          "circulating_usd": {
      -            "type": [
      -              "integer",
      -              "null"
      -            ]
      -          },
      -          "share_pct": {
      -            "type": [
      -              "number",
      -              "null"
      -            ]
      -          }
      -        },
      -        "type": [
      -          "object",
      -          "null"
      -        ]
      -      },
      -      "type": [
      -        "array",
      -        "null"
      -      ]
      -    },
      -    "change_1d_pct": {
      -      "type": [
      -        "number",
      -        "null"
      -      ]
      -    },
      -    "change_30d_pct": {
      -      "type": [
      -        "number",
      -        "null"
      -      ]
      -    },
      -    "change_7d_pct": {
      -      "type": [
      -        "number",
      -        "null"
      -      ]
      -    },
      -    "circulating": {
      -      "type": [
      -        "number",
      -        "null"
      -      ]
      -    },
      -    "circulating_usd": {
      -      "type": [
      -        "integer",
      -        "null"
      -      ]
      -    },
      -    "mechanism": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "name": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "peg": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "price_usd": {
      -      "type": [
      -        "number",
      -        "null"
      -      ]
      -    },
      -    "share_pct": {
      -      "type": [
      -        "number",
      -        "null"
      -      ]
      -    },
      -    "symbol": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    }
      -  },
      -  "type": [
      -    "object",
      -    "null"
      -  ]
      -}
    • removedOutput schema / properties / market / properties
      Removed value: -{
      -  "change_1d_pct": {
      -    "type": [
      -      "number",
      -      "null"
      -    ]
      -  },
      -  "change_30d_pct": {
      -    "type": [
      -      "number",
      -      "null"
      -    ]
      -  },
      -  "change_7d_pct": {
      -    "type": [
      -      "number",
      -      "null"
      -    ]
      -  },
      -  "coin_count": {
      -    "type": [
      -      "integer",
      -      "null"
      -    ]
      -  },
      -  "total_usd": {
      -    "type": [
      -      "integer",
      -      "null"
      -    ]
      -  }
      -}
    • removedOutput schema / properties / top_chains / items
      Removed value: -{
      -  "properties": {
      -    "change_1d_pct": {
      -      "type": [
      -        "number",
      -        "null"
      -      ]
      -    },
      -    "change_30d_pct": {
      -      "type": [
      -        "number",
      -        "null"
      -      ]
      -    },
      -    "change_7d_pct": {
      -      "type": [
      -        "number",
      -        "null"
      -      ]
      -    },
      -    "name": {
      -      "type": [
      -        "string",
      -        "null"
      -      ]
      -    },
      -    "share_pct": {
      -      "type": [
      -        "number",
      -        "null"
      -      ]
      -    },
      -    "total_usd": {
      -      "type": [
      -        "integer",
      -        "null"
      -      ]
      -    }
      -  },
      -  "type": [
      -    "object",
      -    "null"
      -  ]
      -}
  2. Added

TDQS

A4.6/5.0
Behavior4/5

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

Goes well beyond the annotations with cache freshness (refreshed every few hours, never live), an as_of age indicator, explicit failure modes (422 with suggestions for unknown names, 503 for stale/missing cache, neither charged), sub-second latency, price, and a free-tier quota. The one notable omission is pagination/truncation behavior given the limit parameter.

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-loads the core purpose and the sibling exclusion, then packs behavioral detail efficiently. It is dense and slightly run-on toward the end (errors, latency, price, quota, docs URL in one stream), but nearly every clause carries operational value.

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 values needn't be explained; the description instead covers what the schema cannot — data provenance, staleness semantics, error codes with cost implications, and billing. That is complete for a cached read-only lookup tool.

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 baseline is 3, but the description adds combinatorial meaning the schema only implies in scattered form: a coin's chains, a chain's coins, or the largest coins and chains. It reinforces that coin and chain are individually optional and can be combined.

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 stablecoin supply by coin and chain') and immediately distinguishes itself from the sibling check_stablecoin_peg, which answers a different question. It also enumerates the three result shapes returned, so an agent knows exactly what it gets.

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?

Explicitly routes peg questions to check_stablecoin_peg and explains the selection logic for its own parameters ('give one, both or neither'), noting what each combination returns. The only mild gap is that it doesn't say when to prefer this over a broader supply tool like get_total_supply.

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.