dune-analytics-mcp

What is Dune Analytics MCP Server?

Dune Analytics MCP Server is a Python-based server that acts as a bridge between Dune Analytics data and AI agents. It allows AI agents to access and utilize data from Dune Analytics queries.

How to use Dune Analytics MCP Server?

Installation

Via Smithery (for Claude Desktop):

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

Manual Installation:

1. Clone the Repository:

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

2. Set Up Environment Variables: Create a .env file with DUNE_API_KEY=your_api_key_here or set it as a system environment variable.

Running the Server

• Development Mode: mcp dev main.py
• Install for Claude Desktop: mcp install main.py --name "Dune Analytics"

Tool Usage

• get_latest_result(query_id): Retrieves the latest results of a Dune query by ID. Example: get_latest_result(query_id=4853921)
• run_query(query_id): Executes a Dune query by ID and returns the results. Example: run_query(query_id=1215383)

Key Features of Dune Analytics MCP Server

• Tools for Dune Analytics: Provides get_latest_result and run_query to interact with Dune Analytics.
• CSV Output: All query results are returned as CSV-formatted strings for easy processing by AI agents.
• Integration with AI Agents: Specifically designed to bridge Dune Analytics data to AI agents.

Use Cases of Dune Analytics MCP Server

• Automated Data Analysis: AI agents can automatically fetch and analyze blockchain data from Dune Analytics.
• Real-time Insights: AI agents can retrieve the latest Dune query results for up-to-date information.
• Customizable Data Access: AI agents can execute specific Dune queries based on their needs.

FAQ about Dune Analytics MCP Server

• What are the prerequisites? Python 3.10+ and a valid Dune Analytics API key.
• How are the results formatted? All results are returned as CSV-formatted strings.
• Can I use this with Claude Desktop? Yes, it has an easy installation process for Claude Desktop via Smithery.

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

1. Clone the Repository:

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

2. 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

1. 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)
     

2. 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.