The Birdeye MCP Server is now officially live—bringing real-time, on-chain crypto data directly to AI models and intelligent applications. With Birdeye MCP, you can power your systems with:

• Live discovery of trending tokens, new launches, top movers, and hot pools across the Web3 space
• Rich metadata including token logos, descriptions, categories, links, contract addresses, and safety signals
• Complete historical datasets with price, volume, and OHLCV for robust analysis and backtesting

Getting Started

Set your API Key ready and let's get started! The MCP Server's tools are available as per our API Documentation.

Important Notes:

• API key is required for all integrations
• Most MCP-compatible clients can be configured using a JSON config file (commonly named mcp_config.json, but this varies by client)
• Local MCP Server is a Work in Progress—we will announce it as soon as it's ready

Integration

Claude Desktop

• Download and install Claude Desktop
• Obtain your Birdeye API key from the Birdeye Developer Portal

Configuration Steps

1. Locate your Claude Desktop config file at:
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
2. Edit the configuration file to include the Birdeye MCP server:

{
    "mcpServers": {
        "birdeye-api-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "mcp-remote@latest",
                "https://dev-mcp.birdeye.so/mcp",
                "--header",
                "x-api-key: <YOUR_API_KEY>"
            ],
            "env": {
                "AUTH_TOKEN": "xxxx"
            }
        }
    }
}

3. Replace placeholders with your actual credentials:
   • <YOUR_API_KEY>: Your Birdeye API key
   • your-auth-token-here: Your authentication token
4. Restart Claude Desktop to apply the configuration

After restarting, you will see all the Birdeye tools available under Claude Tools, enabling you to query real-time crypto data directly within your conversations.

Claude Usage Limitations

If you're using the free version of Claude, you may hit message limits easily due to the data-intensive nature of crypto queries. We recommend subscribing to Claude Pro for:

• Higher message limits
• Increased usage allowances
• Better performance with data-heavy operations

OpenAI API Platform

The Birdeye MCP Server also integrates seamlessly with ChatGPT through OpenAI's platform, giving you access to real-time crypto data within your ChatGPT workflows.

Prerequisites

• Active OpenAI API account with available credits
• Birdeye API key

Setup Instructions

1. Access OpenAI Platform: Login to your OpenAI API Platform
2. Check Your Dashboard: Ensure you have sufficient API credits available. Note that API usage requires paid credits.
3. Create Custom GPT or Assistant:
   • Navigate to your OpenAI Dashboard
   • Create a new Custom GPT or Assistant
   • Add the Birdeye MCP tools to your configuration
4. Configure MCP Integration:

   {
     "mcp_servers": {
       "birdeye": {
         "endpoint": "https://dev-mcp.birdeye.so/mcp",
         "headers": {
           "x-api-key": "<YOUR_API_KEY>"
         }
       }
     }
   }

5. Test the Integration: Create a prompt that utilizes Birdeye's crypto data tools to verify the setup is working correctly.

{
  "mcp_servers": {
    "birdeye": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://dev-mcp.birdeye.so/mcp"],
      "headers": {
        "x-api-key": "<YOUR_API_KEY>"
      }
    }
  }
}

{
  "mcp.servers": {
    "birdeye": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://dev-mcp.birdeye.so/mcp"],
      "env": {
        "BIRDEYE_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}