# Token Metrics — how to use (mcp.ai)

Connect your Token Metrics account and use 5 tools for analytics straight from your AI agent. Connect with your own API key. Token Metrics provides an API offering real-time, AI-powered cryptocurrency data and insights for developers to build trading bots, dashboards, and portfolio tools.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_token_metrics?ms=1787295960000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `token_metrics_get_price`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/token_metrics`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/token_metrics/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/token_metrics/get/price` — Tool to retrieve real-time price and market metrics for a given cryptocurrency. Use when you need the latest price, volume, and market cap information for trading or analysis. Response fields like `vo
  - body: { limit?: integer, currency?: string, token_id: string }
- `POST https://api.mcp.ai/api/token_metrics/get/technical/indicators` — Tool to retrieve technical indicators for a token. Use when you need technical analysis data for a specific symbol, interval, and indicator.
  - body: { limit?: integer, symbol: string, end_time?: string, exchange?: string, interval: string, indicator: string, start_time?: string }
- `POST https://api.mcp.ai/api/token_metrics/get/tokens` — Tool to retrieve a paginated list of supported tokens with metadata. Use when you need comprehensive token listings across price, market cap, supply, and contract details. Returns token_id values requ
  - body: { page?: integer, limit?: integer, search?: string, sort_by?: string, category?: string, price_max?: number, price_min?: number, blockchain?: string, sort_order?: string, market_cap_max?: number, market_cap_min?: number }
- `POST https://api.mcp.ai/api/token_metrics/get/top/market/cap/tokens` — Tool to retrieve a list of tokens ranked by market capitalization. Use when you need an overview of the most valuable cryptocurrencies.
  - body: { page?: integer, limit?: integer, sector?: string, currency?: string }
- `POST https://api.mcp.ai/api/token_metrics/get/trading/signals` — Tool to retrieve entry and exit crypto trading signals. Use when optimizing trading strategies with signal-based insights.
  - body: { limit?: integer, offset?: integer, symbol?: string, exchange?: string, timeframe?: string, signal_type?: string }

## Example prompts
- "What can I do in Token Metrics?"
- "Show me a summary of my Token Metrics account"

## More
- Page: https://mcp.ai/token_metrics
- Agent spec (llms.txt): https://mcp.ai/token_metrics/llms.txt
- Postman collection: https://mcp.ai/token_metrics/postman.json