EchoPai MCP Server · 回声投研

English · 简体中文

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

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:

Related MCP server: AStockEvent

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:

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.

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).

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:

• Global: https://echopai.com/agent-setup/prompt.md

• China Mainland: https://www.huishengpai.com/agent-setup/prompt.md

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.

• Global Website: https://echopai.com

• China Website: https://www.huishengpai.com

• Web Terminal: https://app.echopai.com

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