> ## Documentation Index
> Fetch the complete documentation index at: https://tokenterminal.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP Server

> Query Token Terminal data from any MCP-compatible AI client

The Token Terminal MCP server gives AI clients structured access to our onchain dataset — projects, products, chains, market sectors, financial metrics, and methodologies — through the [Model Context Protocol](https://modelcontextprotocol.io/).

It is a centrally hosted remote server compatible with Claude, ChatGPT, Cursor, and any other MCP-compatible client.

## Availability

The MCP server is available on every Token Terminal plan. The free tier includes full access to all tools and data with limited usage; paid plans raise the usage limits.

For higher limits or enterprise options, contact our team at [sales@tokenterminal.xyz](mailto:sales@tokenterminal.xyz).

## Setup guides

<CardGroup cols={2}>
  <Card title="Claude Code" icon="terminal" href="/mcp/claude-code">
    Set up MCP in Claude Code via the CLI.
  </Card>

  <Card title="Claude Desktop" icon="message-bot" href="/mcp/claude-desktop">
    Set up MCP in the Claude Desktop app.
  </Card>

  <Card title="ChatGPT" icon="comments" href="/mcp/chatgpt">
    Install the Token Terminal app from the ChatGPT app directory.
  </Card>

  <Card title="Codex CLI" icon="terminal" href="/mcp/codex">
    Set up MCP in Codex CLI.
  </Card>

  <Card title="Cursor" icon="i-cursor" href="/mcp/cursor">
    Set up MCP in the Cursor IDE.
  </Card>

  <Card title="Gemini CLI" icon="terminal" href="/mcp/gemini-cli">
    Set up MCP in Gemini CLI.
  </Card>

  <Card title="OpenCode" icon="terminal" href="/mcp/opencode">
    Set up MCP in OpenCode.
  </Card>

  <Card title="Microsoft Copilot Studio" icon="microsoft" href="/mcp/copilot-studio">
    Set up MCP in Microsoft Copilot Studio.
  </Card>

  <Card title="Other clients" icon="plug" href="/mcp/other-clients">
    Use MCP with any compatible client.
  </Card>
</CardGroup>

## How it works

The server is hosted at `https://mcp.tokenterminal.com/mcp` and implements the [authenticated remote MCP specification](https://modelcontextprotocol.io/specification) over the Streamable HTTP transport. Clients connect directly — there is no local proxy or companion process to run.

Authentication is handled by **OAuth 2.1 with PKCE**, so no API keys or long-lived secrets are exchanged with your client. The first connection opens a browser window in which you sign in to Token Terminal and select the user account and organization the session will operate under. Your client stores the resulting access token and refreshes it transparently.

## Available tools

The server exposes the following tools to connected clients.

<ResponseField name="discover">
  Resolve entity IDs for projects, chains, metrics, and products. Use this first to find the IDs needed by `get_timeseries`, `get_breakdown`, and `create_chart`.
</ResponseField>

<ResponseField name="get_timeseries">
  Fetch historical metric time series for projects, assets, products, chains, or market sectors.
</ResponseField>

<ResponseField name="get_breakdown">
  Fetch aggregated metric breakdowns — rankings, totals, and comparisons across projects, chains, products, assets, or market sectors.
</ResponseField>

<ResponseField name="get_methodologies">
  Fetch methodology content for any Token Terminal metric, or the included/excluded contract addresses behind a project metric.
</ResponseField>

<ResponseField name="create_chart">
  Create a saved Token Terminal chart from a metric configuration and return its shareable URL.
</ResponseField>

<ResponseField name="asset_research">
  AI-powered analyst for tokens, stablecoins, RWAs, and commodities. Maintains conversation memory across calls.
</ResponseField>

<ResponseField name="research_assistant">
  Experimental all-rounder for broader semantic analytics across projects, chains, ecosystems, assets, and mixed analytical questions. Maintains conversation memory across calls.
</ResponseField>