EchoPai

Servidor MCP de investigación cuantitativa y de renta variable china (acciones A) basado en eventos, con 50 herramientas en tiempo real para informes de bróker en texto completo, atribución de analistas, documentos corporativos, ciclos de sentimiento del mercado, análisis de límites de subida y tableros de conceptos.

Documentación

EchoPai MCP Server · 回声投研

English · 简体中文

MCP Compatible Tools npm License: MIT

echopai/echopai-mcp MCP server EchoPai MCP connector

Turn any AI into an event-driven equity research analyst.
Equip Claude, Cursor, VS Code, Gemini CLI, or any MCP-compatible agent with 50 real-time China equity (A-share) & quantitative research tools — full-text broker reports, individual analyst attribution, corporate filings, quantified sentiment cycles, and limit-up analytics, with traceable citations on every answer.

This repository provides a complete Node.js MCP Server built on @modelcontextprotocol/sdk and zod (src/index.js, src/tools.js, src/client.js) wrapping EchoPai's Open Platform REST APIs, alongside a hosted Streamable HTTP endpoint (https://mcp.huishengpai.com/mcp) for zero-install OAuth setup.


Official Portal Matrix

ResourceGlobal (EN)China Mainland (中文 · 回声投研)
Official Websitehttps://echopai.comhttps://www.huishengpai.com
Web Research Terminalhttps://app.echopai.comhttps://huishengpai.com/go/app
API Keys & OAuth Accounthttps://echopai.com/go/app/agenthttps://huishengpai.com/go/app/agent
Remote MCP Endpointhttps://mcp.huishengpai.com/mcphttps://mcp.huishengpai.com/mcp
Automated AI Setup Prompthttps://echopai.com/agent-setup/prompt.mdhttps://www.huishengpai.com/agent-setup/prompt.md

Why EchoPai MCP?

Most open-source stock MCP servers only wrap basic price quotes or K-line endpoints. EchoPai connects your AI to institutional-grade event-driven research infrastructure:

CapabilityBasic Price / Free ScriptsEchoPai MCP (回声投研)
Broker ResearchNone or unindexed PDFsFull-text broker reports (report) + analyst-level attribution weighted by historical accuracy (views)
Market Events & FilingsDelayed news headlinesReal-time announcements (announcements_*), forward-looking event calendar, and share lockup schedules (ownership_lockups)
Market MicrostructureRaw OHLCV onlyLimit-up pool & attribution (limit_up_*), quantified sentiment cycles (sentiment_*), and 300+ concept boards (concepts_*)
Deployment & AuthLocal Python/Node setup & fragile cookiesZero-install remote Streamable HTTP with Browser OAuth 2.0 or API Key; tools stay updated server-side

What It Looks Like in Action

Once connected, simply ask complex research questions in natural language. Your AI chains multiple EchoPai tools automatically and cites every claim:

Example 1: Morning Broker Research Synthesis ("Read all compute research notes from this morning and summarize")

AI automatically calls: views → report → digest → search

  • Consensus (3 top institutes aligned): Domestic training chip shipments revised up (40% → 55% YoY); 1.6T optical module ramp pulled forward to Q4.
  • Divergence: One sell-side team flags cautious CapEx guidance and yield/delivery cadence differences in Q2.
  • Analyst Weighting: Automatically surfaces each analyst's 90-day track record and directional hit rate so you know whose call carries more weight.
Example 2: Intraday Surge Attribution ("Why is Cambricon surging today?")

AI automatically calls: quote → news → views → announcements → sentiment

  • Market Microstructure: +9.98% on 12.8B CNY turnover (8.2% turnover rate, 98th percentile over 60 days; volume z-score +3.1; main net inflow +1.1B CNY).
  • Catalyst: Equity incentive draft announced last night (grant price ~66% of market, covering 85% of staff, 2026–2028 revenue & profit targets).
  • Broker Follow-up: 3 morning notes raised earnings forecasts / target prices.
  • Risk Check: Verified zero reduction announcements within 30 days, zero lockup expirations within 45 days, and no regulatory inquiry letters.

