MCP Tools Reference

Overview

The Thrust MCP server provides 10+ specialized tools that enable AI assistants to interact with tokens, social features, and blockchain operations. Each tool is optimized for specific tasks and includes built-in validation and error handling.

All tools require authentication via Bearer token (API key) or OAuth 2.0 flow.

Token Operations

create_token

Deploy a new token or meme coin on blockchain with custom branding. Capabilities:

Create tokens on Base or Base Sepolia networks
Custom name, symbol, and description
Upload logo, banner, and promotional video
Add social media links (Twitter, Discord, Telegram, YouTube, Website)
Tag with hashtags for discovery
Optional auto-execution (one-step deployment)

Parameters:

name (required): Token name (e.g., “Doge Coin”, “Rocket Token”)
symbol (required): 2-10 character ticker (e.g., “DOGE”, “REKT”)
description (required): Token description and story
image (required): Logo URL or file path (PNG, JPEG, GIF, WEBP, SVG)
chainSlug (required): “base” or “base-sepolia”
banner (optional): Banner image URL or path
video (optional): Promotional video URL or path
links (optional): Object with social media URLs
tags (optional): Array of hashtags
autoExecute (optional): Auto-deploy on-chain (default: false)
userAddress (optional): Custom wallet address

Example:

{
  name: "Rocket Dog",
  symbol: "RDOG",
  description: "The fastest dog in crypto, heading to the moon!",
  image: "https://example.com/rocket-dog.png",
  chainSlug: "base-sepolia",
  links: {
    twitter: "https://twitter.com/rocketdog",
    website: "https://rocketdog.com"
  },
  tags: ["meme", "dog", "moon"],
  autoExecute: true
}

Response:

{
  "success": true,
  "tokenId": "uuid-here",
  "contractAddress": "0x742d35Cc...",
  "transactionHash": "0x9f3b2c..."
}

get_tokens

Browse and discover tokens with filtering and sorting options. Capabilities:

Filter by trending, new, popular, or top posts
Search by hashtag/category
Pagination support
Filter verified tokens only
Get holder counts, vote data, and creator info

Parameters:

filter (required): “trending” | “new” | “popular” | “top_posts”
limit (optional): Max results (1-100, default: 20)
offset (optional): Pagination offset (default: 0)
hashtag_name (optional): Filter by hashtag
verified_only (optional): Only verified tokens (default: false)

Example:

{
  filter: "trending",
  limit: 10,
  hashtag_name: "defi"
}

Response:

{
  "tokens": [
    {
      "id": "uuid",
      "name": "DeFi Token",
      "symbol": "DEFI",
      "contract_address": "0x...",
      "holders_count": 1250,
      "upvote_count": 450,
      "downvote_count": 12,
      "creator": {...}
    }
  ],
  "total": 156
}

search_token

Find a specific token by address, slug, or name. Capabilities:

Search by contract address (0x…)
Search by URL-friendly slug
Partial name matching
Returns full token details including price and market cap

Parameters:

input (required): Contract address, slug, or partial name

Example:

{
  input: "0x742d35Cc6634C0532925a3b844Bc454e4438f44e"
}
// or
{
  input: "rocket-dog"
}
// or
{
  input: "doge"
}

Response:

{
  "id": "uuid",
  "name": "Rocket Dog",
  "symbol": "RDOG",
  "contract_address": "0x742d35Cc...",
  "price_usd": "0.0042",
  "market_cap": "420000",
  "description": "The fastest dog in crypto...",
  "image_url": "https://...",
  "holders_count": 350
}

trade_token

Buy or sell tokens with automatic execution. Capabilities:

Buy with exact USD input or exact token output
Sell with exact token input or exact USD output
Auto-switches between RobinSwap (new tokens) and UniswapV3 (graduated)
Optional auto-execution
Slippage protection

Parameters:

tokenId (required): UUID of token to trade
chainSlug (required): “base” or “base-sepolia”
direction (required): “buy” | “sell”
buyAmountUSD (optional): USD to spend when buying
buyAmountToken (optional): Token amount to receive when buying
sellAmountToken (optional): Token amount to sell
sellAmountUSD (optional): USD to receive when selling
autoExecute (optional): Execute immediately (default: false)
userAddress (optional): Custom wallet address

Example - Buy:

{
  tokenId: "uuid-here",
  chainSlug: "base",
  direction: "buy",
  buyAmountUSD: 100,  // Spend $100
  autoExecute: true
}

Example - Sell:

{
  tokenId: "uuid-here",
  chainSlug: "base",
  direction: "sell",
  sellAmountToken: 1000,  // Sell 1000 tokens
  autoExecute: true
}

Response:

