Back to Browse

Echopai MCP Server

Developer ToolsModerate5.3MCP RegistryLocalRemote
Free

Server data from the Official MCP Registry

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

About

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

Remote endpoints: streamable-http: https://mcp.huishengpai.com/mcp

Security Report

5.3
Moderate5.3Moderate Risk

EchoPai is a financial data MCP server that wraps the vendor's REST API and requires a Bearer API key (from env or CLI flag) before any tool call, with no hardcoded secrets, shell execution, or filesystem access found. Its permissions match the stated purpose, and the main concerns are minor: the API key is sent to a fallback domain on network errors and to any user-supplied base URL, and the key can be passed as a CLI argument visible in process listings. Supply chain analysis found 6 known vulnerabilities in dependencies (0 critical, 4 high severity). Package verification found 1 issue.

5 files analyzed · 13 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

EchoPai API key (eps_live_...) from https://echopai.com/go/app/agentRequired

Environment variable: ECHOPAI_API_KEY

How to Install & Connect

Available as Local & Remote

This plugin can run on your machine or connect to a hosted endpoint. during install.

Documentation

View on GitHub

From the project's GitHub README.

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:

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

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

Reviews

No reviews yet

Be the first to review this server!