Skip to main content
Glama

Feegate AI Agent data marketplace catalog & platform metrics

dex-liquidity.pool_summary

Read-onlyIdempotent

Ask "how deep is the liquidity for this token" — free: pool count, best pool price, liquidity, 24h volume. | 免费档:返回代币符号、DEX 池子总数、最优池(DEX 名、交易对、价格、流动性 USD、24h 量)。参数 address 必填、chain 与 size_usd 可选。

[zh] 供应方资产「DEX 池子深度与冲击成本」免费(每日限额按调用方计)。 入参:address、chain、size_usd。 [en] Vendor asset "DEX 池子深度与冲击成本". Free (daily per-caller quota). Args: address, chain, size_usd. 付款/支付头在 MCP 请求头里带(X-Payment / X-Payment-Tx / Authorization: Bearer fg_…),不要放进参数。

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "address": "<address>"
    },
    "name": "dex-liquidity.pool_summary"
  }
}

Input Schema

NameRequiredDescriptionDefault
chainNo
addressYes
size_usdNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Added

TDQS

B3.4/5.0
Behavior4/5

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

The annotations already declare this is a read-only, idempotent, non-destructive, open-world call. The description adds material context beyond that: the free tier is subject to a daily per-caller quota, and payment credentials must travel in MCP headers (X-Payment / X-Payment-Tx / Bearer fg_…) rather than in parameters. That auth and quota detail is exactly what annotations cannot convey. It omits any note on error or quota-exhaustion behavior, so it is not a 5.

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

Conciseness2/5

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

The same content is restated three times: an English summary, a [zh] line, and an [en] line that nearly duplicates the opening paragraph. The high-value operational note about payment headers is buried in the final sentence rather than front-loaded. This redundancy is not conciseness; it is duplication, and it dilutes the parts that matter.

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

Completeness3/5

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

For a three-parameter read-only tool with no output schema, the definition does cover returns, quota, and auth placement, which is a reasonable baseline. What is missing is the chain identifier vocabulary and any detail on how size_usd changes the response, both of which an agent needs to call this correctly on the first attempt.

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 coverage is 0%, so the description carries the burden, and it does identify address as required and chain/size_usd as optional. The Chinese vendor-asset phrasing ('DEX 池子深度与冲击成本', i.e. depth and impact cost) implies size_usd is the trade size used for slippage/impact estimation, which is genuinely beyond the bare schema. Still, the accepted chain values and format are never explained, leaving a real gap at this coverage level.

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

Purpose4/5

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

The opening line names a concrete question the tool answers (liquidity depth for a token) and enumerates the returned fields: pool count, best pool price, liquidity, and 24h volume. That is far more specific than a restated name. It does not differentiate itself from the sibling dex-liquidity.depth_report, which appears to overlap, so it falls short of a 5.

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

Usage Guidelines3/5

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

The phrase 'Ask "how deep is the liquidity for this token"' frames the intended use, and the definition notes that this is a free tier with a daily per-caller quota, which guides cost-sensitive callers. However, it never states when to choose this over depth_report or the other dex/dex-volume siblings, and it offers no exclusion criteria, so the guidance is implied rather than explicit.

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.