{
  "success": true,
  "transactionHash": "0x9f3b2c...",
  "inputAmount": "100",
  "outputAmount": "23809.52",
  "protocol": "RobinSwap"
}

quote_trade_token

Get a price quote without executing a trade. Capabilities:

Preview trade amounts before execution
No gas fees (quote only)
Real-time pricing
Shows which protocol will be used

Parameters:

tokenId (required): UUID of token
chainSlug (required): “base” or “base-sepolia”
direction (optional): “buy” | “sell” (default: “sell”)
amount (optional): Amount to quote (default: 1)
inputToken (optional): “token” | “usdc” (default: “token”)

Example:

{
  tokenId: "uuid-here",
  chainSlug: "base",
  direction: "buy",
  amount: 100,
  inputToken: "usdc"  // How many tokens for $100?
}

Response:

{
  "inputAmount": "100",
  "outputAmount": "23809.52",
  "protocol": "RobinSwap",
  "isGraduated": false,
  "timestamp": "2025-11-04T22:30:00Z"
}

create_post

Create posts, replies, or comments with rich media. Capabilities:

Write posts with text content
Reply to existing posts (threaded discussions)
Attach images, videos, GIFs, links
Create polls with weighted voting
Tag tokens/coins
Post to clubs or topics

Parameters:

content (required): Post text content
parentPostId (optional): UUID of post to reply to (REQUIRED for replies)
taggedCoinId (optional): Tag a token
title (optional): Post title
imageUrl (optional): Single image URL
mediaData (optional): Array of media attachments
pollData (optional): Poll configuration
clubId (optional): Post to specific club
topicId (optional): Post to specific topic

Example - Simple Post:

{
  content: "Just bought my first RDOG tokens! To the moon! 🚀",
  taggedCoinId: "token-uuid-here"
}

Example - Reply:

{
  content: "Great analysis! I agree with your price target.",
  parentPostId: "post-uuid-to-reply-to"
}

Example - Poll:

{
  content: "What's the next 100x token?",
  pollData: {
    question: "Which token will 100x first?",
    isWeighted: true,
    options: [
      { id: "1", text: "RDOG", emoji: "🐕" },
      { id: "2", text: "MOON", emoji: "🌙" },
      { id: "3", text: "PEPE", emoji: "🐸" }
    ]
  }
}

Response:

{
  "id": "post-uuid",
  "content": "Just bought my first RDOG tokens!...",
  "created_at": "2025-11-04T22:30:00Z",
  "user_id": "user-uuid",
  "upvote_count": 0,
  "reply_count": 0
}

get_token_posts

View posts from token timelines and communities. Capabilities:

Get posts for specific tokens or general feed
Filter by content type (posts, polls, media)
Sort by trending, new, or popular
Filter by following or all users
View your own posts/replies
Pagination support

Parameters:

token_id (optional): Filter posts for specific token
category (optional): “timelines” | “polls” | “media”
sort (optional): “trending” | “new” | “popular”
filter (optional): “following” | “all” (default: “all”)
view_filter (optional): “my_posts” | “my_replies”
limit (optional): Max results (1-100, default: 20)
offset (optional): Pagination offset (default: 0)

Example:

{
  token_id: "token-uuid",
  category: "timelines",
  sort: "trending",
  limit: 20
}

Response:

{
  "posts": [
    {
      "id": "uuid",
      "content": "This token is going places!",
      "user": {...},
      "upvote_count": 42,
      "reply_count": 8,
      "created_at": "2025-11-04T22:00:00Z",
      "media": [...]
    }
  ],
  "total": 156
}

vote

Vote (upvote/downvote) on tokens, posts, polls, or livestreams. Capabilities:

Upvote or downvote content
Weighted voting based on token holdings
Vote on tokens, posts, poll options, livestreams
Optional voting token for weight calculation

Parameters:

content_id (required): UUID of content to vote on
content_type (required): “token” | “post” | “poll_option” | “livestream”
vote_type (required): “upvote” | “downvote”
voting_token_id (optional): Token for weighted voting
post_id (optional): Required when voting on poll options

Example - Upvote Post:

{
  content_id: "post-uuid",
  content_type: "post",
  vote_type: "upvote"
}

Example - Vote in Poll:

{
  content_id: "poll-option-uuid",
  content_type: "poll_option",
  vote_type: "upvote",
  post_id: "poll-post-uuid",
  voting_token_id: "token-uuid"  // Weight vote by holdings
}

Response:

{
  "id": "vote-uuid",
  "content_id": "post-uuid",
  "vote_type": "upvote",
  "created_at": "2025-11-04T22:30:00Z"
}

Blockchain Operations

execute_transaction

Execute blockchain transactions on-chain. Capabilities:

