Skip to content
MCP server

AKTools

Chinese and global financial data from AKShare, queried by AI assistants

Runs locallyStatus and history
Pricing
Open source
Platforms
CLI, self-hosted, API
Runs
Locally
Version
0.1.13
Listing updated
3 days ago

About AKTools

AKTools is an open-source MCP server for finance and payments. It runs locally on your machine and is started by your AI client.

Instead of registering AKShare's thousand-plus interfaces one by one, which would fill an assistant's context, AKTools exposes just three generic tools. The assistant searches for an interface, reads its parameters, then fetches rows. Data comes back in ascending date order, so a negative offset such as -20 returns the latest rows.

It can run over stdio, started automatically with uvx, or as a local HTTP service at 127.0.0.1:8080/mcp that several people or machines share, optionally behind a bearer token. Each interface result carries a source field, and Eastmoney quote interfaces are flagged because heavy use can get an IP blocked for several minutes. When that happens the error suggests equivalent interfaces from other sources.

It suits analysts and quant developers who want A-share, fund, futures or macro data pulled by natural-language request, and who can live with a 1,000-row cap per call.

Install

Run in a terminal

claude mcp add aktools -- uvx aktools

Add to claude_desktop_config.json

{
  "mcpServers": {
    "aktools": {
      "command": "uvx",
      "args": [
        "aktools"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "aktools": {
      "command": "uvx",
      "args": [
        "aktools"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "aktools": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "aktools"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "aktools": {
      "command": "uvx",
      "args": [
        "aktools"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "aktools": {
      "command": "uvx",
      "args": [
        "aktools"
      ]
    }
  }
}

Tools this server provides (3)

Taken from the project documentation; the running server may differ.

search_interfaces
Search AKShare interfaces by keyword, ranked by relevance, up to 50 results.
describe_interface
Show an interface's parameters, defaults, return columns and call examples.
get_data
Fetch data for an interface with max_rows and offset paging.

What it does

Three generic tools
Search, describe and fetch cover every AKShare interface without bloating the context.
Row paging
Returns 100 rows by default, up to 1,000, with offset paging and negative offsets from the end.
Source labelling
Each interface names its data source, and rate-limit-prone ones are marked.
Rate-limit fallbacks
Errors explain how long to wait and list equivalent interfaces from other sources.
stdio or HTTP
Run through uvx or as a shared local service with optional bearer-token access.
Read-only hints
All tools are annotated read-only so clients can skip confirmation prompts.

Good for

  • Fetch daily price history for a stock over a date range
  • Find which AKShare interfaces cover convertible bonds
  • Check an interface's parameters and adjustment options before calling it
  • Pull the latest rows of a time series without paging from the start

Pricing

Open source

Installed from PyPI as aktools; MCP is included with the package.

Prices change. Check aktools.akfamily.xyz before you buy.

AKTools FAQ

How many rows can one call return?

100 by default and up to 1,000 with max_rows; use offset to page.

How do I run it?

Over stdio with uvx (--from aktools aktools-mcp), or start python -m aktools and connect a client to http://127.0.0.1:8080/mcp.

Why might Eastmoney data stop working?

Its quote servers temporarily block an IP after many requests, making those interfaces unavailable for about five minutes or more.

Does it change any data?

No. All three tools are marked read-only.

Is AKTools free?

Yes. AKTools is open source, so you can use and self-host it for free.

How do I add AKTools to Claude Code?

Run this command in your terminal: claude mcp add aktools -- uvx aktools

What are the best alternatives to AKTools?

The closest alternatives to AKTools are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Solana MCP by Vybe, Tapetide - Indian Stock Market MCP and World Monitor.

Alternatives to AKTools

  1. Open-source analytics app where an AI agent builds charts and dashboards from your data

    • Remote
    • Open source
    • 7.7K GitHub stars
    • Analytics and data
  2. Hosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat

    • 8 tools
    • Remote
    • Freemium
    • 8.1K GitHub stars
    • Marketing and SEO
  3. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

    • 44 tools
    • Remote
    • 2.8K GitHub stars
    • Finance and payments
  4. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  5. World Monitor

    MCP server

    Live geopolitical intelligence dashboard with an API and MCP server for agents

    • Remote
    • Freemium
    • Analytics and data
  6. Budget Tracker

    MCP server

    Local MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling

    • 14 tools
    • Remote
    • Freemium
    • 2 GitHub stars
    • Finance and payments