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

# Getting started

> Point any MCP-compatible client at the Tokenomist hosted endpoint and connect in minutes.

Connecting your AI to Tokenomist is simple. Point any MCP-compatible client at our hosted endpoint. Most MCP clients — Claude Desktop, Claude Code, Cursor, ChatGPT, Gemini CLI, and others — can be configured with a single JSON snippet.

<Note>
  Make sure your device has `node` installed. You can download it from [nodejs.org/download](https://nodejs.org/en/download).
</Note>

## Server info

<Info>
  **Tokenomist MCP Server (Production)**

  * **Endpoint**: `https://mcp.tokenomist.ai/`
  * **Status**: Stable — monitored, multi-replica deployment with 24/7 uptime.
  * **Transport**: MCP Streamable HTTP.
  * **Auth**: OAuth 2.1 with PKCE. A Tokenomist API key is required (used once during sign-in). See [Authentication](/mcp/authentication).
  * **Best for**: Production AI agents and integrations, research assistants and chatbots that need tokenomics context, and quick prototyping against real Tokenomist data.
</Info>

## Configuration

Add the following to your client's MCP config file (e.g. `mcp_config.json` or `claude_desktop_config.json`):

```json theme={null}
{
  "mcpServers": {
    "tokenomist": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.tokenomist.ai/"
      ]
    }
  }
}
```

<Tip>
  **Where is my config file?** The file name and location depend on your client. See [modelcontextprotocol.io/quickstart](https://modelcontextprotocol.io/quickstart/user#2-add-the-filesystem-mcp-server) for client-specific paths.
</Tip>

## Connect your client

<Tabs>
  <Tab title="Claude Desktop (Free)">
    Free users **must use the Claude Desktop app** and modify the configuration file.

    <Steps>
      <Step title="Locate the config file">
        Find `claude_desktop_config.json` on your system by following the instructions [here](https://modelcontextprotocol.io/quickstart/user).
      </Step>

      <Step title="Add the server config">
        Add the [server configuration](#configuration) shown above.
      </Step>

      <Step title="Restart Claude Desktop">
        Restart the app for the changes to take effect.
      </Step>

      <Step title="Authorize">
        On first use, a browser tab opens to the Tokenomist sign-in page — paste your Tokenomist API key to authorize.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Claude Pro">
    <Steps>
      <Step title="Open Add connectors">
        In Claude ([claude.ai](https://claude.ai/) or the Desktop app), click **Add connectors** in your chat.
      </Step>

      <Step title="Add custom connector">
        Click **Add custom connector**.
      </Step>

      <Step title="Enter the server URL">
        Enter the remote MCP server URL: `https://mcp.tokenomist.ai/`
      </Step>

      <Step title="Authorize">
        Click **Add** — the Tokenomist sign-in page opens. Paste your API key to authorize.
      </Step>
    </Steps>

    <Tip>
      You can also follow the same steps as Free users by editing `claude_desktop_config.json`.
    </Tip>
  </Tab>

  <Tab title="Claude Code">
    Add the server to your Claude Code MCP config:

    ```bash theme={null}
    claude mcp add --transport http tokenomist https://mcp.tokenomist.ai/
    ```

    Or edit `~/.claude/mcp.json` (or your project-level `.mcp.json`) directly:

    ```json theme={null}
    {
      "mcpServers": {
        "tokenomist": {
          "type": "http",
          "url": "https://mcp.tokenomist.ai/"
        }
      }
    }
    ```

    Then authorize the server from inside Claude Code:

    <Steps>
      <Step title="Run /mcp">
        In Claude Code, type `/mcp` and press Enter to open the MCP server menu.
      </Step>

      <Step title="Select tokenomist-mcp">
        Choose **tokenomist-mcp** from the list of configured servers.
      </Step>

      <Step title="Select Authenticate">
        Choose **Authenticate** — Claude Code opens a browser tab to the Tokenomist sign-in page.
      </Step>

      <Step title="Paste your API key">
        On the authorization page, paste your Tokenomist API key and click **Authorize**. The browser redirects back and Claude Code shows the server as connected.

        <Frame caption="Paste your API key on the Tokenomist authorization page">
          <img src="https://mintcdn.com/daosurv/3D9fNYQZtMjpKdy_/images/mcp/authorize-api-key.png?fit=max&auto=format&n=3D9fNYQZtMjpKdy_&q=85&s=3d8a8456002b501adaad6c9ab6b46308" alt="Tokenomist authorization page" width="1920" height="1200" data-path="images/mcp/authorize-api-key.png" />
        </Frame>

        <Tip>
          Find your API key at [tokenomist.ai/profile#my-api-key](https://tokenomist.ai/profile#my-api-key) under the **My API Key** section.

          <Frame caption="Find your API key at tokenomist.ai/profile#my-api-key">
            <img src="https://mintcdn.com/daosurv/3D9fNYQZtMjpKdy_/images/mcp/find-api-key.png?fit=max&auto=format&n=3D9fNYQZtMjpKdy_&q=85&s=2170f779e3952ec152a7d0ad433a7dd4" alt="Tokenomist My API Key page" width="1869" height="973" data-path="images/mcp/find-api-key.png" />
          </Frame>
        </Tip>
      </Step>
    </Steps>
  </Tab>

  <Tab title="ChatGPT">
    OpenAI ChatGPT supports MCP connectors when the [developer mode](https://platform.openai.com/docs/guides/developer-mode) toggle is on.

    <Steps>
      <Step title="Enable Developer Mode">
        Open **Settings** > **Apps** > **Advanced Settings** and toggle **Developer Mode** on.
      </Step>

      <Step title="Open the New App form">
        In the Connectors modal, click **Create** to open the **New App** form.
      </Step>

      <Step title="Fill in the fields">
        * **Name**: `Tokenomist` (any name works)
        * **Connection**: keep **Server URL** selected and enter `https://mcp.tokenomist.ai/`
        * **Authentication**: select **OAuth**

        You can leave Icon and Description blank. **Advanced OAuth settings** auto-populate from the server — no changes needed.
      </Step>

      <Step title="Acknowledge the risk and create">
        Tick **I understand and want to continue** (ChatGPT shows this for any custom MCP server), then click **Create**.
      </Step>

      <Step title="Sign in with Tokenomist">
        An **Add Tokenomist to ChatGPT** dialog appears. Click **Sign in with Tokenomist** to open the Tokenomist authorization page.
      </Step>

      <Step title="Paste your API key">
        On the Tokenomist page, paste your API key and click **Authorize**. ChatGPT redirects back with the connector linked.
      </Step>

      <Step title="Turn the tool on">
        Before prompting, choose **+** > **More** > **Developer Mode** and turn the Tokenomist MCP tool on.
      </Step>
    </Steps>
  </Tab>
</Tabs>

Once connected, head to [Tools & prompts](/mcp/tools) to see what your agent can do.