MCP Tools Reference

​

Overview

​

Token Operations

​

create_token

• 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)

• 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

{
  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
}

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

​

get_tokens

• 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

• 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)

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

{
  "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

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

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

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

{
  "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 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

• 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

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

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

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

​

quote_trade_token

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

• 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”)

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

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

​

Blockchain Operations

​

execute_transaction

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

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

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

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

​

Tool Combinations

​

Example: Research → Buy Flow

1. search_token("rocket dog")
2. quote_trade_token(...)      // Check price
3. trade_token(..., autoExecute: true)  // Execute buy

​

Example: Create → Trade Flow

1. create_token(..., autoExecute: true)
2. get_tokens(filter: "new")  // Verify token appears
3. quote_trade_token(...)     // Get initial price

​

Example: Price Comparison

1. get_tokens(filter: "trending")
2. Loop through each token
3. quote_trade_token(...) for each to compare prices

​

Error Handling

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

• 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

​

Best Practices

​

Next Steps