Token Metrics MCP Server

What is Token Metrics MCP Server about?

Offers real‑time crypto prices, market metrics, AI‑generated trading signals, technical analysis, sentiment insights, and quantitative grading through a Model Context Protocol (MCP) endpoint that can be invoked by AI tools.

How to use Token Metrics MCP Server?

1. Hosted HTTP transport – Add a server entry with the URL https://mcp.tokenmetrics.com and include the x-api-key header containing your Token Metrics API key.
2. Local installation via npx – Set the environment variable TOKEN_METRICS_API_KEY and run npx -y @token-metrics-ai/mcp@latest. The local server then listens on the standard MCP JSON‑RPC endpoint (POST /).
3. Call any of the provided functions (e.g., get_tokens_price, get_market_metrics) from an AI client that supports MCP.

Key features of Token Metrics MCP Server

• Real‑time token prices, market cap, volume, and OHLCV data
• AI‑generated trading signals for long/short positions
• Short‑term trader grades and long‑term investor grades
• Technical support/resistance levels and correlation analysis
• Market‑wide analytics, sentiment scores, and quantitative metrics
• Scenario‑based price predictions and AI‑written token reports
• Index data: active/passive crypto indices, performance, holdings

Use cases of Token Metrics MCP Server

• AI‑driven trading bots that fetch live prices and automatically act on trading signals.
• Research assistants that generate token reports, grades, and scenario analysis for analysts.
• Portfolio dashboards that pull index holdings and performance metrics in real time.
• Sentiment monitoring tools that combine market sentiment with price data for risk assessment.
• Educational platforms that demonstrate technical analysis concepts using live crypto data.

FAQ from the Token Metrics MCP Server

• How do I obtain an API key? Create an account on Token Metrics, go to the API Dashboard, and generate a new key.
• Which authentication method is required? Pass the key in the x-api-key HTTP header (hosted) or set the TOKEN_METRICS_API_KEY env variable (local).
• What limits apply to the API? Standard Token Metrics rate limits apply; the server will retry and surface rate‑limit errors gracefully.
• Can I run the server offline? Yes, after installing locally with npx you can operate without internet access, though data fetching still requires connectivity to Token Metrics endpoints.
• What Node.js version is required? Node 18 or higher.
• How do I test the server locally? Build the project (npm run build) and run it with the MCP Inspector: npx @modelcontextprotocol/inspector node build/src/cli.js.

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

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:

• Smithery: https://smithery.ai/server/@token-metrics/mcp
• Glama AI: https://glama.ai/mcp/servers/@token-metrics/mcp
• MCP.so: https://mcp.so/server/mcp/token-metrics
• 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 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

2. Install dependencies:

npm install

3. Set your API key:

export TOKEN_METRICS_API_KEY=your_api_key_here

4. 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

• Documentation: Token Metrics API Docs
• Issues: GitHub Issues
• Support: Token Metrics Support

License

MIT License - see LICENSE file for details.