Documentation Index
Fetch the complete documentation index at: https://coinstats.app/docs/llms.txt
Use this file to discover all available pages before exploring further.
Probably best MCP server for crypto. 20+ tools for real-time prices, wallet balances, DeFi positions, exchange data, news, and portfolios.
The CoinStats MCP Server gives AI assistants and LLM-powered applications structured access to the same crypto data available through CoinStats REST API. Instead of writing custom API calls, your AI tool connects to the MCP Server and gets 20+ tools for querying prices, checking wallet balances, tracking portfolios, fetching news, and more. Every tool maps to a CoinStats API endpoint, so the data is the same whether you use the REST API or the MCP interface.
This page lists every tool available through the MCP Server. For setup instructions, see Connecting to CoinStats MCP page.
Why MCP for Crypto Data
The Model Context Protocol (MCP) is a standard that lets AI assistants call external tools directly. Instead of a user copying data from an API and pasting it into a chat, the AI agent calls the tool itself, gets structured data back, and uses it to answer questions or take actions.
For crypto applications, this matters because the data changes constantly. Prices move every second, wallet balances update with every transaction, and DeFi positions shift as protocols rebalance. An AI assistant with MCP access can pull live data on demand rather than relying on stale training knowledge.
The CoinStats MCP Server is built on the same data infrastructure that powers the CoinStats app, used by over 1M people every month. It covers 100,000+ coins, 200+ exchanges, 120+ blockchains, and 10,000+ DeFi protocols, all accessible through the tools listed below.
These tools provide real-time and historical pricing, market caps, volumes, and chart data for cryptocurrencies.
| Tool Name | Description |
|---|
get-coins | Get comprehensive data about all cryptocurrencies: price, market cap, volume, price changes (1h, 24h, 7d), supply information, trading metrics, social links, and metadata. |
get-coin-by-id | Get detailed information about a specific cryptocurrency based on its unique identifier. |
get-coin-chart-by-id | Get chart data for a specific cryptocurrency, specifying different time ranges. |
get-coin-avg-price | Get the historical average price for a specific cryptocurrency on a specific date. |
get-coin-exchange-price | Get the historical price data for a specific cryptocurrency on a particular exchange. |
get-market-cap | Get global market data: total market cap, BTC dominance, and overall market metrics. |
| Tool Name | Description |
|---|
get-wallet-balance | Get the balance data for a wallet address on a specific blockchain network. |
get-wallet-balances | Get the balance data for a wallet address across all CoinStats-supported networks. |
get-wallet-sync-status | Check the syncing status of a wallet with the blockchain network. |
get-wallet-transactions | Get transaction data for a specific wallet. Requires syncing transactions first. |
transactions-sync | Initiate the syncing process to update transaction data for a specific wallet. |
| Tool Name | Description |
|---|
get-ticker-exchanges | Get a list of supported exchanges. |
get-ticker-markets | Get a list of tickers for a specific cryptocurrency across different exchanges. |
get-exchanges | Get a list of supported exchange portfolio connections. |
get-exchange-balance | Get the balance data for a connected exchange account. |
get-exchange-sync-status | Check the syncing status of an exchange portfolio. |
get-exchange-transactions | Get transaction data for a specific exchange connection. |
| Tool Name | Description |
|---|
get-news-sources | Get available news sources. |
get-news | Get news articles with pagination. |
get-news-by-type | Get news articles filtered by type (e.g., trending, latest). |
get-news-by-id | Get a specific news article by its ID. |
| Tool Name | Description |
|---|
get-portfolio-coins | Get a list of portfolio coins with profit/loss data and performance metrics. |
get-portfolio-chart | Get portfolio performance chart data over various time periods. |
get-portfolio-transactions | Get a list of portfolio transactions. |
add-portfolio-transaction | Add a transaction to a manual portfolio. |
save-share-token | Save a portfolio share token to local cache for future use across sessions. |
get-share-token | Retrieve the saved portfolio share token from local cache. |
| Tool Name | Description |
|---|
get-blockchains | Get a list of all blockchains supported by CoinStats. |
get-fiat-currencies | Get a list of fiat currencies supported by CoinStats. |
get-currencies | Get a list of all supported currencies. |
Conversational Crypto Assistants
The most common use case for MCP tools is building AI assistants that can answer crypto questions with live data. Instead of the AI guessing or relying on training data, it calls the appropriate tool, gets current information, and responds with accurate numbers.
Example conversation flow: A user asks “How is my portfolio doing?” The AI calls get-share-token to retrieve the saved token, then get-portfolio-coins to get current holdings with PnL data, and responds with a summary of the user’s positions, gains, and losses. No manual data entry, no copy-pasting from dashboards.
Market Research Agents
AI agents can use the market data and news tools together to produce automated research. An agent could pull the top coins by market cap, check their 24h price changes, fetch recent news about each one, and compile a daily market briefing. This is useful for trading desks, research teams, or newsletter automation.
Wallet Monitoring Bots
Combine the wallet tools with a scheduling system (like N8N) to build automated wallet monitoring. An agent can periodically sync a wallet, check for new transactions, and alert the user when something changes. This works across all 120+ supported blockchains using the same tool set.
Portfolio Analytics Copilots
For applications that already have portfolio data, the MCP tools can power a copilot feature. A user asks “Which of my holdings has the highest risk?” and the AI calls get-portfolio-coins, analyzes the response data (risk scores, volatility, market cap), and provides a ranked analysis. The AI does the analytical work; the MCP tools provide the data.
IDE-Integrated Crypto Development
Developers working in Cursor or VS Code can use the MCP tools to query live data while coding. Building a portfolio tracker? Ask the AI to call get-wallet-balance with a test address and show you the response format, right inside your editor. This is faster than switching to a browser to test API calls manually.
MCP Clients
The CoinStats MCP Server works with any client that supports the Model Context Protocol. Here are the most popular options:
Claude
The simplest setup for non-developers. Claude Desktop discovers MCP tools automatically, shows them in a sidebar, and asks for permission before calling them. Best for conversational access to crypto data.
Cursor
Developer-focused editor with built-in MCP support. Add the hosted URL to ~/.cursor/mcp.json and restart — Cursor handles the OAuth handshake on first call. Best for developers who want live crypto data while coding. See Connecting to CoinStats MCP for the config snippet.
VS Code (via Claude Code, Cline, or Continue)
Deep IDE integration for developers who prefer VS Code. Multiple MCP client extensions are available:
- Claude Code: Chat and run tools directly in the terminal
- Cline: File editing, terminal commands, and browsing powered by MCP
- Continue: Flexible, extensible AI integration with MCP support
N8N
Web-based automation tool for building workflows that pull CoinStats data and trigger actions in other apps. Best for scheduled tasks, alerts, and pipeline automation. Connect the CoinStats MCP endpoint as a custom node or HTTP request step.
Choosing the Right Client
| Workflow | Best Client |
|---|
| Chat-first, non-technical users | Claude |
| Development and coding | Cursor, VS Code |
| Automated workflows and pipelines | N8N |
| Research and analysis | Claude, Cursor |
Credits and Rate Limits
MCP tools consume the same credits as the corresponding REST API endpoints. Market data calls cost 1-2 credits, wallet operations cost 40-50 credits, and DeFi data costs 400 credits. See Credit Multipliers page and Rate Limits page for full details.
The free tier includes enough credits to test all MCP tools. Credit usage is tracked through CoinStats API dashboard.
Getting Started
- Paste
https://mcp.coinstats.app/mcp into your client’s connector settings (Claude, Cursor, Claude Code, Codex, …)
- Approve the OAuth consent screen that opens in your browser — no API key needed for the hosted URL
- Ask your assistant “What’s the current price of Bitcoin?” — it’ll pick the right tool automatically
See Connecting to CoinStats MCP for per-client install steps. Developers running their own headless integrations can still use the stdio path with an X-API-KEY.
