AKShare One MCP Server

English | 中文

Overview

An MCP server based on akshare-one, providing comprehensive interfaces for China stock market data. It offers a set of powerful tools for retrieving financial information including historical stock data, real-time data, news data, and financial statements.

Available Tools

Automatic source fallback

Except for get_news_data and get_inner_trade_data, whose upstream exposes a single source, every tool takes a source parameter for the preferred data source and a fallback parameter (on by default) that decides whether the other sources of the same domain are tried when that source raises or returns an empty frame:

Domain	Order tried
Historical	eastmoney → eastmoney_direct → sina
Real-time	eastmoney_direct → eastmoney → xueqiu (skipped when no symbol is given)
Financial statements	sina ⇄ eastmoney_direct

The requested source is always tried first; the order only governs the fallback. Because akshare-one projects every source onto its domain's declared columns, falling back cannot change the field names or their order. When every source fails, the error lists each one and why it failed; when every source succeeds but has no data, an empty result is returned. Set fallback to false to pin a single source — a failure then surfaces directly, which is useful when you need to know exactly where the numbers came from.

The source that actually served a call is logged under the akshare_one_mcp.providers logger.

Market Data Tools

get_hist_data

Get historical stock market data with support for multiple time periods and adjustment methods.

Parameters

• symbol (string, required): Stock code (e.g. '000001')
• interval (string, optional): Time interval ('minute','hour','day','week','month','year') (default: 'day')
• interval_multiplier (number, optional): Interval multiplier (default: 1)
• start_date (string, optional): Start date in YYYY-MM-DD format (default: '1970-01-01')
• end_date (string, optional): End date in YYYY-MM-DD format (default: '2030-12-31')
• adjust (string, optional): Adjustment type ('none', 'qfq', 'hfq') (default: 'none')
• source (string, optional): Data source ('eastmoney', 'eastmoney_direct', 'sina') (default: 'eastmoney')
• fallback (boolean, optional): Try 'eastmoney', 'eastmoney_direct' and 'sina' in order when the chosen source fails or has no data (default: true)
• indicators_list (list, optional): Technical indicators to add
• recent_n (number, optional): Number of most recent records to return (default: 100)

get_realtime_data

Get real-time stock market data.

Parameters

• symbol (string, optional): Stock code
• source (string, optional): Data source ('eastmoney_direct', 'eastmoney', 'xueqiu') (default: 'eastmoney_direct')
• fallback (boolean, optional): Try 'eastmoney_direct', 'eastmoney' and 'xueqiu' in order when the chosen source fails or has no data (default: true; 'xueqiu' is skipped when no symbol is given, as it quotes one symbol at a time)

News & Information Tools

get_news_data

Get stock-related news data.

Parameters

• symbol (string, required): Stock code
• recent_n (number, optional): Number of most recent records to return (default: 10)

Financial Statement Tools

get_balance_sheet

Get company balance sheet data.

Parameters