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

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 (24 tools)

getAccount: Latest account info, including free, staked, and total balances
getAccountHistory: Historical account transactions filtered by address, block range, or timestamp
getSubnetPool: Current subnet dTAO pool: token price, volume, liquidity, market cap
getSubnetPoolHistory: Historical subnet pool data, price and volume over time
getSlippage: Estimate price impact for buying or selling subnet alpha tokens
getStakeBalance: Stake balances by coldkey, hotkey, or subnet
getValidatorYield: Validator yield and APR data
getSubnetCandles: OHLCV candle data for subnet token pools
getSubnetTokenTrades: Buy and sell events for subnet alpha tokens
getTransfers: Native TAO transfers filtered by address, amount, or time
getNetworkStats: Network overview: block height, TAO supply, staking totals, subnet count
getSubnetIdentity: Subnet metadata: name, description, website, GitHub, socials
getSubnet: On-chain subnet snapshot: validators, emission, difficulty
getSubnetDevActivity: GitHub dev metrics per subnet: commits, PRs, issues
getDevChangelog: AI-generated summaries of code changes for subnet repos
getTaoPrice: Current TAO price in USD
getDtaoTrades: Individual dTAO trade records, every buy/sell through the AMM
getValidators: Validator data: rank, stake, APR, nominators, take rate
getMetagraph: Full metagraph: all neurons with trust, consensus, incentive, emission
getPriceHistory: Historical TAO price, volume, market cap, and supply over time
getStakingPortfolio: Aggregated staking portfolio: positions, P&L across subnets
getNeurons: Per-neuron view: performance scores, active status, deregistration risk
calculate: Math expression evaluator and unit conversions
getValidatorRecommendations: Validator staking recommendations sorted by 30-day APY

Docs (1 tool)

searchDocs: Semantic search over Bittensor and Taostats documentation

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