Skip to main content
Glama

token_report

Everything an agent needs before touching a Base token, in one call: the deterministic safety card (contract, ownership, holder concentration, market, honeypot simulation, rule-based risk flags and a 0-100 score), the DefiLlama pools its symbol appears in with their TVL and APY, a sourced brief on the project written from its own site and Wikipedia with verbatim quotes (or none, when nothing verifiable is found), and a written verdict — avoid, caution or acceptable — whose reasons must each name a field of this report, checked in code, and whose verdict is overruled when it contradicts the risk score. Ask an optional question and it is answered from the same data. Informational only, not investment advice. Price $1.00 per call, paid with USDC over x402.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
addressYesa Base (chain id 8453) token contract address
questionNooptional question about this token, at most 300 characters, answered from the report's own data

Schema Changelog

Changes observed during successful MCP inspections.

  1. Added

TDQS

A4.1/5.0
Behavior4/5

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

Since no annotations are provided, the description carries the full burden of behavioral disclosure, and it does so thoroughly: it is 'informational only, not investment advice', costs exactly $1.00 paid via USDC over x402, returns 'none when nothing verifiable is found', and explains the verification override rule. This kind of pricing and self-verification transparency is genuinely useful and goes beyond the structured fields.

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?

The description is dense and front-loaded with its purpose, then expands into the report components, constraints, and pricing. It is written as one long, slightly unwieldy sentence, but nearly every clause supplies a distinct useful fact — components, sourcing rules, verdict constraints, and cost. There is virtually no filler.

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

Completeness4/5

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

With no output schema and no annotations, the description must explain what the call returns, and it does — safety card fields, pools with TVL and APY, a sourced brief, a verdict, and an optional answer. It also clarifies what the call costs and what its informational limitations are. It does not cover error cases or invalid addresses, but the schema pattern and small two-parameter surface make that non-critical.

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 100%, and the schema already describes both parameters — address as a Base token contract address and question as optional and answered from the report's own data. The description adds little beyond that, restating the optional question behavior and the 8453 chain implicitly through 'Base'. This is an appropriate baseline-3 case where 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?

States a specific operation — generate a comprehensive report on a Base token — and enumerates the concrete deliverables: safety card, DefiLlama pools, sourced brief, written verdict, and risk score. The 'everything … in one call' framing differentiates it from narrower siblings like token_check, token_info, and yield_report. Clear and unambiguous.

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

Usage Guidelines4/5

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

The description explicitly scopes usage with 'before touching a Base token, in one call' and mentions the optional question and the $1.00 cost model, which helps an agent decide when to invoke it. It does not, however, name sibling tools or state when not to use it, such as when a simpler check like token_check would suffice. Clear context, but no exclusions or alternatives are given.

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.

Resources