Token Metrics MCP Server
OfficialThe Token Metrics MCP Server provides comprehensive cryptocurrency data, analytics, and insights through function calling for AI assistants. With this server, you can:
Access Real-time Crypto Data: Fetch current prices, market cap, volume, and historical OHLCV data (hourly/daily)
Generate Trading Signals: Obtain AI-generated trading signals for long and short positions
Price Predictions: Use advanced price forecasting and scenario analysis tools
Technical Analysis: Access support/resistance levels and token correlation analysis
Market Analytics: Get comprehensive market insights, bullish/bearish indicators, and sentiment analysis from Twitter, Reddit, and news
Quantitative Metrics: Utilize advanced quantitative analysis and grading systems for traders and investors
Research & Reports: Fetch AI-generated token reports and crypto investor information
Indices & Portfolio: Retrieve data on active/passive crypto indices, their performance, and holdings
List Top Tokens: Access rankings of top tokens by market capitalization
Provides a Node.js-based interface to Token Metrics' cryptocurrency analytics API, supporting real-time data retrieval and analysis of crypto market metrics
Allows easy installation and deployment of the Token Metrics MCP server through npm, providing cryptocurrency analysis tools and market data access
Implements TypeScript for type-safe interaction with Token Metrics' cryptocurrency data API, enabling structured access to trading signals and market analytics
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Token Metrics MCP Server get current price and trading signal for Bitcoin"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Token Metrics MCP Server
The Token Metrics Model Context Protocol (MCP) server provides comprehensive cryptocurrency data, analytics, and insights through function calling. This server enables AI assistants and agents to access Token Metrics' powerful API for real-time crypto market data, trading signals, price predictions, and advanced analytics.
Features
Real-time Crypto Data: Access current prices, market cap, volume, and other key metrics
Trading Signals: AI-generated trading signals for long and short positions
Price Predictions: Advanced price forecasting and scenario analysis
Technical Analysis: Support and resistance levels, correlation analysis
Market Analytics: Comprehensive market insights and sentiment analysis
Quantitative Metrics: Advanced quantitative analysis and grading systems
Related MCP server: Satellite Tracking MCP Server
Quick Start
Option 1: HTTP Transport
The easiest way to get started is using our hosted HTTP transport - no installation required:
{
"mcpServers": {
"token-metrics": {
"url": "https://mcp.tokenmetrics.com",
"headers": {
"x-api-key": "YOUR_API_KEY"
}
}
}
}Option 2: Using npx (Local Installation)
# Set environment variable and run
export TOKEN_METRICS_API_KEY=your_api_key_here
npx -y @token-metrics-ai/mcp@latestConnection Methods
HTTP Transport (Hosted)
URL:
https://mcp.tokenmetrics.comAuthentication: Use
x-api-keyheader with your Token Metrics API keyBenefits:
No local installation required
Always up-to-date
Better performance and reliability
Automatic scaling
Usage: Perfect for production environments and users who prefer not to install packages locally
Local Installation (npx/npm)
Benefits:
Full control over the server instance
Works offline (after installation)
Can modify and extend functionality
Usage: Ideal for development, testing, or custom implementations
MCP Listings
You can find the Token Metrics MCP server on these popular MCP listing sites:
Awesome MCP Servers: https://mcpservers.org/servers/token-metrics/mcp
Setup with AI Clients
Claude Desktop or VS Code/Cursor
HTTP Transport Configuration
Add the following to your claude_desktop_config.json or mcp.json:
{
"mcpServers": {
"token-metrics": {
"url": "https://mcp.tokenmetrics.com",
"headers": {
"x-api-key": "YOUR_API_KEY"
}
}
}
}Local Installation Configuration
Add the following to your claude_desktop_config.json or mcp.json:
{
"mcpServers": {
"token-metrics": {
"command": "npx",
"args": ["-y", "@token-metrics-ai/mcp@latest"],
"env": {
"TOKEN_METRICS_API_KEY": "YOUR_API_KEY"
}
}
}
}Available Tools
The Token Metrics MCP server provides the following tools:
Token Data & Prices
get_tokens_data- Fetch comprehensive token informationget_tokens_price- Get current token pricesget_tokens_hourly_ohlcv- Hourly OHLCV dataget_tokens_daily_ohlcv- Daily OHLCV data
Trading & Analysis
get_tokens_trading_signal- AI-generated trading signalsget_tokens_trader_grade- Short-term trader gradesget_tokens_investor_grade- Long-term investor gradesget_tokens_resistance_and_support- Technical support/resistance levelsget_tokens_correlation- Token correlation analysis
Market Intelligence
get_market_metrics- Overall market analyticsget_sentiment- Market sentiment analysisget_tokens_quant_metrics- Quantitative metricsget_tokens_scenario_analysis- Price prediction scenarios
Research & Reports
get_tokens_ai_report- AI-generated token reportsget_crypto_investors- Crypto investor informationget_top_tokens_by_market_cap- Top tokens by market cap
Indices & Portfolio
get_indices- Fetch active and passive crypto indicesget_indices_performance- Historical performance data for indicesget_indices_holdings- Current holdings and weights for indices
Getting Your API Key
Visit Token Metrics
Sign up for an account
Navigate to your API Dashboard
Generate a new API key
Use the API key with this MCP server
Development
Prerequisites
Node.js 18 or higher
npm or yarn
TypeScript
Local Development
Clone the repository:
git clone https://github.com/token-metrics/mcp.git
cd mcpInstall dependencies:
npm installSet your API key:
export TOKEN_METRICS_API_KEY=your_api_key_hereRun in development mode:
npm run start:devBuilding
npm run buildTesting with MCP Inspector
You can test the local server using the MCP Inspector:
# Build the server first
npm run build
# Run with MCP Inspector
npx @modelcontextprotocol/inspector node build/src/cli.jsConfiguration
HTTP Transport Configuration
When using the hosted HTTP transport at https://mcp.tokenmetrics.com, the server accepts:
Headers:
x-api-key- Your Token Metrics API key (required)Content-Type: application/json(for requests)
Supported Endpoints:
POST /- Main MCP JSON-RPC endpoint
Local Server Configuration
The local server accepts the following configuration options:
--help- Show help information
Environment variables:
TOKEN_METRICS_API_KEY- Your Token Metrics API key
Error Handling
The server includes comprehensive error handling:
Invalid API Key: Returns authentication error
Rate Limiting: Handles API rate limits gracefully
Network Issues: Retries failed requests
Invalid Parameters: Validates input parameters
Security
API keys are handled securely
No sensitive data is logged
Docker container runs as non-root user
Input validation on all parameters
Support
Documentation: Token Metrics API Docs
Issues: GitHub Issues
Support: Token Metrics Support
License
MIT License - see LICENSE file for details.
Available Tools
19 toolsget_crypto_investorsC
Fetch the latest list of crypto investors and their scores from Token Metrics API.
Inputs: limit, page.
get_indicesC
Fetch active and passive crypto indices with performance and market data from Token Metrics API.
Inputs: indicesType, limit, page.
get_indices_holdingsC
Fetch the current holdings of the given Index, along with their respective weight in percentage from Token Metrics API.
Inputs: id (required).
get_indices_performanceB
Fetch historical performance data for a given index, including cumulative return on investment (ROI) over time from Token Metrics API. This data is useful for analyzing index trends and evaluating investment performance.
Inputs: id (required), endDate, limit, page, +1 more.
get_market_metricsC
Fetch Market Analytics from Token Metrics API. They provide insight into the full Crypto Market, including the Bullish/Bearish Market indicator for a specific date or date range.
Inputs: endDate, limit, page, startDate.
get_sentimentB
Fetch the hourly sentiment score for Twitter, Reddit, and all the News, including quick summary of what happened from Token Metrics API.
Inputs: no named parameters.
get_tokens_ai_reportC
Fetch token(s) AI-generated reports providing comprehensive analyses of cryptocurrency tokens, including deep dives, investment analyses, and code reviews from Token Metrics API.
Inputs: limit, page, symbol, token_id.
get_tokens_correlationC
Fetch token(s) Top 10 and Bottom 10 correlated tokens from the top 100 market cap tokens from Token Metrics API.
Inputs: category, exchange, limit, page, +3 more.
get_tokens_daily_ohlcvB
Fetch daily OHLCV (Open, High, Low, Close, Volume) data for token(s) for a specific date or date range from Token Metrics API.
Inputs: endDate, limit, page, startDate, +3 more.
get_tokens_dataC
Fetch token(s) data from Token Metrics API. Provide either token_id or symbol (or both) along with optional date range.
Inputs: blockchain_address, category, exchange, limit, +4 more.
get_tokens_hourly_ohlcvA
Fetch hourly OHLCV (Open, High, Low, Close, Volume) data for token(s) for a specific date or date range from Token Metrics API.
Inputs: endDate, limit, page, startDate, +3 more.
get_tokens_investor_gradeC
Fetch token(s) long term grades, including Technology and Fundamental metrics for a specific date or date range from Token Metrics API.
Inputs: category, endDate, exchange, fdv, +8 more.
get_tokens_priceC
Fetch token(s) price from Token Metrics API. Provide token_id.
Inputs: token_id (required).
get_tokens_quant_metricsC
Fetch the latest quantitative metrics for token(s). Note that Token Metrics pricing data starts on 2019-01-01 for most tokens. More historical data will be available soon.
Inputs: category, exchange, fdv, limit, +5 more.
get_tokens_resistance_and_supportC
Fetch token(s) historical levels of resistance and support from Token Metrics API. Provide token_id or symbol.
Inputs: symbol (required), token_id (required), limit, page.
get_tokens_scenario_analysisC
Fetch tokens(s) price prediction based on different Crypto Market scenarios from Token Metrics API.
Inputs: limit, page, symbol, token_id.
get_tokens_trader_gradeC
Fetch token(s) trader grade including the 24h percent change for the trader grade for a specific date or date range from Token Metrics API.
Inputs: category, endDate, exchange, fdv, +9 more.
get_tokens_trading_signalC
Fetch token(s) AI generated trading signals for long and short positions for a specific date or date range from Token Metrics API.
Inputs: category, endDate, exchange, fdv, +8 more.
get_top_tokens_by_market_capC
Fetch the the list of coins with top market cap from Token Metrics API.
Inputs: page, top_k.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 19 tools
Most tools have distinct purposes targeting specific data types like indices, tokens, or market metrics, but there is some overlap between get_tokens_data and get_tokens_price which could cause confusion. The descriptions help clarify, but agents might misselect between these for basic token information.
All tool names follow a consistent verb_noun pattern using snake_case, starting with 'get_' followed by descriptive nouns (e.g., get_crypto_investors, get_tokens_ai_report). This uniformity makes the set predictable and easy to navigate.
With 19 tools, the count is borderline high for a crypto analytics server, potentially overwhelming for agents. While it covers many aspects, it feels heavy and could benefit from consolidation, such as merging some token-related tools.
The tool set provides comprehensive coverage for crypto analytics, including data fetching for investors, indices, market metrics, sentiment, and detailed token analyses (e.g., reports, grades, signals). No obvious gaps exist; agents can perform a wide range of investment and research tasks.
Related MCP Connectors
Unlock the power of real-time cryptocurrency data with our Crypto Price Insights MCP server.
Official Intrinio MCP server. US stock prices, options and fundamentals for AI agents.
The Octagon MCP server provides specialized AI-powered financial research and analysis by integrating with the Octagon Market Intelligence API. It enables users to analyze public market data (SEC filings, earnings transcripts, financial metrics, and stock data for 8000+ companies), private market data (3M+ companies, 500k+ funding rounds, 2M+ M&A/IPO transactions), and conduct deep research including web scraping capabilities. The server also features autonomous research agents that search hundreds of sources and return fully cited reports in approximately one minute.
Crypto market & research MCP for AI agents: prices, derivatives, options, on-chain, sentiment, news.
Related MCP Servers
- MIT
- AlicenseNot gradedqualityCmaintenanceSatellite Tracking MCP Server4MIT
- MIT

Tigris MCP Serverofficial
AlicenseNot gradedqualityBmaintenance🚀 Tigris MCP Server implements the MCP specification to create a seamless connection between AI agents and Tigris key features like bucket and object management.115 npm4MIT