AkShare

You can query comprehensive financial data through a focused MCP server built on AkShare. It exposes stock, fund, and futures data for real-time and historical analysis, enabling you to power analytics, dashboards, and trading ideas with a consistent data interface.

How to use

You interact with the AkShare MCP server through an MCP client to access real-time quotes, historical data, and company information across multiple markets. You can retrieve stock prices, sector data, and key fundamentals, then run analyses such as comparisons, calendar events, and risk indicators. Start by ensuring the server is running, then issue requests for the data you need using the available tools. The server supports A shares, HK, US, and global market data, plus a range of analysis features like valuation comparisons, risk alerts, and technical indicators.

How to install

Prerequisites you must install before starting the MCP server are Node.js and Python, along with the AkShare library.

# Install Node.js dependencies
npm install

# Install Python AkShare library
pip install akshare pandas

# Build the project
npm run build

# Start the MCP server
npm start

Configuration and startup notes

Configure the MCP server by adding the following MCP configuration snippet. This sets up a local stdio-based server that runs the AkShare MCP entry point.

{
  "mcpServers": {
    "akshare-mcp": {
      "type": "stdio",
      "name": "akshare_mcp",
      "command": "node",
      "args": ["/path/marketMcp/dist/index.js"]
    }
  }
}

Verification after startup

After starting the server, verify you can access real-time stock data, historical price series, and basic stock information. Confirm you can request A-share quotes, HK and US market data, and perform comparative analyses and calendar-driven events.

Troubleshooting tips

If you encounter issues, check that Node.js and Python environments meet version requirements, ensure Python packages are installed, and verify network access to upstream data sources. Common problems include missing dependencies, Python version incompatibilities, and permission or network restrictions.

Notes on data and usage

Data delays, rate limits, and data source quirks apply. Real-time data may have a slight delay. Use the provided tools responsibly to avoid triggering limits, and treat data as references for analysis rather than investment advice.

Examples of typical data actions

Retrieve real-time stock quotes, fetch historical daily prices with adjustments, or obtain company fundamentals for a set of symbols. Combine results to compare valuations, growth metrics, and risk indicators across markets.

Security and access considerations

Maintain secure access to the MCP URL and any required API keys or environment variables. Do not expose internal endpoints in public environments. If you store credentials, keep them in a safe and non-public location.

Available tools

stock_sh_a_spot_em

Shanghai A-share real-time market data for the main market, with optional limit to control returned results.

stock_sz_a_spot_em

Shenzhen A-share real-time market data, enabling live quote retrieval.

stock_individual_spot_xq

Individual stock real-time quotes from Snowball (XQ) feed for a single symbol.

realtime_quote

Real-time quotes for multiple symbols, allowing quick multi-symbol monitoring.

stock_global_realtime

Global real-time stock data across regions such as China, Hong Kong, US, Europe, Asia, or global scopes.

stock_hk_spot_em

Hong Kong stock real-time quotes with optional result limit.

stock_us_spot

US stock real-time quotes from Sina with multi-symbol support.

stock_zh_a_hist

A-share historical data by symbol and period, with start/end dates and adjustment options.

stock_zh_a_minute

A-share minute-level historical data for intraday analysis.

stock_individual_basic_info_xq

Key fundamentals and basic information for an individual stock.

stock_gsrl_gsdt_em

Stock calendar entries including company dynamics and important events.

stock_zh_a_new_em

New stock data with optional limit on results.

stock_zh_a_st_em

Special board data showing ST and other risk indicators with optional limit.