MCP（AI 客户端） {#mcp}
MCP 用于在你自己使用的 AI 客户端里直接查行情（实时、K 线、涨停等）。配置写在客户端本地或设置页，不是写在我们服务器上；调用仍走同一套 API Key、scope、限流。
远程端点： http://market-api.cn/mcp（Streamable HTTP）
配置步骤
- 在用户中心签发 API Key（
tg_...） - 在 MCP 客户端中添加远程服务（见下方 JSON；各产品入口见门户
/docs/mcp页的「兼容客户端」表） - 保存并刷新 MCP 连接，在对话中提问，例如「查 600519.SS 最近 20 根日 K」
说明： 只有支持 MCP 的客户端才能接入。无法安装 MCP 时，请用 Agent Skill（教 Agent 走 REST），或 REST API，或将 llms-full.txt 作为上下文交给模型阅读。
鉴权
与 REST 相同，任选其一：
- Header：
X-API-Key: tg_xxx - Header：
Authorization: Bearer tg_xxx - Query：
?token=tg_xxx或?api_key=tg_xxx
配置 JSON
Header 传 Key（推荐）：
{
"mcpServers": {
"klineshare": {
"url": "http://market-api.cn/mcp",
"headers": { "X-API-Key": "tg_你的密钥" }
}
}
}Query 传 Key：
{
"mcpServers": {
"klineshare": {
"url": "http://market-api.cn/mcp?token=tg_你的密钥"
}
}
}四种接入方式对比
| 方式 | 作用 |
|---|---|
/v1/* REST | 程序、脚本、用户中心沙箱 |
llms-full.txt | 让模型读懂接口与参数（@Docs、粘贴上下文） |
/mcp | 让已配置 MCP 的客户端自动调工具查数据 |
| Agent Skill | 不支持 MCP 时，教 Agent 用 REST 查数（可与 MCP 并存） |
可用工具
get_health、get_my_permissions、get_realtime、get_trend、get_kline_v2（K 线 v2）、get_kline（过时）、get_index_realtime、get_index_trend、get_index_kline_v2（K 线 v2）、get_index_kline（过时）、get_stock、search_stocks、list_stocks、get_corp、get_finance_report、get_calendar、get_limit_up、get_limit_up_break、get_limit_down_pool、get_yesterday_limit_up、get_limit_up_ladder、get_limit_up_plates_trending、get_limit_up_plates_industry、get_limit_up_plates_concept、get_limit_up_plates_style、get_lhb、get_lhb_daily、get_lhb_stock、get_lhb_dates、get_lhb_stats、get_hot_money、get_hot_money_by_seat、get_moneyflow_daily_trend、get_moneyflow_stage、get_moneyflow_distribution、get_market_indices、search_indices、get_public_catalog，及 ETF 系列 get_etf、search_etfs、get_etf_realtime、get_etf_trend、get_etf_kline_v2（K 线 v2）、get_etf_kline（过时）（开通状态见 GET /v1/me）。
配置后在对话中直接提问即可触发工具；调用计入与普通 REST 相同的 scope 与限流。