> ## Documentation Index
> Fetch the complete documentation index at: https://tokenlayer-2a53bba4.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP Quickstart

> Get started with Thrust MCP server in minutes

## Prerequisites

Before connecting the Thrust MCP server, you'll need:

1. A Thrust account at [demo.onthrust.com](https://demo.onthrust.com)
2. Your API key (see [Getting Your API Key](#getting-your-api-key))
3. An MCP-compatible AI assistant (Claude Code, Claude Desktop, ChatGPT, Cursor, or Windsurf)

## Getting Your API Key

<Steps>
  <Step title="Visit Thrust Platform">
    Go to [demo.onthrust.com](https://demo.onthrust.com) and sign in
  </Step>

  <Step title="Access Profile Menu">
    Hover over your **profile avatar** in the top-right header
  </Step>

  <Step title="Copy API Key">
    Click to copy your API key to clipboard
  </Step>
</Steps>

<img src="https://mintcdn.com/tokenlayer-2a53bba4/AGXtgjpsHZFfY61H/images/api-key-copy.png?fit=max&auto=format&n=AGXtgjpsHZFfY61H&q=85&s=0c0da8673d296185ae85c28cfc0f15f9" alt="Copy API key from profile menu" style={{borderRadius: '8px', marginTop: '16px'}} width="308" height="220" data-path="images/api-key-copy.png" />

<Note>
  Keep your API key secure! It provides access to your Thrust account and can execute transactions on your behalf.
</Note>

***

## Claude Code

Claude Code is Anthropic's official CLI tool. Add Thrust with a single command:

<iframe width="100%" height="400" src="https://www.youtube.com/embed/PZF08dm4Kis" title="Claude Code MCP Integration Demo" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen style={{borderRadius: '8px', marginBottom: '24px'}} />

<Steps>
  <Step title="Run Installation Command">
    Open your terminal and run:

    ```bash theme={null}
    claude mcp add --transport http token-layer https://mcp-server.onthrust.com \
      --header "Authorization: Bearer YOUR_API_KEY"
    ```

    Replace `YOUR_API_KEY` with your actual API key from demo.onthrust.com
  </Step>

  <Step title="Verify Installation">
    Start a new Claude Code session:

    ```bash theme={null}
    claude
    ```

    Try: "Show me trending tokens on Thrust"
  </Step>
</Steps>

<Tip>
  Claude Code automatically includes the Authorization header in all MCP requests.
</Tip>

### Example Usage

```bash theme={null}
$ claude
You: Create a meme token called "Rocket Dog" with symbol RDOG

Claude: I'll help you create a token called "Rocket Dog" with symbol RDOG.
What blockchain would you like to deploy on?
1. Base (mainnet)
2. Base Sepolia (testnet)

You: Base Sepolia for testing

Claude: [Uses create_token MCP tool]
Token created successfully! Contract: 0x742d35Cc...
```

***

## Claude Desktop

Claude Desktop supports MCP through a visual connector interface:

<iframe width="100%" height="400" src="https://www.youtube.com/embed/mJgqSSxEaLw" title="Claude Desktop MCP Integration Demo" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen style={{borderRadius: '8px', marginBottom: '24px'}} />

<Steps>
  <Step title="Open Settings">
    Launch Claude Desktop and click the **Settings** icon (gear) in the bottom-left
  </Step>

  <Step title="Navigate to Connectors">
    Select **Connectors** from the settings menu
  </Step>

  <Step title="Add Custom Connector">
    Click **"Add Custom Connector"**
  </Step>

  <Step title="Enter Details">
    * **Name**: `Token Layer`
    * **URL**: `https://mcp-server.onthrust.com`

    Click **"Connect"**
  </Step>

  <Step title="Authenticate">
    You'll be redirected to authenticate with your Thrust account
  </Step>

  <Step title="Authorize">
    Review the permissions and click **"Authorize"** to grant access
  </Step>
</Steps>

### Visual Guide

<img src="https://mintcdn.com/tokenlayer-2a53bba4/AGXtgjpsHZFfY61H/images/claude-desktop-1-add-connector.png?fit=max&auto=format&n=AGXtgjpsHZFfY61H&q=85&s=624fe4cf27cc68e19bbb3e42a4dbec2c" alt="Step 1: Add connector button" style={{borderRadius: '8px', marginBottom: '16px'}} width="931" height="710" data-path="images/claude-desktop-1-add-connector.png" />

<img src="https://mintcdn.com/tokenlayer-2a53bba4/AGXtgjpsHZFfY61H/images/claude-desktop-2-add-connector-details.png?fit=max&auto=format&n=AGXtgjpsHZFfY61H&q=85&s=a97cd279ea32e65ece9b620007b3a647" alt="Step 2: Enter connector details" style={{borderRadius: '8px', marginBottom: '16px'}} width="551" height="412" data-path="images/claude-desktop-2-add-connector-details.png" />

<img src="https://mintcdn.com/tokenlayer-2a53bba4/AGXtgjpsHZFfY61H/images/claude-desktop-3-press-connect.png?fit=max&auto=format&n=AGXtgjpsHZFfY61H&q=85&s=0eecf2c576b17c73626a0c0d88d8f8a3" alt="Step 3: Press connect" style={{borderRadius: '8px', marginBottom: '16px'}} width="607" height="117" data-path="images/claude-desktop-3-press-connect.png" />

<img src="https://mintcdn.com/tokenlayer-2a53bba4/AGXtgjpsHZFfY61H/images/claude-desktop-authenticate.png?fit=max&auto=format&n=AGXtgjpsHZFfY61H&q=85&s=a44091c19da4ca4bfea97ac45627b2ac" alt="Step 4: Authenticate" style={{borderRadius: '8px', marginBottom: '16px'}} width="616" height="698" data-path="images/claude-desktop-authenticate.png" />

<img src="https://mintcdn.com/tokenlayer-2a53bba4/AGXtgjpsHZFfY61H/images/claude-desktop-authorize.png?fit=max&auto=format&n=AGXtgjpsHZFfY61H&q=85&s=6189708cd7d8763b85f7a2a089598062" alt="Step 5: Authorize access" style={{borderRadius: '8px', marginBottom: '16px'}} width="554" height="995" data-path="images/claude-desktop-authorize.png" />

<Success>
  Once connected, Claude Desktop can use all Thrust MCP tools in your conversations!
</Success>

***

## ChatGPT

ChatGPT supports custom MCP connectors through a similar interface:

<Steps>
  <Step title="Open Settings">
    In ChatGPT, click your profile icon and select **Settings**
  </Step>

  <Step title="Navigate to Connectors">
    Go to **Settings → Connectors**
  </Step>

  <Step title="Add Custom Connector">
    Click **"Add Custom Connector"**
  </Step>

  <Step title="Configure">
    * **Name**: `Token Layer`
    * **URL**: `https://mcp-server.onthrust.com`

    Click **"Connect"**
  </Step>

  <Step title="Complete OAuth Flow">
    Authenticate and authorize access (same as Claude Desktop)
  </Step>
</Steps>

<Note>
  The OAuth flow for ChatGPT is identical to Claude Desktop - you'll authenticate with Thrust and authorize the connection.
</Note>

***

## Cursor & Windsurf

Cursor and Windsurf are AI-powered code editors with MCP support:

### Configuration

<Steps>
  <Step title="Open MCP Settings">
    In Cursor/Windsurf, open settings and navigate to **MCP Servers** or **Connectors**
  </Step>

  <Step title="Add Server Configuration">
    Add a new MCP server with these details:

    ```json theme={null}
    {
      "name": "token-layer",
      "transport": "http",
      "url": "https://mcp-server.onthrust.com",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
    ```
  </Step>

  <Step title="Reload Editor">
    Restart Cursor/Windsurf to apply the configuration
  </Step>

  <Step title="Test Connection">
    Ask the AI: "What are the trending tokens on Thrust?"
  </Step>
</Steps>

### Alternative: Config File

You can also add the MCP server via config file:

<CodeGroup>
  ```json Cursor (mcp-config.json) theme={null}
  {
    "mcpServers": {
      "token-layer": {
        "transport": "http",
        "url": "https://mcp-server.onthrust.com",
        "headers": {
          "Authorization": "Bearer YOUR_API_KEY"
        }
      }
    }
  }
  ```

  ```json Windsurf (mcp-config.json) theme={null}
  {
    "mcpServers": {
      "token-layer": {
        "transport": "http",
        "url": "https://mcp-server.onthrust.com",
        "headers": {
          "Authorization": "Bearer YOUR_API_KEY"
        }
      }
    }
  }
  ```
</CodeGroup>

<Warning>
  Replace `YOUR_API_KEY` with your actual API key. Never commit API keys to version control!
</Warning>

***

## Testing Your Connection

Once connected, try these commands to verify everything works:

<CodeGroup>
  ```text Token Discovery theme={null}
  "Show me the top 5 trending tokens on Thrust"
  ```

  ```text Price Check theme={null}
  "What's the current price of token with symbol DOGE?"
  ```

  ```text Token Creation theme={null}
  "Help me create a test token on Base Sepolia"
  ```

  ```text Trading theme={null}
  "Get a quote for buying 50 USDC worth of token xyz"
  ```

  ```text Social theme={null}
  "Show me recent posts about DeFi tokens"
  ```
</CodeGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Authentication Failed">
    * Verify your API key is correct
    * Check that you copied the full key without extra spaces
    * Try generating a new API key from demo.onthrust.com
  </Accordion>

  <Accordion title="Connection Timeout">
    * Ensure you have internet connectivity
    * Check if [https://mcp-server.onthrust.com](https://mcp-server.onthrust.com) is accessible
    * Try again in a few minutes (may be temporary server issue)
  </Accordion>

  <Accordion title="Tool Not Found">
    * Verify the MCP server is properly configured
    * Restart your AI assistant
    * Check the [Tools Reference](/mcp-tools) for available tool names
  </Accordion>

  <Accordion title="Transaction Failed">
    * Ensure you have sufficient balance for gas fees
    * Check that you're using the correct network (mainnet vs testnet)
    * Review transaction details before confirming
  </Accordion>
</AccordionGroup>

## Security Best Practices

<CardGroup cols={2}>
  <Card title="Protect Your API Key" icon="shield-halved">
    Never share your API key or commit it to public repositories
  </Card>

  <Card title="Review Permissions" icon="list-check">
    Understand what actions the MCP server can perform on your behalf
  </Card>

  <Card title="Monitor Activity" icon="chart-line">
    Regularly check your transaction history on demo.onthrust.com
  </Card>

  <Card title="Revoke Access" icon="ban">
    You can revoke API keys anytime from your account settings
  </Card>
</CardGroup>

## Next Steps

<CardGroup cols={2}>
  <Card title="Explore MCP Tools" icon="wrench" href="/mcp-tools">
    Learn about all available tools and their capabilities
  </Card>

  <Card title="Example Prompts" icon="messages" href="/mcp-examples">
    Get inspired with ready-to-use prompt examples
  </Card>

  <Card title="API Reference" icon="book" href="/api-reference">
    Dive deeper into the underlying API
  </Card>

  <Card title="Get Support" icon="life-ring" href="mailto:support@onthrust.com">
    Contact us for help
  </Card>
</CardGroup>