Send transactions with custom data
Automatic gas fee calculation
Support for Base and Base Sepolia
Required for deploying tokens (after create_token)

Parameters:

to (required): Recipient address (0x…)
amount (required): Amount in wei (as string)
chainSlug (required): “base” | “base-sepolia”
data (optional): Transaction data (hex string)

Example:

{
  to: "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
  amount: "1000000000000000000",  // 1 ETH in wei
  chainSlug: "base",
  data: "0x..."
}

Response:

{
  "transactionHash": "0x9f3b2c...",
  "success": true
}

This tool executes real blockchain transactions. Always verify transaction details before confirming!

Discovery & Search

get_hashtag_token

Look up the token associated with a hashtag. Capabilities:

Find tokens by hashtag name
Get token details for hashtag communities
Useful for trading hashtag tokens

Parameters:

hashtag_name (required): Hashtag without # symbol

Example:

{
  hashtag_name: "defi"
}

Response:

{
  "token": {
    "id": "uuid",
    "name": "DeFi Token",
    "symbol": "DEFI",
    "contract_address": "0x...",
    "hashtag": "defi"
  }
}

Tool Combinations

AI assistants can chain multiple tools together for complex workflows:

Example: Research → Buy Flow

search_token("rocket dog")
get_token_posts(token_id)  // Research sentiment
quote_trade_token(...)      // Check price
trade_token(..., autoExecute: true)  // Execute buy

Example: Create → Promote Flow

create_token(..., autoExecute: true)
create_post("Check out my new token!", taggedCoinId)
get_tokens(filter: "new")  // See if it appears in feed

Example: Community Engagement

get_tokens(filter: "trending")
get_token_posts(token_id, sort: "popular")
create_post("Great community!", parentPostId)  // Reply
vote(post_id, "upvote")

Error Handling

All MCP tools return standardized error responses:

{
  "error": "Error message",
  "code": "ERROR_CODE",
  "details": {...}
}

Common Error Codes:

AUTHENTICATION_FAILED - Invalid API key or OAuth token
INSUFFICIENT_BALANCE - Not enough funds for transaction
INVALID_PARAMETERS - Missing or invalid parameters
NETWORK_ERROR - Blockchain network issues
RATE_LIMIT_EXCEEDED - Too many requests
TOKEN_NOT_FOUND - Token doesn’t exist
TRANSACTION_FAILED - On-chain transaction reverted

Rate Limits

Anonymous: 10 requests/minute
Authenticated: 100 requests/minute
Premium: 1000 requests/minute

The MCP server automatically handles rate limiting and will queue requests when necessary.

Best Practices

Always Quote Before Trading

Use quote_trade_token before trade_token to preview amounts and avoid surprises.

Use autoExecute Carefully

Set autoExecute: false when learning. Only use autoExecute: true when you understand the action.

Test on Testnet First

Use Base Sepolia for testing token creation and trading before mainnet.

Include Context in Searches

Provide as much context as possible when searching tokens (symbol, name, or address).

Tag Tokens in Posts

Always use taggedCoinId when posting about tokens to increase visibility.

Use Weighted Voting

Specify voting_token_id to give your votes more weight based on holdings.

Next Steps

Example Prompts

Get inspired with ready-to-use examples

API Reference

Explore the underlying REST API

Quickstart Guide

Set up your first MCP connection

Support

Get help from our team

Get Started

MCP Server

API Reference

Overview

Token Operations

create_token

get_tokens

search_token

trade_token

quote_trade_token

create_post

get_token_posts

vote

Blockchain Operations

execute_transaction

Discovery & Search

get_hashtag_token

Tool Combinations

Example: Research → Buy Flow

Example: Create → Promote Flow

Example: Community Engagement

Error Handling

Rate Limits

Best Practices

Next Steps

Example Prompts

API Reference

Quickstart Guide

Support

Get Started

MCP Server

API Reference

​Overview

​Token Operations

​create_token

​get_tokens

​search_token

​trade_token

​quote_trade_token

​Social Features

​create_post

​get_token_posts

​vote

​Blockchain Operations

​execute_transaction

​Discovery & Search

​get_hashtag_token

​Tool Combinations

​Example: Research → Buy Flow

​Example: Create → Promote Flow

​Example: Community Engagement

​Error Handling

​Rate Limits

​Best Practices

​Next Steps

Example Prompts

API Reference

Quickstart Guide

Support

Overview

Token Operations

create_token

get_tokens

search_token

trade_token

quote_trade_token

Social Features

create_post

get_token_posts

vote

Blockchain Operations

execute_transaction

Discovery & Search

get_hashtag_token

Tool Combinations

Example: Research → Buy Flow

Example: Create → Promote Flow

Example: Community Engagement

Error Handling

Rate Limits

Best Practices

Next Steps