Optimized for running with the Bun JavaScript runtime, offering improved performance for the MCP server.
Supports environment variable configuration for storing API keys and other sensitive information needed to access Dune Analytics.
Provides access to DEX metrics and token pair liquidity data across Ethereum and other blockchains, enabling AI agents to analyze trading pairs and liquidity information.
Supports running the MCP server on Node.js runtime, providing a platform-independent way to deploy the server.
Offers the ability to retrieve token balances for specific wallet addresses on the Solana blockchain, giving AI agents access to on-chain financial data.
Dune Analytics MCP Server
A Model Context Protocol (MCP) server that bridges Dune Analytics data to AI agents, providing access to DEX metrics, EigenLayer operators and AVS stats, and token balances on Solana. The tools utilize the preset endpoints and echo endpoints provided by Dune.
Features
Tools:
get_dex_pair_metrics
: Get essential metadata and statistical data for a given token pair on a specific chainget_token_pairs_liquidity
: Find the token pair with the highest USD liquidity on a given chainget_svm_token_balances
: Get token balances for a specific wallet address on Solanaget_eigenlayer_avs_metrics
: Get statistics for a specific AVSget_eigenlayer_operator_metrics
: Get statistics for all operators in a specific AVS
Data Formats: All results are returned in structured JSON format for easy processing
Prerequisites
Node.js 16+ or Bun 1.0+
A valid Dune Analytics API key (get one from Dune Analytics)
Installation
Clone the Repository:
git clone https://github.com/ekailabs/dune-mcp-server.git cd dune-mcp-serverInstall Dependencies: Using Bun:
bun installOr using npm:
npm installSet Up Environment Variables: Create a
.env
file in the project root based on.env.example
:DUNE_API_KEY=your_api_key_hereAlternatively, set it as a system environment variable:
export DUNE_API_KEY="your_api_key_here"
Usage
Running the Server
Using Bun:
Using npm:
Add to Claude for Desktop
To use with Claude for Desktop, add the server config:
On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
On Windows: %APPDATA%/Claude/claude_desktop_config.json
Tool Usage
get_dex_pair_metrics(chain, token_pair)
Description: Retrieves essential metadata and statistical data for a given token pair
Input:
chain
(string) - The blockchain to get the DEX stats fortoken_pair
(string) - The token pair to get the DEX stats for
Output: JSON object containing DEX metrics
get_token_pairs_liquidity(chain)
Description: Identifies the token pair with the highest USD liquidity on a given chain
Input:
chain
(string) - The blockchain to get the DEX stats forOutput: JSON object containing top token pair metrics
get_svm_token_balances(wallet_address)
Description: Gets the balances of a specific wallet address on the Solana blockchain
Input:
wallet_address
(string) - The address of the wallet to get the balance forOutput: JSON array of token balances
get_eigenlayer_avs_metrics(avs_name)
Description: Gets the statistics for a specific AVS
Input:
avs_name
(string) - The name of the AVS to get the stats forOutput: JSON object containing AVS metrics
get_eigenlayer_operator_metrics(avs_name)
Description: Gets the statistics for all operators in a specific AVS
Input:
avs_name
(string) - The name of the AVS to get operator stats forOutput: JSON object containing operator metrics
Example Commands in Claude for Desktop
"Can you please give me the liquidity of 'USDC-WETH' token pair on ethereum?"
"Show me the highest liquidity token pair on arbitrum"
"Can you please plot the stake distribution of EigenDA operators?"
"How many stakers are there on EigenDA AVS"
License
This project is licensed under the MIT License - see the LICENSE file for details.
Running evals
The evals package loads an mcp client that then runs the index.ts file, so there is no need to rebuild between tests. You can load environment variables by prefixing the npx command. Full documentation can be found here.
Acknowledgments
Dune Analytics for their API
Model Context Protocol for the protocol specification
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
A Model Context Protocol server that connects AI agents to Dune Analytics data, providing access to DEX metrics, EigenLayer statistics, and Solana token balances through structured tools.
Related MCP Servers
- -securityAlicense-qualityA Model Context Protocol server enabling AI agents to interact with the Solana blockchain for DeFi operations like checking balances, transferring tokens, executing swaps, and fetching price data.Last updated -3622MIT License
- -securityAlicense-qualityA mcp server that bridges Dune Analytics data to AI agents.Last updated -28MIT License
- -securityAlicense-qualityA Model Context Protocol server that enables AI models to interact with the Solana blockchain, providing RPC methods, wallet management, DeFi trading capabilities, and Helius API integration for enhanced Solana development.Last updated -4MIT License
- -securityAlicense-qualityA Model Context Protocol server that extends AI capabilities by providing tools to interact with the Solana blockchain, enabling operations like transactions, account queries, and wallet management.Last updated -2Apache 2.0