Skip to main content
Glama

stocks

股票列表(基础信息)

Args: symbol: 证券代码(带后缀),如 000001.SZ name: 名称精确匹配 market: 市场类别(主板/创业板/科创板/北交所) list_status: 上市状态:L 上市 / D 退市 / P 暂停上市 exchange: 交易所:SSE 上交所 / SZSE 深交所 is_hs: 是否沪深港通标的:N 否 / H 沪股通 / S 深股通

Returns: JSON 数组;字段: symbol, name, area, industry, fullname, enname, cnspell, market, exchange, curr_type, list_status, list_date, delist_date, is_hs

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
nameNo名称精确匹配
is_hsNo是否沪深港通标的:N 否 / H 沪股通 / S 深股通
marketNo市场类别(主板/创业板/科创板/北交所)
symbolNo证券代码(带后缀),如 000001.SZ
exchangeNo交易所:SSE 上交所 / SZSE 深交所
list_statusNo上市状态:L 上市 / D 退市 / P 暂停上市

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
resultYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

C2.9/5.0
Behavior2/5

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

No annotations are provided, so the description must disclose behavioral traits. It discloses that the return is a JSON array with specific fields, which is useful. However, it does not mention whether filters are combined (AND), if at least one filter is required, if results are paginated or limited, or that it is a read-only operation. The behavioral info beyond the schema is minimal.

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

Conciseness5/5

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

The description is well-structured and concise: a short title, an Args list matching the schema, and a Returns section. It is front-loaded, easy to scan, and contains no unnecessary prose. The redundancy with the schema is acceptable and does not inflate length unnecessarily.

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

Completeness2/5

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

The output schema covers return values, but the description lacks important contextual details for an AI agent. It does not state that all parameters are optional, how filters interact, or whether calling with no filters returns the entire universe of stocks (which could be a huge response). It also does not explain the distinction from sibling tools, leaving the agent without enough context to choose this tool confidently.

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?

The input schema covers 100% of the parameters with descriptions, so the schema already documents parameter meaning. The description repeats the same parameter descriptions without adding extra semantics such as filter combination logic, default behavior, or value formatting beyond what is in the schema. Baseline of 3 applies.

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 description clearly identifies the tool as a stock list providing basic information, with a specific title '股票列表(基础信息)' and a Returns section defining the output fields. It is distinct from sibling tools like daily or fundamentals, although it does not explicitly name alternatives or state the scope (e.g., 'List all stocks matching filters').

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

Usage Guidelines2/5

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

The description provides no guidance on when to use this tool versus alternatives. It lists filter parameters but does not state whether this should be used for querying basic stock metadata, whether it is the default for lookup, or what scenarios are better suited for other sibling tools. There is no explicit when-to-use or when-not-to-use guidance.

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