Quick Start (20 Seconds)

Remote Endpoint (Streamable HTTP):

https://mcp.huishengpai.com/mcp

Supports both Zero-Key Browser OAuth 2.0 and Bearer API Key (eps_live_...).

Claude Code

Option 1: Browser OAuth (no API key needed)

claude mcp add --transport http echopai https://mcp.huishengpai.com/mcp

Select echopai in /mcp to complete browser authorization.

Option 2: API Key

claude mcp add --transport http echopai https://mcp.huishengpai.com/mcp --header "Authorization: Bearer <YOUR_KEY>"

Cursor

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "echopai": {
      "url": "https://mcp.huishengpai.com/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_KEY>"
      }
    }
  }
}

VS Code (GitHub Copilot)

Add to .vscode/mcp.json:

{
  "servers": {
    "echopai": {
      "type": "http",
      "url": "https://mcp.huishengpai.com/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_KEY>"
      }
    }
  }
}

Claude Desktop / claude.ai / WorkBuddy

Open Settings → Connectors, add https://mcp.huishengpai.com/mcp, and click Authorize via browser login.

Gemini CLI

gemini mcp add --transport http --header "Authorization: Bearer <YOUR_KEY>" echopai https://mcp.huishengpai.com/mcp

See Client Configuration Guide for project-shared configs, environment variable tips, and headless CI/Cron usage.


Tool Directory (50 Tools)

All 50 tools are explicitly registered with zod input schemas in src/tools.js and call EchoPai's Open Platform /v1 REST APIs via src/client.js (with automatic failover between api.huishengpai.com and api.echopai.com).

CategoryTools
Account & Market Meta (×4)whoami, usage, market_status, trading_days
Research & Views (×3)views, report, digest
News, Announcements & Events (×7)news, announcements_feed, announcements_search, announcements_stock, announcements_detail, events_upcoming, events_timeline
Financials & Earnings (×6)financials_reports, financials_series, financials_pit, financials_quote_snapshot, earnings_show, earnings_recent
Ownership & Lockups (×2)ownership_show, ownership_lockups
Market Quotes, Technicals & Scan (×12)quote, bars_batch, chart, index_snapshot, market_movers, scan, hot, search, lookup, technicals, fundflow, dragon_tiger_daily
Limit-up Analytics (×4)limit_up_pool, limit_up_analysis, limit_up_history, limit_up_summary
Market Sentiment (×4)sentiment_overview, sentiment_breadth, sentiment_turnover, sentiment_pct_distribution
Concept Boards (×8)concepts_list, concepts_show, concepts_snapshot, concepts_news, concepts_views, concepts_alerts, concepts_minute_bars, concepts_daily_bars

For detailed descriptions and usage rules, see Tool Reference.


Local stdio MCP Server & CLI

Run this repository directly as a standalone local stdio MCP server powered by @modelcontextprotocol/sdk and zod (src/index.js, requires Node.js ≥ 20):

{
  "mcpServers": {
    "echopai": {
      "command": "npx",
      "args": ["-y", "@echopai/mcp"],
      "env": {
        "ECHOPAI_API_KEY": "eps_live_YOUR_KEY_HERE"
      }
    }
  }
}

Or run directly from a local clone:

node src/index.js --key eps_live_YOUR_KEY_HERE

For shell pipelines (echopai ... | jq) or cron jobs, you can also install the full echopai CLI package from npm:

npm install -g echopai
echopai --version

Automated AI Setup

Paste either official setup prompt URL directly to your AI assistant and let it configure everything automatically:


About EchoPai & Disclaimer

Founded in 2022 with a distributed team across New York, Singapore, and Asia-Pacific, EchoPai (回声投研) builds event-driven quantitative research infrastructure based on the thesis that the market is the echo of events.

Disclaimer: EchoPai is a financial data and research information tool—not a registered investment advisor or broker-dealer. Nothing provided by the MCP server, API, or documentation constitutes investment advice or solicitation to buy or sell any securities.

License

MIT © 2026 EchoPai LLC