# XTREE

> XTREE is a paid MCP server for china social data. WeChat search, article metrics and Channels data for AI agents. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Paid
- **Platforms:** CLI, API
- **Website:** https://www.xtree.io/mcp
- **Repository:** https://github.com/xtree-io/xtree-mcp
- **MCP Registry name:** io.github.xtree-io/xtree
- **Categories:** [china social data](https://ai-powered.com/categories/china-social-data)
- **Listing updated:** 2026-11-20

## About

XTREE's MCP server gives an agent read access to WeChat data through the XTREE API. It covers keyword search for official-account articles and accounts, Channels posts, article reads and likes, account post history and an article library.

The server runs locally over stdio and starts with uvx xtree-mcp. It needs an XTREE API key in XTREE_API_KEY, and each successful call is deducted from your wallet at the catalogue price. The balance check is free and incomplete deliveries are not billed.

Other platforms XTREE supports are reached through its REST API and Python SDK rather than this server.

## Features

- **Article and account search:** Keyword search for official-account articles and for accounts.
- **Channels data:** List posts for a channel and convert between export and object IDs.
- **Article metrics:** Reads, likes and wows, with a Pro tool adding shares, favourites and comment counts.
- **Account history:** List an account's historical posts and find accounts under an organisation.
- **Per-call billing:** Successful calls debit a wallet; the balance tool is free and incomplete delivery is not billed.
- **Runs with uvx:** Same JSON config works in Cursor, Claude Desktop and VS Code.

## Good for

- Track engagement on a WeChat article
- Research which official accounts publish on a topic
- Review an account's posting history
- Collect Channels posts for a creator
- Monitor accounts owned by a given organisation

## Install

### Claude Code (Terminal)

```sh
claude mcp add xtree --env XTREE_API_KEY='<XTREE_API_KEY>' -- uvx xtree-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "xtree": {
      "command": "uvx",
      "args": [
        "xtree-mcp"
      ],
      "env": {
        "XTREE_API_KEY": "<XTREE_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "xtree": {
      "command": "uvx",
      "args": [
        "xtree-mcp"
      ],
      "env": {
        "XTREE_API_KEY": "<XTREE_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "xtree": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "xtree-mcp"
      ],
      "env": {
        "XTREE_API_KEY": "<XTREE_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "xtree": {
      "command": "uvx",
      "args": [
        "xtree-mcp"
      ],
      "env": {
        "XTREE_API_KEY": "<XTREE_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "xtree": {
      "command": "uvx",
      "args": [
        "xtree-mcp"
      ],
      "env": {
        "XTREE_API_KEY": "<XTREE_API_KEY>"
      }
    }
  }
}
```

## Tools

- `account_balance`: Wallet balance; free.
- `wechat_search_articles`: Keyword search for official-account articles.
- `wechat_search_accounts`: Keyword search for official accounts.
- `wechat_channels_feeds`: List posts for a channel_id from search.
- `wechat_channels_feeds_convert_id`: Convert export_id to object_id or the reverse.
- `wechat_articles_metrics`: Reads, likes and wows for an article URL.
- `wechat_articles_metrics_pro`: Adds shares, favorites and comment counts for an article URL.
- `wechat_accounts_posts`: List historical posts for an account.
- `wechat_accounts_search_by_owner_live`: Live search for official accounts under an organization name.

## FAQ

### How do I install XTREE?

Run uvx xtree-mcp with XTREE_API_KEY set; uv must be installed.

### How is XTREE billed?

Each successful tool call debits your wallet at the API catalogue price. account_balance is free and incomplete delivery is not billed.

### Which clients work?

Any client that runs a stdio MCP server, including Cursor, Claude Desktop and VS Code.

### Does XTREE cover other platforms?

This server exposes WeChat tools; other platforms are available through the REST API and Python SDK.

### Is XTREE free?

No. XTREE is a paid product.

### How do I add XTREE to Claude Code?

Run this command in your terminal: claude mcp add xtree --env XTREE_API_KEY='<XTREE_API_KEY>' -- uvx xtree-mcp

### What are the best alternatives to XTREE?

The closest alternatives to XTREE are Douyin Xiaohongshu Rednote Social Scraper MCP, AutoTasker Hub — China Social Data API, Kizuki WeChat Articles, Weibo Hot Search (微博热搜): Trending Topics & Posts and Palimpsest — censorship, China economy and model-eval observatory.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Douyin Xiaohongshu Rednote Social Scraper MCP](https://ai-powered.com/mcp/douyin-xiaohongshu-rednote-social-scraper-mcp): Douyin Xiaohongshu Rednote Social Scraper MCP is a paid MCP server for web search and scraping.
- [AutoTasker Hub — China Social Data API](https://ai-powered.com/mcp/autotasker-hub-china-social-data-api): AutoTasker Hub — China Social Data API is a paid MCP server for china social data.
- [Kizuki WeChat Articles](https://ai-powered.com/mcp/kizuki-wechat-articles): Kizuki WeChat Articles is a paid MCP server for web search and scraping.
- [Weibo Hot Search (微博热搜): Trending Topics & Posts](https://ai-powered.com/mcp/weibo-hot-search-trending-topics-and-posts): Weibo Hot Search (微博热搜): Trending Topics & Posts is a paid MCP server for china social data.
- [Palimpsest — censorship, China economy and model-eval observatory](https://ai-powered.com/mcp/palimpsest-censorship-china-economy-and-model-eval-observato): Palimpsest — censorship, China economy and model-eval observatory is an open-source MCP server for china social data.
- [X402 MCP Server](https://ai-powered.com/mcp/x402-mcp-server-2): X402 MCP Server is a paid MCP server for china social data.

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