Zwldarren Akshare One Mcp

ai.smitheryPublished by smithery.aiOfficial publisherv1.14.0Updated Oct 24, 2026

Provide access to Chinese stock market data including historical prices, real-time data, news, and…

The publisher's own server: 222wcnm Bilistalkermcp

VerifiedStreamable HTTPWeb executableFinanceData & Analytics

Overview

AI-generated overview

Remote MCP server that gives an assistant read-only access to Chinese stock market data: historical and real-time prices, news, and financial statements.

What you can do
  • Retrieve historical price data with intervals, date ranges, adjustment types and technical indicators
  • Fetch real-time quotes for one symbol or the whole market
  • Read stock-related news for a given symbol
  • Pull balance sheet, income statement and cash flow data, plus key financial metrics
  • Look up insider trading data and current time with the last trading day
  • Switch or pin data sources (eastmoney, sina, ths, xueqiu) with automatic fallback
When to use it
Useful when you want an assistant to look up or compare China A-share market data, company fundamentals or stock news without writing scraping code yourself. Suited to research and analysis questions rather than trading or order execution.
Requirements
A remote streamable HTTP endpoint at server.smithery.ai, with OAuth authentication required and an Authorization bearer token supplied as a header. No local runtime or package installation is needed. The server itself fetches data from third-party Chinese market data sources.
Before you install
The connection requires an Authorization bearer token for Smithery; keep it secret. Queries and stock symbols are sent to Smithery and to upstream data providers such as eastmoney, sina, ths and xueqiu. Data is read-only but comes from third-party sources and may be delayed, incomplete or unavailable; it is not investment advice.

Installation

In SourceWeft

  1. Open Zwldarren Akshare One Mcp in the dashboard and add it to a workspace.
  2. Connect the required credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/ai.smithery%2Fzwldarren-akshare-one-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config. The client completes OAuth sign-in on first connect.

{
  "mcpServers": {
    "zwldarren-akshare-one": {
      "type": "http",
      "url": "https://server.smithery.ai/@zwldarren/akshare-one-mcp/mcp"
    }
  }
}

README

AKShare One MCP Server

[smithery badge]

[PyPI version] [PyPI downloads] [Python versions] [License: MIT]

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.

[akshare-one-mcp MCP server]

Available Tools

Automatic source fallback

Except for get_inner_trade_data, whose upstream exposes a single source, every data 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:

DomainOrder tried
Historicaleastmoney → eastmoney_direct → sina → ths
Real-timeeastmoney_direct → eastmoney → xueqiu → ths (the last two are skipped when no symbol is given)
Newseastmoney → ths
Financial statementssina ⇄ 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', 'ths') (default: 'eastmoney')
  • fallback (boolean, optional): Try 'eastmoney', 'eastmoney_direct', 'sina' and 'ths' 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', 'ths') (default: 'eastmoney_direct')
  • fallback (boolean, optional): Try 'eastmoney_direct', 'eastmoney', 'xueqiu' and 'ths' in order when the chosen source fails or has no data (default: true; 'xueqiu' and 'ths' are skipped when no symbol is given, as they quote one symbol at a time)

News & Information Tools

get_news_data

Get stock-related news data.

Parameters
  • symbol (string, required): Stock code
  • source (string, optional): Data source ('eastmoney', 'ths') (default: 'eastmoney')
  • fallback (boolean, optional): Try 'eastmoney' and 'ths' in order when the chosen source fails or has no data (default: true)
  • recent_n (number, optional): Number of most recent records to return, newest first (default: 10)

Financial Statement Tools

get_balance_sheet

Get company balance sheet data.

Parameters
  • symbol (string, required): Stock code
  • source (string, optional): Data source ('sina', 'eastmoney_direct') (default: 'sina')
  • fallback (boolean, optional): Try the other source when the chosen one fails or has no data (default: true)
  • recent_n (number, optional): Number of most recent records to return (default: 10)
get_income_statement

Get company income statement data.

Parameters
  • symbol (string, required): Stock code
  • source (string, optional): Data source ('sina', 'eastmoney_direct') (default: 'sina')
  • fallback (boolean, optional): Try the other source when the chosen one fails or has no data (default: true)
  • recent_n (number, optional): Number of most recent records to return (default: 10)
get_cash_flow

Get company cash flow statement data.

