# AKTools

> AKTools is an open-source MCP server for finance and payments. Chinese and global financial data from AKShare, queried by AI assistants. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, API
- **Website:** https://aktools.akfamily.xyz/guide/mcp/
- **Repository:** https://github.com/akfamily/aktools
- **MCP Registry name:** io.github.akfamily/aktools
- **Categories:** finance and payments, analytics and data
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add aktools -- uvx aktools
```

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

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

## 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

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/aktools
