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

> Connect Thrust to AI assistants via Model Context Protocol

## What is the Thrust MCP Server?

The Thrust MCP (Model Context Protocol) server enables AI assistants like Claude, ChatGPT, Cursor, and Windsurf to interact directly with the Thrust platform. This allows AI to:

* **Create and deploy tokens** on blockchain networks
* **Trade tokens** with automatic price quotes and execution
* **Create posts and replies** in the Thrust social feed
* **Vote on content** with weighted voting
* **Search and discover** tokens, posts, and communities
* **Execute blockchain transactions** on your behalf

## See It In Action

Watch how easy it is to integrate Thrust with your AI assistant:

<CardGroup cols={2}>
  <Card title="Claude Code Integration" icon="terminal">
    <iframe width="100%" height="200" 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'}} />
  </Card>

  <Card title="Claude Desktop Integration" icon="desktop">
    <iframe width="100%" height="200" 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'}} />
  </Card>
</CardGroup>

## Why Use the MCP Server?

<CardGroup cols={2}>
  <Card title="Natural Language Trading" icon="comments-dollar">
    Trade tokens by simply describing what you want: "Buy 100 USDC worth of TOKEN" or "Sell half my holdings"
  </Card>

  <Card title="Token Creation" icon="coins">
    Launch tokens through conversation: "Create a meme coin called DogeCat with symbol DOGCAT"
  </Card>

  <Card title="Social Automation" icon="robot">
    Let AI handle posting, voting, and community engagement based on your preferences
  </Card>

  <Card title="Cross-Platform" icon="layer-group">
    Works with Claude Code, Claude Desktop, ChatGPT, Cursor, Windsurf, and any MCP-compatible client
  </Card>
</CardGroup>

## Quick Start

Get started in minutes with your preferred AI assistant:

<CardGroup cols={2}>
  <Card title="Claude Code" icon="terminal" href="/mcp-quickstart#claude-code">
    Add Thrust to Claude Code CLI with one command
  </Card>

  <Card title="Claude Desktop" icon="desktop" href="/mcp-quickstart#claude-desktop">
    Connect via Settings → Connectors
  </Card>

  <Card title="ChatGPT" icon="comment" href="/mcp-quickstart#chatgpt">
    Add custom connector in ChatGPT settings
  </Card>

  <Card title="Cursor & Windsurf" icon="code" href="/mcp-quickstart#cursor-windsurf">
    Configure MCP in your code editor
  </Card>
</CardGroup>

## Available Capabilities

The MCP server provides 10+ tools for comprehensive Thrust integration:

### Token Operations

* **create\_token** - Deploy new tokens on Base or BNB networks with custom branding
* **search\_token** - Find tokens by name, symbol, or contract address
* **get\_tokens** - Browse trending, new, or popular tokens with filters
* **trade\_token** - Buy or sell tokens with automatic quote execution
* **quote\_trade\_token** - Get price quotes without executing trades

### Social Features

* **create\_post** - Write posts, replies, and comments with media attachments
* **get\_token\_posts** - View posts from token timelines and communities
* **vote** - Upvote or downvote tokens, posts, polls, and livestreams

### Blockchain

* **execute\_transaction** - Send transactions on-chain with gas fee handling
* **get\_hashtag\_token** - Look up tokens associated with hashtags

## Security & Authentication

* **Non-custodial**: The MCP server uses your Thrust account but never stores private keys
* **OAuth 2.0**: Secure authentication flow when connecting
* **API Keys**: Bearer token authentication for programmatic access
* **Scoped Access**: Only performs actions you explicitly authorize

## How It Works

```mermaid theme={null}
graph LR
    A[AI Assistant] -->|MCP Protocol| B[Thrust MCP Server]
    B -->|REST API| C[Thrust Platform]
    C -->|Blockchain RPC| D[Base/BNB Networks]
    C -->|Database| E[Supabase]
```

1. **AI asks you** what you want to do
2. **AI calls MCP tools** with your request
3. **MCP server authenticates** with your credentials
4. **Actions execute** on Thrust platform
5. **Results return** to AI for confirmation

## Getting Your API Key

To connect the MCP server, you'll need an API key:

1. Visit [demo.onthrust.com](https://demo.onthrust.com)
2. Hover over your **profile avatar** in the header
3. Click to copy your **API key**

<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" width="308" height="220" data-path="images/api-key-copy.png" />

## Next Steps

<CardGroup cols={2}>
  <Card title="Installation Guide" icon="download" href="/mcp-quickstart">
    Step-by-step setup for your AI assistant
  </Card>

  <Card title="Tools Reference" icon="book" href="/mcp-tools">
    Complete documentation of all available MCP tools
  </Card>

  <Card title="Example Prompts" icon="comments" href="/mcp-examples">
    Ready-to-use prompts for common tasks
  </Card>

  <Card title="API Reference" icon="code" href="/api-reference">
    Direct API access for custom integrations
  </Card>
</CardGroup>

## Support

Need help with MCP server setup?

* Email: [support@onthrust.com](mailto:support@onthrust.com)
* Discord: [Join our community](https://discord.gg/thrust)
