Skip to main content
Glama
Token Metrics MCP Server

Token Metrics MCP Server

Official

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@latest

Connection Methods

HTTP Transport (Hosted)

  • URL: https://mcp.tokenmetrics.com

  • Authentication: Use x-api-key header with your Token Metrics API key

  • Benefits:

    • 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:

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 information

  • get_tokens_price - Get current token prices

  • get_tokens_hourly_ohlcv - Hourly OHLCV data

  • get_tokens_daily_ohlcv - Daily OHLCV data

Trading & Analysis

  • get_tokens_trading_signal - AI-generated trading signals

  • get_tokens_trader_grade - Short-term trader grades

  • get_tokens_investor_grade - Long-term investor grades

  • get_tokens_resistance_and_support - Technical support/resistance levels

  • get_tokens_correlation - Token correlation analysis

Market Intelligence

  • get_market_metrics - Overall market analytics

  • get_sentiment - Market sentiment analysis

  • get_tokens_quant_metrics - Quantitative metrics

  • get_tokens_scenario_analysis - Price prediction scenarios

Research & Reports

  • get_tokens_ai_report - AI-generated token reports

  • get_crypto_investors - Crypto investor information

  • get_top_tokens_by_market_cap - Top tokens by market cap

Indices & Portfolio

  • get_indices - Fetch active and passive crypto indices

  • get_indices_performance - Historical performance data for indices

  • get_indices_holdings - Current holdings and weights for indices

Getting Your API Key

  1. Visit Token Metrics

  2. Sign up for an account

  3. Navigate to your API Dashboard

  4. Generate a new API key

  5. Use the API key with this MCP server

Development

Prerequisites

  • Node.js 18 or higher

  • npm or yarn

  • TypeScript

Local Development

  1. Clone the repository:

git clone https://github.com/token-metrics/mcp.git
cd mcp
  1. Install dependencies:

npm install
  1. Set your API key:

export TOKEN_METRICS_API_KEY=your_api_key_here
  1. Run in development mode:

npm run start:dev

Building

npm run build

Testing 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.js

Configuration

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

License

MIT License - see LICENSE file for details.

Available Tools

19 tools
get_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

    B3.4/5.0

    Scored across 19 tools

    Disambiguation4/5

    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.

    Naming Consistency5/5

    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.

    Tool Count3/5

    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.

    Completeness5/5

    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

    Related MCP Servers