List covered tickers
list_tickersEvery ticker symbol in the Gold Silver Analytics free-subset coverage universe (~279), plus the count. Symbols only — no scores.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
list_tickersEvery ticker symbol in the Gold Silver Analytics free-subset coverage universe (~279), plus the count. Symbols only — no scores.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
The readOnlyHint and openWorldHint annotations already establish safety and world-dependence, but the description adds useful behavioral details: it returns every symbol in a specifically bounded universe, includes a count, and excludes scores. This goes beyond the annotations by clarifying the exact output content and scope.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is two short sentences, with no wasted words. It front-loads the core action ('Every ticker symbol...') and packs in scope, count, and exclusion of scores efficiently.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a no-parameter, no-output-schema list tool, the description conveys the key output aspects: the full set of covered tickers, the approximate count, and that scores are not included. It is complete enough for an agent to know what to expect, though it does not specify the exact return structure (e.g., separate count field vs. count in the list).
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The tool has zero parameters, so the baseline for this dimension is 4 per the rubric. The description appropriately focuses on the output semantics rather than parameters, and no additional parameter information is needed.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool lists every ticker symbol in the Gold Silver Analytics free-subset coverage universe (~279), plus a count, and explicitly notes it returns symbols only, not scores. This distinguishes it from siblings like get_rr_score and search_tickers by specifying the resource (all covered tickers) and scope (free subset).
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies when to use this tool (when you need the full list of covered tickers) but does not explicitly name alternatives or state when not to use it. The phrase 'Symbols only — no scores' hints that other tools handle scores, but this guidance is not explicit.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Add one secure layer between your agents and this server.
Each tool has a clearly distinct purpose: get_rr_score provides detailed analysis for a specific ticker, get_screen_data offers filterable/rankable cross-sectional data, list_tickers simply enumerates all symbols, and search_tickers performs fuzzy lookup. There is no functional overlap between these operations.
All four tools follow a consistent verb_noun snake_case pattern: get_, get_, list_, search_. The naming is uniform and predictable, making it easy for an agent to infer the action and resource for each tool.
Four tools is well-scoped for a specialized analytics server. The set covers the essential operations—single-asset deep dive, screening, directory listing, and search—without unnecessary bloat or missing core functionality.
The tool surface is complete for the stated domain of free-subset precious-metals analytics. Users can discover the universe (list_tickers), locate specific companies (search_tickers), get detailed 9-factor scores (get_rr_score), and perform structured screening (get_screen_data). No obvious gaps or dead ends are apparent.