TANDIU

npx add-mcp 'https://www.tandiu.cn/mcp'

TANDIU API

REST and MCP access to TANDIU data.

AUTH

Authentication

Pro endpoints need an API key from a TANDIU Pro subscription. Send it as a bearer token:

curl -H "Authorization: Bearer tdu_your_key" \
  "https://www.tandiu.cn/api/v1/llm-price-history?model=deepseek&since=2026-09-01"

Base URL https://www.tandiu.cn/api/v1. Responses are JSON with as_of, source_url and a license field. Limit: 600 requests per minute per key. Errors: 401 missing/inactive key, 400 bad parameter, 429 rate limit.

ENDPOINTS

Endpoints

Endpoint	Query parameters	Returns
GET /api/v1/llm-price-history	model, vendor, country, since, until, limit	Daily official list-price history per model (USD/RMB per 1M tokens, source URL). Give model or vendor.
GET /api/v1/price-index	group (CN/US/ALL), since	Chain-linked LLM price index with the full series
GET /api/v1/price-changes	since, min_change_pct, limit	Recorded official price cuts/increases and models added to tracking
GET /api/v1/cloud-agents	kind, query, limit	Cloud agents with specs, monthly prices and TANDIU test results
GET /api/v1/role-token-budget	query, group, usage, limit	Monthly token budget per job role
GET /api/v1/coding-pc	category, tier, query	Computers for AI coding agents

MCP

MCP with your key

The remote MCP server at https://www.tandiu.cn/mcp (Streamable HTTP) accepts the same key. With a key you get 600 requests per minute and the get_llm_price_history tool. Example client config:

{
  "mcpServers": {
    "tandiu": {
      "url": "https://www.tandiu.cn/mcp",
      "headers": { "Authorization": "Bearer tdu_your_key" }
    }
  }
}

FREE

Free access

Without a key you can use every page, the open feeds listed in openapi.json and llms.txt, and all MCP tools except price history, at 60 requests per minute. Please cite TANDIU (tandiu.cn) with the page URL and date.