Xueqiu MCP Server

@liqiongyu

Basic information

About Xueqiu MCP Server

# Xueqiu MCP

Xueqiu MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "xueqiu_mcp": {
      "command": "uv",
      "args": [
        "venv",
        "&&",
        "uv",
        "pip",
        "install",
        "-e",
        "."
      ]
    }
  }
}

Xueqiu MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Xueqiu MCP?

Xueqiu MCP is a Model Context Protocol server that wraps the Xueqiu (Snowball) API using pysnowball, enabling AI assistants like Claude to query stock data directly. It is intended for developers and investors who want to integrate Chinese stock market data into AI-driven workflows.

How to use Xueqiu MCP?

Install dependencies with uv venv && uv pip install -e . after cloning the repository. Obtain a Xueqiu token and store it in a .env file as XUEQIU_TOKEN. Start the service by running uv --directory /path/to/xueqiu_mcp run main.py or by configuring a Claude Desktop MCP client with the same uv command.

Key features of Xueqiu MCP

Fetch real-time stock quotes
Query index returns
Retrieve Shenzhen–Hong Kong / Shanghai–Hong Kong northbound data
Access fund-related data
Search stock codes by keyword

Use cases of Xueqiu MCP

Ask an AI assistant for a stock’s current price and intraday movement
Check the day’s performance of a major index
Look up northbound capital flow data without leaving a chat
Find a stock’s symbol by searching its name or abbreviation

Frequently asked questions

What data does Xueqiu MCP provide?

It provides real-time quotes, index returns, northbound market data, fund data, and stock code search — all via the Xueqiu API.

Does Xueqiu MCP require an API key or token?

Yes, a valid Xueqiu token (`xq_a_token`) is required. The token must be placed in a `.env` file as `XUEQIU_TOKEN`. Instructions for obtaining a token are linked in the README.

What runtime dependencies does Xueqiu MCP need?

It requires Python, the `uv` package manager, and the `pysnowball` and `fastmcp` libraries (installed automatically via the provided setup).

How is the MCP server started and connected?

The server is run locally as a subprocess using the `uv` command. It uses stdio transport by default, as shown in the Claude Desktop configuration example.

Can I use Xueqiu MCP with other AI assistants besides Claude?

The README specifically mentions Claude and shows integration with Claude Desktop, but any MCP-compatible client should be able to use it.

Comments

More Other MCP servers

Activepieces

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

23.2K

Handl

Handl speaks the Model Context Protocol. Your whole billing operation — projects, invoices, clients, reports, approvals — as tools any AI assistant can call, inside your autonomy rules.

Volley.sh

Volley

A good sequence diagram can solve almost any communication problem in engineering. Volley lets your agent write them as plain text, with the real request and response payloads on every arrow. It checks its own syntax wi

YOUB

Connect your AI assistant to your own YOUB endurance training account. Read recorded activities with full analysis, planned sessions, race goals, wellness (HRV, sleep, resting HR) and your athletic profile. Create or mov

Yuppsy

Yuppsy MCP: build and publish real estate websites from your AI assistant. Yuppsy lets your AI assistant create live websites for real estate agents and individual property listings. You don't need a designer or any code