Taostats MCP Server

Ask your AI assistant about TAO prices, validators, subnets, staking, and more, powered by live on-chain data.

Works with Claude, Cursor, VS Code, Windsurf, and any MCP-compatible client. New to MCP? It's a standard way for AI assistants to use external data sources.

What can you ask?

Just ask questions in plain English. The AI picks the right data source automatically. Here are some examples.

Prices & Trading

What is the current TAO price?
Show me TAO's price trend over the last 30 days.
What's the price of subnet 12's token?
If I buy 100 TAO worth of subnet 19, what's the slippage?
Show me the largest dTAO trades in the last hour.
Compare buy vs sell volume for subnet 19 over the past week.

Staking & Validators

Where should I stake my TAO?
Who are the top validators by APR?
Show the staking portfolio and P&L for my wallet.
Which validators have lost the most nominators in 24 hours?
Compare the top 5 validators by stake, APR, and take rate.

Subnets

What does subnet 65 do?
Which subnet has the highest market cap?
Show the top 10 subnets by daily emission.
Who are the top miners on subnet 1 by incentive?
Which neurons on subnet 18 are at risk of deregistration?
How has subnet 8's pool price changed over the last month?

Accounts & Transfers

Show me the balance for wallet 5F3sa2...
What transfers has this address made in the last 24 hours?
Has this account bought subnet 13's token?

Network & Development

What's the current state of the Bittensor network?
How much TAO is currently staked vs free?
Which subnets are most active on GitHub this week?
What changed in subtensor's codebase this month?

Knowledge Base

What is dTAO and how does it work?
Explain the difference between a hotkey and a coldkey.
How do subnet emissions work?

Setup

API Key

Don't have one? Get an API key

Tool Groups

Data default

Accounts, subnets, staking, prices, transfers, validators, search

Docs default

RAG-powered knowledge base for Bittensor concepts and Exploit 26 talks

API

Explore Taostats API routes (for writing code)

Every tool definition consumes tokens from the model's context window. Fewer tools means more room for your actual conversation, which leads to better reasoning. Only enable the groups you need. Learn more

Configuration

Claude Code

Claude Desktop

Cursor

VS Code

Windsurf

Run this command in your terminal:

Go to Settings > Connectors > Add custom connector. Paste the server URL below (the API key is included in the URL).

Add to .cursor/mcp.json in your project root:

Add to .vscode/mcp.json in your project root:

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

Available Tools

These are the individual tools the AI can use behind the scenes. You never call them directly; the AI picks the right one based on your question.

Data (16 tools)

estimateTrade: Estimate stakes and unstakes on subnet pools, several at once: output, slippage, value in TAO and USD
getSubnetDevActivity: GitHub dev activity per subnet: status, rank among subnets, commits, PRs, contributors
getDevChangelog: What changed in a subnet's code: daily, weekly or monthly summaries with PR and commit titles
calculate: Math expression evaluator and unit conversions
getSubnetParams: Subnet registration, epoch, weights, consensus and conviction parameters
resolveName: Resolve validator or subnet names to hotkeys or netuids
getNetwork: TAO market, supply and stake split, subnet Alpha spot-price sum and volume, subnet registration cost, with history
getSubnetHistory: Subnet price history summaries: change, highs and lows, drawdown, all-time high, volume, correlation
getWallet: A wallet's balances, stake positions, 24-hour change, root claimable and P&L
getSubnetFlows: Who is buying and selling a subnet: net flow, volume, top traders and largest trades
getWalletActivity: A wallet's transfers, stake events, root claims and other extrinsics as one timeline
getSubnetHolders: A subnet's largest alpha holders, their share, and whether the owner is among them
getSubnets: Subnet market data, identity, emission share and ownership, for one subnet or a screen of all of them
findValidators: Validator yields on selected or all subnets by APY, or network-wide validator metrics
getSubnetNeurons: Miner economics per subnet, or miner and validator rows by UID, hotkey or coldkey
getValidator: One validator by hotkey: stats, subnet positions, parents and children, Root Reborn basket

Docs (1 tool)

searchDocs: Semantic search over Bittensor and Taostats documentation and Exploit 26 conference talks

API (3 tools, for building software with the Taostats REST API)

taostatsApiListRoutes: List all available Taostats API routes
taostatsApiGetRouteDetails: Get request/response schema for a specific route
taostatsApiGuide: Usage guide: auth, units, workflows, gotchas

Trading (1 tool, opt-in: add `trading` to `tools`)

getSubnetTechnicalAnalysis: Technical indicators on subnet alpha price candles

Chain (1 tool, opt-in: add `rpc` to `tools`)

getChainCalls: Decoded extrinsics and calls: who submitted what, whether it succeeded, the fee

MCP Server