Skip to main content
Glama
leewhite97

xueqiu-mcp

by leewhite97

添加自选基金

add_watchlist_fund
Idempotent

Add a fund to your default Xueqiu watchlist group. Supports public (F) and private (P) fund codes with a valid login.

Instructions

将一只基金加入当前用户的自选基金默认分组。需要有效登录态。公募基金代码以 F 开头,私募基金代码以 P 开头。

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
symbolYes基金代码,如 F161039(公募)、P000700(私募)

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
successYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observedv2.0.0

TDQS

A4.1/5.0
Behavior4/5

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

注解已声明非只读、非破坏性且幂等,描述额外补充了'需要有效登录态'和公募/私募代码前缀规则,这些是注解未覆盖且对调用成功至关重要的行为前提。虽未提及重复添加的具体表现,但幂等性已由注解覆盖,整体透明。

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?

两句话完成核心操作声明、前置条件和代码规则说明,无冗余内容,信息密度高且重点前置。

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?

工具为单参数简单操作,且存在输出schema,描述已覆盖操作目的、登录前提和代码格式要求,对于正确调用没有缺失的必要信息。

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已100%覆盖symbol的含义并给出了示例,描述中的代码前缀规则与schema示例一致,未提供超越schema的新信息。依据高覆盖率基线,评分为3。

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?

描述以动词'加入'明确说明操作对象是基金和自选基金默认分组,与兄弟工具add_watchlist_stock、add_watchlist_cube形成清晰区分。同时补充了登录态和代码前缀规则,无歧义。

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?

描述隐含了添加基金时应使用此工具,且通过'需要有效登录态'给出使用前提,但未明确说明与add_watchlist_stock等替代工具的选用条件或排除场景。仍属隐含用法,缺少显式指引。

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.