home / mcp / dune mcp server

Dune MCP Server

A high-performance MCP server providing blockchain wallet analysis and token data via the Dune API for AI assistants and MCP clients.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "crazyrabbitltc-mcp-web3-stats": {
      "command": "mcp-web3-stats",
      "args": [],
      "env": {
        "DUNE_API_KEY": "your_actual_dune_api_key_here"
      }
    }
  }
}

You can run and connect to a Model Context Protocol (MCP) server that leverages the Dune API to analyze blockchain data. This server exposes a set of EVM and Solana (SVM) tools, plus prompts, enabling your AI assistant to fetch balances, token info, holdings, and activity in real time.

How to use

You enable your MCP client to talk to the Dune API MCP Server and then invoke the available tools through prompts or UI actions. The server provides a catalog of EVM tools for Ethereum-like chains, SVM tools for Solana, and prompts to quickly access wallet overviews, token analyses, and address checks. Use these tools to fetch balances, analyze token information, inspect recent transactions, and review token holders or NFT holdings. All results are returned through the MCP interface, so you can incorporate them into your AI workflows.

Practical usage patterns include checking a wallet’s balances across ERC20s and NFTs, analyzing a token’s price and holders, and summoning recent transaction history for a given address. You can also verify Solana wallet balances and SPL token holdings. These actions help your AI agents reason about on-chain state when answering questions or planning actions.

How to install

Prerequisites: Install Bun (latest version recommended). Obtain a Dune API key from your Dune account.

Step by step setup from the provided commands:

# Install globally
npm install -g mcp-web3-stats

# Set your Dune API key as an environment variable (replace with your key)
export DUNE_API_KEY=your_actual_dune_api_key_here

# Run the server
mcp-web3-stats

Additional sections

Environment variables and language support: The server relies on a DUNE_API_KEY to access the Dune API. The implementation uses Bun/TypeScript tooling and can be run via Bun or a Node-based runtime.

Runtime and testing notes: After starting the server, you can verify the MCP interface by starting an MCP Inspector in a separate terminal to test the available tools and prompts.

Available tools

get_evm_balances

Fetches EVM token balances for a wallet, including ERC20 tokens and NFTs.

get_evm_activity

Fetches EVM account activity such as transfers and interactions.

get_evm_collectibles

Fetches EVM NFT collectibles owned by a wallet.

get_evm_transactions

Retrieves granular EVM transaction details for an address.

get_evm_token_info

Fetches metadata and price information for a specific ERC20 token.

get_evm_token_holders

Determines the distribution of a token’s holders across addresses.

get_svm_balances

Fetches Solana (SVM) token balances for a wallet.

get_svm_transactions

Fetches Solana (SVM) transactions for a wallet.

dune://evm/supported-chains

Provides a list of EVM chains supported by the Dune API.

/evm_wallet_overview

Prompts to get a quick overview of an EVM wallet.

/analyze_erc20_token

Prompts to analyze a specific ERC20 token by chainId and tokenAddress.

/svm_address_check

Prompts to check basic information for an SVM address.