dune-analytics-mcp

kukapay/dune-analytics-mcp

🕒 Updated:Sep 9, 2025, 01:06 PM

Python

AI Tools

A mcp server that bridges Dune Analytics data to AI agents.

MCP Trust Score

Based on our comprehensive evaluation criteria

🤖 Evaluated by gemini-2.5-flashFix

Trust Score44/100

• Basic MCP protocol features implemented (12/40)
• Room for improvement in GitHub community
• Optimal dependency management (20/20)
• Room for improvement in deployment maturity
• Documentation (8/8)
• Archestra MCP Trust score badge is missing

GitHub Metrics

Repository statistics and activity

⭐ GitHub Stars:22

👥 Contributors:2

📋 Total Issues:0

📦 Has Releases:No

🔧 Has CI/CD Pipeline:No

Configuration

Configuration example extracted from README.md for Claude Desktop and other clients.

🤖 Evaluated by gemini-2.5-flashFix

{
  "kukapay-dune-analytics-mcp": {
    "command": "mcp",
    "args": [
      "dev",
      "main.py"
    ],
    "env": {
      "DUNE_API_KEY": "your_api_key_here"
    }
  },
  "kukapay-dune-analytics-mcp-claude-install": {
    "command": "mcp",
    "args": [
      "install",
      "main.py",
      "--name",
      "Dune Analytics"
    ],
    "env": {
      "DUNE_API_KEY": "your_api_key_here"
    }
  }
}

MCP Protocol Support

Implemented MCP protocol features

🤖 Evaluated by gemini-2.5-flashFix

Tools:✓

Prompts:✗

Resources:✗

Sampling:✗

Roots:✗

Logging:✗

STDIO Transport:✓

HTTP Transport:✗

OAuth2 Auth:✗

Dependencies

2 dependencies

Libraries and frameworks used by this MCP server

🤖 Evaluated by gemini-2.5-flashFix

Main

mcp

pandas

README.md

Dune Analytics MCP Server

A mcp server that bridges Dune Analytics data to AI agents.

Features

Tools:
- get_latest_result: Fetch the latest results of a Dune query by ID.
- run_query: Execute a Dune query by ID and retrieve results.
CSV Output: All results are returned as CSV-formatted strings for easy processing.

Prerequisites

Python 3.10+
A valid Dune Analytics API key (get one from Dune Analytics)

Installation

Installing via Smithery

To install Dune Analytics for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @kukapay/dune-analytics-mcp --client claude

Manual Installation

Clone the Repository:

git clone https://github.com/kukapay/dune-analytics-mcp.git
cd dune-analytics-mcp

Set Up Environment Variables:
Create a .env file in the project root:
```
DUNE_API_KEY=your_api_key_here
```
Alternatively, set it as a system environment variable:
```
export DUNE_API_KEY="your_api_key_here"
```

Usage

Running the Server

Development Mode:
```
mcp dev main.py
```
This starts the server with hot reloading for development.
Install for Claude Desktop:
```
mcp install main.py --name "Dune Analytics"
```
Installs the server as a service for use with Claude Desktop.

Tool Usage

get_latest_result(query_id)
- Description: Retrieves the latest results of a specified Dune query.
- Input: query_id (int) - The ID of the Dune query.
- Output: CSV-formatted string of the query results.
- Example:
```
get_latest_result(query_id=4853921)
```
run_query(query_id)
- Description: Executes a Dune query and returns the results.
- Input: query_id (int) - The ID of the Dune query to run.
- Output: CSV-formatted string of the query results.
- Example:
```
run_query(query_id=1215383)
```

Example Commands in Claude Desktop

"Get latest results for dune query 1215383"
"Run dune query 1215383"

License

This project is licensed under the MIT License - see the LICENSE file for details.

Resources

GitHub Repository

Add Quality Badge

Show your MCP trust score in your README

[![Trust Score](https://archestra.ai/mcp-catalog/api/badge/quality/kukapay/dune-analytics-mcp)](https://archestra.ai/mcp-catalog/kukapay__dune-analytics-mcp)

Edit This Server Add New MCP Server Report an Issue

README.md

Dune Analytics MCP Server

A mcp server that bridges Dune Analytics data to AI agents.

Features

Tools:
- get_latest_result: Fetch the latest results of a Dune query by ID.
- run_query: Execute a Dune query by ID and retrieve results.
CSV Output: All results are returned as CSV-formatted strings for easy processing.

Prerequisites

Python 3.10+
A valid Dune Analytics API key (get one from Dune Analytics)

Installation

Installing via Smithery

To install Dune Analytics for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @kukapay/dune-analytics-mcp --client claude

Manual Installation

Clone the Repository:

git clone https://github.com/kukapay/dune-analytics-mcp.git
cd dune-analytics-mcp

Set Up Environment Variables:
Create a .env file in the project root:
```
DUNE_API_KEY=your_api_key_here
```
Alternatively, set it as a system environment variable:
```
export DUNE_API_KEY="your_api_key_here"
```

Usage

Running the Server

Development Mode:
```
mcp dev main.py
```
This starts the server with hot reloading for development.
Install for Claude Desktop:
```
mcp install main.py --name "Dune Analytics"
```
Installs the server as a service for use with Claude Desktop.

Tool Usage

get_latest_result(query_id)
- Description: Retrieves the latest results of a specified Dune query.
- Input: query_id (int) - The ID of the Dune query.
- Output: CSV-formatted string of the query results.
- Example:
```
get_latest_result(query_id=4853921)
```
run_query(query_id)
- Description: Executes a Dune query and returns the results.
- Input: query_id (int) - The ID of the Dune query to run.
- Output: CSV-formatted string of the query results.
- Example:
```
run_query(query_id=1215383)
```

Example Commands in Claude Desktop

"Get latest results for dune query 1215383"
"Run dune query 1215383"

License

This project is licensed under the MIT License - see the LICENSE file for details.