Toolpin Monitor a server

EchoPai (回声投研)

io.github.echopai/echopai-mcp · v1.0.1 · MCP 2025-11-25

China equity & quantitative research MCP server with 50 tools for reports, filings & sentiment.

Reachability reachable
checked 2026-11-21 05:36 UTC
Registry status active
Tools pinned 76
78e20dcc8fa9
Tools last changed 2026-11-21
Repo last push 2026-11-15
as of 2026-11-21
GitHub stars 1
as of 2026-11-21

Provenance

Registry namespace io.github.echopai (GitHub-account verified by the official registry)
Repository github.com/echopai/echopai-mcp
Website https://echopai.com
Remote endpoints
https://mcp.huishengpai.com/mcp (streamable-http)

Observed changes

When (UTC)EventDetail
2026-11-21 05:36 tools changed 4 added, 10 removed, 72 changed
2026-11-19 05:34 tools changed 0 added, 0 removed, 6 changed
2026-11-16 05:31 first capture 82 tools pinned

Pinned tool definitions (76)

ToolDescription
lookup SHAPE: `{matches: [{canonical_code, name_cn, ticker, exchange}], count}` — the row container is `matches`, not `items`, and the name field is `name_cn`. Resolve a Chinese name / A-share code / pinyin initials to canonical codes (e.g....
security_reference 按规范代码查询证券参考详情,当前仅接入港股,CN/US 预留:ISIN、币种、每手股数、双柜台关联及身份核验状态。source 包含来源、版本、源日期、观测时间和最后成功检查时间;stale=null 表示未知。collection_eligible 仅为参考资格,不代表报价已启用。listing_status/trading_status=unknown 不可解释为正常交易。
market_calendar 按显式 market 查询交易日历,支持 CN(上交所日历)与 HK,US 预留。含完整交易日、半日市及休市日。最多 366 天,days 为含首尾日期的列表。calendar_known=false 或 is_open=null 表示未覆盖,不能按工作日推测。is_settlement_day=null 表示交收属性未知。CN 的 observed_at 为所查记录最近写入时间,HK 提供发布版本和最后成功检查时间。
market_clock 按显式 market 查询市场阶段,当前仅接入 HK,CN/US 预留且不回退。含半日市、竞价、午休及人工例外;省略 at 使用服务端当前时间。at 必须带时区,返回所选市场的 IANA 时区时间。trading_profile=index 只表示相关市场阶段,指数计算时段未核验。午间扩展交易须提供有已核验资格的证券代码。actual_end_unknown=true 表示随机结束时点未知,null 表示日历或阶段未知;不存在的具体证券返回...
market_indices 按显式 market 查询指数目录,当前仅接入 HK,CN/US 预留且不回退。港股包含:恒生、国企、恒生科技、红筹、综合指数。items 行标识为 canonical_code;registry_revision 为随代码维护的注册表版本,不能视为实时行情源日期。quote_enabled/chart_enabled=false 表示报价和图表未启用。
digest One-shot research digest for one security: views (PRIMARY), quote, valuation snapshot, market sentiment, supplementary news, ownership_events (30-day insider trades + buybacks, next-30-day lockups) and margin (~7 trading days). Margin...
search Structured-first hybrid search across analyst views + news (views weighted higher). Three lanes — entity (company codes / names, analyst names), concept-graph hub (theme alias → concept → constituents & research), and full-text keyword...
quote Real-time quote for 1-200 A-share securities (last price, volume, change %, bid/ask). For >200 codes use `scan`. HK codes are not supported; for an A+H company use the A-share canonical (SSE:601398, not HK:01398). Rows also carry...
market_status Current A-share session state. `session` ∈ `pre_open` (09:00-09:14) / `auction` (09:15-09:29) / `open` / `break` (lunch) / `closed`, same enum as `quote`. **Read `session`, not `is_market_open` / `is_premarket`** — both are false at...
market_movers A-share top-N movers from the live snapshot (or a past trading day via `date`). Sort keys: `pct` / `pct_asc` / `speed` / `amount` / `turnover` / `total_mv` / `main_net_in` / `main_net_in_asc`; rows with a null sort value land last in...
market_digest One call for the whole board: session, 6 core indices, breadth + turnover, limit-up premium & ladder (with promotion rate), top concepts / industries and top 10 stocks by `pct_change` / `main_net_in`. Every list is `{items}`, fixed...
auction Opening call auction (集合竞价) as its own dataset — today or any past trading day. Items: `canonical_code`, `name`, `auction_price` (= the official open), `prev_close`, `pct_change` (points), `volume` (shares), `amount` (CNY). `stage`:...
index_snapshot Real-time snapshot for the 172 A-share indices with a live quote feed (e.g. 上证指数 SSE:000001, 深证成指 SZSE:399001, 创业板指 SZSE:399006, 科创50 SSE:000688, 北证50 BSE:899050): price, pct_change, amount, speed_3min per index, refreshed ~15s during...
global_index_snapshot Snapshot for 30 global equity indices plus Hong Kong indices (e.g. 日经225 GIDX:NKY, 标普500 GIDX:SPX, 纳斯达克 GIDX:IXIC, 恒生指数 HKEX:HSI). A-share indices are `index_snapshot`. These markets span time zones — always read `data_tier`: `realtime`...
etf_list Directory of A-share ETFs: manager, tracked index, tick size, daily limit band. Filter by `index_code` (`000300` or `SSE:000300`), `q` (name/ticker substring) or `asset_class`. For a fund's own numbers use `etf_show`. ⚠️ `asset_class`...
etf_show One ETF's profile plus its latest daily row: close, shares outstanding, unit NAV, premium/discount, estimated net creation. ⚠️ Two premium fields, not interchangeable: `premium_rate_same_day` only when the NAV date equals the trade...
etf_flows Ranks ETFs by estimated net creation/redemption in CNY over a 1/5/20 trading-day window. **An estimate** (`share change × that day's unit NAV`), not a reported flow, and **null is not 0**: uncomputable days (stale shares / NAV,...
views KEY FIELDS (per item): `report.title` (nullable, only compact/full; index uses `title`), `source_label` (the institution; no `institution`), `ai_summary`, `content` (+ `content_truncated`), `primary_security.canonical_code` / `.name` /...
views_get Fetch one analyst view by id — the read half of list→read, for when a `views` list row is not enough. Returns that view's complete body (never truncated, regardless of the `fields` mode the list was fetched with), its AI summary,...
report Fetch the FULL research-report text behind a view (parsed long-form), for when the `views` summary is not enough. Only works on views where `full_text_available=true` (archived sell-side reports) — get those from `views --report-only`,...
news SUPPLEMENTARY news / market briefs (short-horizon event stream) — use only to fill gaps not covered by `views`, the primary research source. Default `fields=compact` (title + ai_summary + ~300 chars); `full` only when needed. Flash news...
news_get Fetch one news item by id — the read half of list→read, for when a `news` list row is not enough. Returns that item's full content plus its tagged securities and source labels. ⚠️ Field `author` is the **byline entity — an outlet brand...
announcements_list 查询公告列表。传 q 按名称、代码或关键词检索,关键词结果按相关性排序,actual_window 的起止不代表连续覆盖;传 code 按单股查询;均省略则按发布时间倒序浏览全市场。用 offset 翻页,取 items[].id 调 announcements_detail。published_at 是实际可见时刻,disclosure_date 是披露日期。
announcements_detail Read one announcement on demand (id from feed/stock/search `items[].id`) — an annual report is 200k+ chars, so do not expect the whole body. Financial question path: 1) `format=search` with `q` (space-separated, all terms must match) →...
sentiment_overview Aggregate sentiment for one trading day's latest minute: up/down/flat, limit-up/down, gt3/lt3 breadth, divergence index + label, MA20/50/200 breadth, 52w new highs/lows. Omit `trade_date` for today realtime. Also a `leverage` block...
sentiment_breadth Intraday breadth time series for one trading day (240 minute bars; 13:00 excluded — ticks at the lunch-break boundary are too sparse). `trade_date` omitted = today (pre-open returns empty); explicit YYYY-MM-DD = historical replay....
sentiment_turnover Intraday turnover time series with `current_turnover` / `predicted_total` / `delta_vs_yesterday` headline fields, plus `volume_trend` (`expanding` 放量 / `contracting` 缩量 / `flat`) and `vs_prev_2d_ratio` vs the previous two sessions at...
sentiment_pct_distribution Real-time A-share market pct-change distribution: bucket counts at ≤-10% / -9% / ... / +10% / 涨停, plus universe total. Snapshot only — historical replay not yet exposed.
sentiment_premium SHAPE: two curves `main[]` and `compare[]` (not `bars` / `items`), rows `{bar_time, avg_pct, stock_count}`, plus `main_pool_size` / `compare_pool_size`. Are yesterday's limit-up buyers making money today? Yesterday's limit-up pool...
hot 股票关注榜。source=research(默认)返回卖方研究提及榜数组,可按 date 或滚动 hours 查询;mention_count 为窗口内提及次数。按日期回溯先用 mode=dates 取 {dates},周一窗口含周末,提及次数不能直接跨日比较。榜中可含港股。历史从 2026-02-25 起,覆盖期内空榜表示无提及,请求失败返回 503;更早日期无覆盖。source=social 返回当前散户综合排行、排名变化及快照时间;score...
concepts_list List concepts with a live snapshot (pct_change / index_value / up_count / down_count / limit_up_count / amount / speed_3min). Default sort pct_change desc; `order=asc` gives the bottom-N instead (e.g. today's worst concepts). All sort...
concepts_snapshot Bulk live snapshot of all concepts. Use `codes` (comma-separated concept_id list) to filter; omit for the full set. Cheaper than `concepts_list` when only the live numbers are needed without joining meta. Percent-change fields are in...
concepts_show Detail for one concept: meta plus current member securities with latest snapshots. Use after `concepts_list`. Pass `kind=industry` for a Shenwan industry id — a dimension mismatch returns 404, same as an unknown id. Members carry...
concepts_of **Which themes does this stock belong to?** Inverse of `concepts_show`: returns a security's active concepts (id, name, today's percent change). Pass `code` (preferred; `lookup` first if you only have a name) or `query` (substring over...
concept_tags 查询股票当前热炒题材与完整基础概念标签,同时返回待确认、未同步、无已确认归属等状态。热炒活跃状态与长期基础归属分别返回;基础标签不等于当天上涨原因。
concepts_alerts 板块异动。active 查看当前仍触发的信号(big_move 为绝对涨跌幅超过 3%,limit_up_cluster 要求至少 5 只成分股且至少 3 只涨停);history 查看曾经触发的事件(默认最近 24 小时)。历史支持 Unix 毫秒 from/to、rule 和 limit。行业仅触发 big_move。
concepts_bars 概念、行业或基础指数 K 线(链式等权,基点 1000)。daily 返回日线、市场宽度和 is_backfilled;minute 返回分钟终点标签,完整交易日 240 根,单次最多 7 天。沿用列表中的 kind 和 concept_id。
concepts_fundflow_minute Minute-by-minute capital flow for a concept or industry, summed over its current active constituents — the same basis as `main_net_in` in `concepts list`. Same field semantics as the per-security `fundflow` verb: `*_cum` are running day...
concepts_news Recent news mentioning the concept name (ILIKE on news.title + content). Short-term implementation; long-term will switch to AI tagging. Requires `news:read` scope.
concepts_views Broker views associated with a concept (concept_views × broker_views, ai_status=done), sorted by published_at desc. Primary research source for a theme. Requires `views:read` scope.
limit_up_pool A-share limit-up pool for a trade date, per stock: first/last seal time, final pct, seal amount (CNY) / volume (lots), `max_seal_amount` + `max_seal_time` (the day's peak seal), `broken_count`, `consecutive_days` (连板数),...
limit_up_summary Limit-up summary for a trade date: limit_up_count / broken_count + ever_broken_count / limit_down_count / max_height / ladder[{height, count}]. Two seal-break measures: `broken_count` = INSTANTANEOUS boards open right now (day high...
limit_up_promotion 晋级 / 断板追踪: every stock that closed sealed at the limit on the previous trading day, and what it did on `trade_date` — grouped by yesterday's height (highest first). Each level: `count` / `promoted` (sealed again, `today_height` =...
limit_up_history Daily limit-up trend over the last N trading days: { trade_date, limit_up_count, broken_count, ever_broken_count, max_height }, oldest first. Same two seal-break measures as `limit_up_summary` (instantaneous end-of-day vs cumulative...
limit_up_analysis Per-stock limit-up attribution based only on published views and research. Returns leading_concept, concept_tags, nullable reason, attribution_status, empty_reason, evidence_refs and last_attempt_at. Incremental updates depend on...
chart Single-security K-line for **stocks and A-share indices** (daily by default; `minute=true` + one `date` for intraday). Multi-code: `bars_batch` (stocks only). Indices are detected from the code: `SSE:000xxx`, `SZSE:399xxx`,...
bars_batch Batch K-line for multiple A-shares in one round-trip. Daily bars default to date desc; use order=asc for chronological calculations. Response sort echoes the date order. Daily: ≤100 codes × ≤1 yr; minute: ≤20 codes × ≤7 d. Envelope:...
scan Full-market real-time quote scan (~5800 A-share securities, ~3 MB unfiltered). Narrow server-side first: `sort` + `order` + `limit` return a real ranking (`sort=pct_change, order=desc, limit=50` = the day's 50 strongest in a few KB);...
technicals KEY FIELDS (per item): `pos_in_52w.value` (0–1, plus `high_52w` / `low_52w` / `breakout_52w` / `breakdown_52w`), `consecutive_up.days` + `.pct_change`, `volume_spike.median_next_ret_pct` / `.avg_next_ret_pct` / `.winrate` /...
fundflow Minute-by-minute capital flow for one A-share, split by order size: main force (super + big), super, big, normal, small, retail. Amounts are CNY; positive = net inflow. `*_cum` fields are running totals for the day — never sum them...
trades_minute **Who is actually buying — from the trades themselves.** Per-minute (or 5/15/30/60-minute) aggregates over the raw trade feed for one A-share: buyer- vs seller-initiated volume, large-print counts, true VWAP. The self-verifiable...
trades_ticks ⚠️ **EXPERIMENTAL — may change or be withdrawn at any time.** Do not build automation on it or persist it as a system of record. Individual prints for one A-share on one trading day, in `seq` order with cursor paging — for inspecting a...
margin_show Daily margin-trading (融资融券) series for one A-share: financing balance / gross buy / repayment / net buy, short-sell and short balance (shares and CNY), total balance, day-over-day change. **T+1 — the latest row is normally the previous...
margin_market Market-wide margin-trading (融资融券) series, two arrays. `exchanges`: per-exchange daily summary (SSE / SZSE / BSE) — balances, gross buy, repayment, net buy, short-sell, `derived_fields`. `structure`: market-wide leverage metrics, most...
margin_movers Ranks A-shares by margin-trading activity for one trading day (default latest). Sort: `net_buy_desc` (default) / `net_buy_asc` / `balance_desc` / `balance_chg_pct_desc` / `balance_chg_pct_asc`. Ranking by gross buy is deliberately not...
margin_collateral Daily collateral-eligible holdings (担保券) series for one A-share: `collateral_shares`, `collateral_shares_chg`, `prev_collateral_shares`, `collateral_mv_cny`, `total_mv_cny`, `collateral_pct_of_total_mv` (collateral value as % of total...
margin_collateral_movers Ranks A-shares by collateral-eligible holdings (担保券) for one trading day (default latest). Default `pct_desc` = `collateral_pct_of_total_mv` (collateral value as % of total cap, percentage points) — how much of a name sits in margin...
dragon_tiger_daily Official dragon-tiger list (龙虎榜) for one trading day, ranked by top-five seats' net buying: brokerage branches, institutional seats (机构专用) and northbound desks. **Published the evening after the close — during trading hours it returns...
dragon_tiger_stock One security's dragon-tiger (龙虎榜) appearance history, newest first, each with its full buy/sell seat table — is the money institutional, northbound or retail-branch hot money, and do the same seats keep coming back. Caveats as...
dragon_tiger_seats Ranks brokerage branch seats (营业部) by dragon-tiger activity: appearances, cumulative buying, and how their picks opened the NEXT session. Counting is deduplicated by (day, exchange, security, seat). ⚠️ Read `win_rate_pct` with...
dragon_tiger_seat One seat deduplicated dragon-tiger appearance history: which names it traded, on which side, for how much, and how each opened the next session. Deduplication and side semantics match `dragon_tiger_seats` — one row per (trading day,...
financials_quote_snapshot One-call 14-field valuation snapshot for one A-share: PE / PE-TTM / PB / PS / PS-TTM, total/float/free share, total/circ market cap, turnover rate (raw & float), volume ratio, dividend yield (last-year & TTM). Computed in-house from raw...
financials_pit Point-in-time financial indicators for one A-share at a given trade_date. Returns the latest report visible AS OF that date (announce_date ≤ date; conservative 90-day fallback when announce_date is missing). Designed for backtests / AI...
financials_reports Last N report-period snapshots for one A-share (~25 fields per period). Each item carries `announce_date` for visibility timing. Filter by `kind` to scope to Q1 / H1 / Q3 / annual / preliminary.
financials_series Time series of a single financial metric for one A-share across reporting periods. `metric` is an indicators-table field name (roe_simple / revenue / ni_parent / debt_asset_ratio / gross_margin / eps_basic, ~150 supported).
ownership_show Ownership events for one A-share: recent insider holder trades (net shares/pct, increase/decrease counts), share repurchases (ongoing count, executed amount/shares, latest status) and upcoming lockup expirations (unlocking shares/pct,...
ownership_lockups Scan upcoming share-lockup expirations across the whole A-share market for the next N days, sorted by unlock date then unlock pct desc. Forward-looking sell-pressure radar that digest can't provide (digest is single-code). Filter small...
calendar_reports Earnings-report disclosure window for one A-share: when the next periodic report is booked (`next_report`), whether today is its booked disclosure date (`discloses_today`), and the most recent report actually filed (`latest_disclosed`)....
calendar_upcoming Scan A-shares whose periodic report is booked for disclosure in the next N days, sorted by booked date — the overnight-risk screen for earnings season. Pass `codes` (comma-separated) to narrow to a portfolio, `report_type` to restrict...
events_upcoming KEY FIELDS (per item): `event_kind` (not `kind`), `title`, `summary`, `expected_on` + `date_precision` + `window_end`, `entities[].entity_code` (the canonical code lives here), `entities[].role`, `importance` (1–5), `status`,...
events_timeline KEY FIELDS (per row in `upcoming[]` / `past[]`): `event_kind` (not `kind`), `title`, `expected_on` + `date_precision` + `window_end`, `entities[].entity_code`, `importance`, `status`. One A-share security's dated events as two lists:...
earnings A 股业绩预告与快报。company 按 code 查最近若干报告期(默认 4 期),包括预告修订历史与自愿披露的快报;快报缺失很常见。recent 扫描最近披露的业绩预告(默认 7 天、200 条),支持按方向、报告类型、同比下限或股票组合筛选。预告方向取自预告类型,修订以完整历史为基准。
capabilities Pass `verb=<tool name>` to get that tool's RESPONSE FIELD LIST locally — no request, no credits; do this before writing a projection instead of guessing field names. Without `verb`: the API `spec_version` — NOT this CLI's version, never...
whoami What this API key can do: `kind` (user / partner / agent), `scopes`, rate limit, monthly quota, `cli_release` (latest / minimum_supported — is this build behind), `endpoints` (entry-point policy), and `operations.available` /...
usage This key's credit usage for the current month: `used`, `base_cap`, `base_remaining`, `pack_remaining` (purchased top-ups, spent only after the base allowance runs out), `total_remaining`, plus a 6-month history in `monthly`. Use it to...
read_guide 免费读取 EchoPai 的数据接入与盘面研究手册。空参数列出全部资料。guide 选资料,section 可填目录里的完整标题或唯一关键词(如盘前扫)。按 next_offset 续读。
Get alerted when this changes. Email the moment io.github.echopai/echopai-mcp drifts, dies, or revives.

Status badge

Toolpin status badge for io.github.echopai/echopai-mcp

[![Toolpin](https://toolpin.dev/badge/io.github.echopai/echopai-mcp.svg)](https://toolpin.dev/servers/io.github.echopai/echopai-mcp)

Maintain this server? Add the badge to your README. It links your users to this live status page.