aiopinions/birdeye-mcp-server
If you are the rightful owner of birdeye-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
The Birdeye MCP Server is a middleware solution that bridges AI models with Birdeye blockchain data APIs, providing essential context for Solana blockchain elements like tokens, markets, and NFTs.
Birdeye MCP Server
A Model Context Protocol (MCP) server implementation for the Birdeye APIs. This server acts as a middleware between AI models and the Birdeye blockchain data APIs, providing context about tokens, markets, wallets, NFTs, and more on the Solana blockchain.
What is Model Context Protocol (MCP)?
Model Context Protocol (MCP) is a standardized way for AI models to request and receive contextual information from external data sources. This implementation focuses on providing blockchain and crypto-specific context from Birdeye's APIs.
Features
- Token information and prices
- Market data and analytics
- Wallet portfolio tracking
- NFT collections and items
- DEX pools and liquidity
- MCP-friendly endpoints for AI context generation
Prerequisites
- Node.js (v14+ recommended)
- Birdeye API key (get one from Birdeye)
Installation
Standard Installation
-
Clone this repository
git clone <repository-url> cd birdeye-mcp-server
-
Install dependencies
npm install
-
Configure environment variables
cp .env.example .env
Then edit the
.env
file and add your Birdeye API key.
Docker Installation
-
Clone this repository
git clone <repository-url> cd birdeye-mcp-server
-
Configure environment variables
cp .env.example .env
Then edit the
.env
file and add your Birdeye API key. -
Build and start with Docker Compose
docker-compose up -d
Usage
Start the server (Standard)
npm start
The server will run on port 3000 by default (configurable in .env).
Start the server (Docker)
docker-compose up -d
To view logs:
docker-compose logs -f
To stop the server:
docker-compose down
API Endpoints
Standard Birdeye Endpoints
GET /token/:network/:address
- Get token informationGET /price/:network/:address
- Get token priceGET /price/history/:network/:address
- Get token price historyGET /market/:network/:address
- Get market informationGET /tokens/top/:network
- Get top tokensGET /token/:network/:address/holders
- Get token holdersGET /token/:network/:address/transfers
- Get token transfersGET /wallet/:network/:address
- Get wallet portfolioGET /wallet/:network/:address/tokens
- Get wallet tokensGET /nft/collections/:network
- Get NFT collectionsGET /nft/collection/:network/:address
- Get NFT collection infoGET /nft/item/:network/:address
- Get NFT item infoGET /dex/pools/:network
- Get DEX poolsGET /dex/pool/:network/:address
- Get DEX pool info
MCP-Specific Endpoints
-
POST /mcp/token
- Get comprehensive token context{ "network": "solana", "address": "token_address", "context": "optional query context" }
-
POST /mcp/wallet
- Get comprehensive wallet context{ "network": "solana", "address": "wallet_address", "context": "optional query context" }
-
POST /mcp/market
- Get market overview context{ "network": "solana", "context": "optional query context" }
Integrating with AI Models
To use this MCP server with AI models:
- Set up the server and ensure it's accessible to your AI system
- Configure your AI to make appropriate requests to the MCP endpoints
- Parse the contextual information and incorporate it into your model's responses
Example integration:
// From your AI application
async function getBirdeyeContext(tokenAddress) {
const response = await fetch('http://your-mcp-server/mcp/token', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'X-API-KEY': 'your_api_key'
},
body: JSON.stringify({
network: 'solana',
address: tokenAddress,
context: 'User is asking about token price and market cap'
})
});
return await response.json();
}
License
MIT
Integration with Claude or Other MCP-Compatible Agents
To use the Birdeye MCP Server with Claude or any agent that supports the Model Context Protocol (MCP), you can provide the following configuration file (e.g., claude-mcp-server-config.json
) to your agent:
{
"servers": [
{
"name": "Birdeye MCP Server",
"description": "Model Context Protocol server for Birdeye APIs",
"command": "node",
"args": ["server.js"],
"env": {
"BIRDEYE_API_KEY": "your_birdeye_api_key_here",
"PORT": "3000"
},
"endpoints": [
{"path": "/mcp/token", "method": "POST", "description": "Get comprehensive token context"},
{"path": "/mcp/wallet", "method": "POST", "description": "Get comprehensive wallet context"},
{"path": "/mcp/market", "method": "POST", "description": "Get market overview context"}
]
}
]
}
Usage Instructions
- Ensure you have set your Birdeye API key in the configuration file above.
- Start the MCP server:
npm install npm start
- Point your Claude agent (or other MCP-compatible agent) to use the above configuration file.
- The agent will be able to call the
/mcp/token
,/mcp/wallet
, and/mcp/market
endpoints for context-aware queries.
For more details, refer to the claude-mcp-server-config.json
file and the API endpoint documentation above.