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

# Overview

> The official Tokenomist MCP Server — connect AI agents to crypto tokenomics data: unlock schedules, emissions, allocations, fundraising rounds, burns, and buybacks.

The Tokenomist MCP Server makes Tokenomist's tokenomics dataset directly available to your AI models and applications. MCP (Model Context Protocol) is an open standard that lets large language models and AI agents securely and intelligently interact with external data sources and tools. Connect once and let your agent answer real questions about token supply, unlock pressure, fundraising history, and on-chain treasury activity.

## What you can do

With Tokenomist MCP, your agents can:

* **Look up tokens and metadata** — Search by name, symbol, or slug and pull supply, market cap, price, and full tokenomics for any tracked token.
* **Analyze unlocks** — Query per-token unlock history, cross-token unlock overviews, and the next upcoming unlock per token — filtered by market cap, released %, date range, amount, value-to-market-cap, or allocation category.
* **Inspect emissions** — Pull weekly or daily emission (unlock) schedules with per-allocation breakdowns and cumulative totals.
* **Break down allocations** — Retrieve the standard allocation distribution (Team, Investors, Ecosystem, etc.) with locked vs unlocked amounts per category.
* **Trace fundraising** — List all investors and VCs, drill into a specific investor's funding rounds, or pull a token's full fundraising history with rounds, valuations, and participants.
* **Track burns and buybacks** — List tokens with burn or buyback programs and pull detailed event histories — dates, amounts, USD values, and addresses.
* **List your own token** — Submit your token's tokenomics to Tokenomist's self-listing platform, straight from a conversation with your assistant.

## Next steps

<CardGroup cols={2}>
  <Card title="Getting started" icon="rocket" href="/mcp/getting-started">
    Point any MCP-compatible client at our hosted endpoint and connect in minutes.
  </Card>

  <Card title="Authentication" icon="lock" href="/mcp/authentication">
    How the one-time OAuth sign-in works, scopes, and troubleshooting.
  </Card>

  <Card title="Tools & prompts" icon="toolbox" href="/mcp/tools">
    The 16 read-only tokenomics tools, suggested workflows, and example prompts.
  </Card>

  <Card title="Self-listing" icon="rocket-launch" href="/mcp/self-listing">
    List your token's tokenomics on Tokenomist directly from your assistant.
  </Card>

  <Card title="Tokenomist CLI" icon="terminal" href="/cli/getting-started">
    Prefer the terminal? The Tokenomist CLI exposes the same data.
  </Card>
</CardGroup>

## Good to know

* The Tokenomist MCP Server runs on a stable, monitored, multi-replica deployment with 24/7 uptime.
* All tokenomics-data tools are read-only — no on-chain actions. The self-listing tools are the one exception: they can create, update, and submit token listing drafts on your behalf (see [Self-listing](/mcp/self-listing)).
* Access is gated by OAuth 2.1; a Tokenomist API key is required to authorize your client (one-time browser flow).
* Tokens are short-lived and refreshed silently. Rotating your API key revokes existing sessions instantly.
* Your API key is never sent to your MCP client — it stays between you and the Tokenomist sign-in page.

***

The Tokenomist MCP Server is built and operated by [Tokenomist](https://tokenomist.ai). Have feedback, a bug to report, or a feature request? Reach out to the Tokenomist team at [tokenomist.ai](https://tokenomist.ai).