Parameters
  • symbol (string, required): Stock code
  • source (string, optional): Data source ('sina', 'eastmoney_direct') (default: 'sina')
  • fallback (boolean, optional): Try the other source when the chosen one fails or has no data (default: true)
  • recent_n (number, optional): Number of most recent records to return (default: 10)

Analysis & Metrics Tools

get_inner_trade_data

Get company insider trading data.

Parameters
  • symbol (string, required): Stock code
get_financial_metrics

Get key financial metrics from the three major financial statements.

Parameters
  • symbol (string, required): Stock code
  • source (string, optional): Data source ('sina', 'eastmoney_direct') (default: 'eastmoney_direct')
  • fallback (boolean, optional): Try the other source when the chosen one fails or has no data (default: true)
  • recent_n (number, optional): Number of most recent records to return (default: 10)
get_time_info

Get current time with ISO format, timestamp, and the last trading day.

Installation & Setup

Running Modes

The server supports two modes: stdio and streamable-http

Command Line Arguments:

  • --streamable-http: Enable HTTP mode (default: stdio mode)
  • --host: Host to bind to in HTTP mode (default: 0.0.0.0)
  • --port: Port to listen on in HTTP mode (default: 8081)

Note: When using streamable-http mode, the MCP server will be available at http://{host}:{port}/mcp. For the default configuration, this would be http://0.0.0.0:8081/mcp.

Installation Options

Option 1: Via Smithery

To install akshare-one-mcp for Claude Desktop automatically via Smithery:

bash
npx -y @smithery/cli install @zwldarren/akshare-one-mcp --client claude
Option 2: Via uv

Install uv if you haven't already.

uvx installs the package from PyPI and runs it on Python 3.12 or newer.

Add the following configuration to your MCP Client settings:

json
{  "mcpServers": {    "akshare-one-mcp": {      "command": "uvx",      "args": ["akshare-one-mcp"]    }  }}
Option 3: Local Development Setup
  1. Clone this repository:

    bash
    git clone https://github.com/zwldarren/akshare-one-mcp.gitcd akshare-one-mcp
  2. Install dependencies:

    bash
    uv sync
  3. Add the following configuration to your MCP Client settings:

    json
    {  "mcpServers": {    "akshare-one-mcp": {      "command": "uv",      "args": [        "--directory",        "/path/to/akshare-one-mcp",        "run",        "akshare-one-mcp"      ]    }  }}

Technical Indicators Reference

The get_hist_data tool supports the following technical indicators:

Trend Indicators

  • Moving Averages: SMA (Simple Moving Average), EMA (Exponential Moving Average)
  • Trend Tracking: MACD (Moving Average Convergence Divergence), APO (Absolute Price Oscillator), PPO (Percentage Price Oscillator)
  • Rate of Change: ROC (Rate of Change), ROCP (Rate of Change Percentage), ROCR (Rate of Change Ratio), ROCR100
  • Other: TRIX (Triple Exponential Moving Average), ULTOSC (Ultimate Oscillator)

Momentum Indicators

  • Relative Strength: RSI (Relative Strength Index), CCI (Commodity Channel Index)
  • Trend Strength: ADX (Average Directional Index), DX (Directional Index)
  • Money Flow: MFI (Money Flow Index), MOM (Momentum), CMO (Chande Momentum Oscillator), WILLR (Williams %R)

Volatility Indicators

  • Bollinger Bands: BOLL (Bollinger Bands)
  • Average True Range: ATR (Average True Range)
  • Parabolic SAR: SAR (Parabolic Stop and Reverse)

Volume Indicators

  • Volume: OBV (On-Balance Volume), AD (Accumulation/Distribution Line), ADOSC (Accumulation/Distribution Oscillator)

Other Indicators

  • Stochastic: STOCH (Stochastic Oscillator)
  • Aroon: AROON (Aroon Indicator), AROONOSC (Aroon Oscillator)
  • Balance of Power: BOP (Balance of Power)
  • Directional Indicators: MINUS_DI, MINUS_DM, PLUS_DI, PLUS_DM
  • Time Series Forecast: TSF (Time Series Forecast)

Source: README.md at commit 793124d

Tools

0
This server asks you to sign in, so SourceWeft could not read its tools without an account and has not indexed them. What a connected account sees can depend on that account and its permissions.

Version history

1
  1. v1.14.0LatestSep 16, 2026

Score

85% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Smithery integrations