Dune MCP

Connect Dune’s MCP server to your favorite AI coding clients.

MCP (Model Context Protocol) is an open-source standard for connecting AI applications to external systems.

Dune MCP gives your agent direct, structured access to Dune workflows: discover the right tables, create and run queries, inspect results, and create visualizations in the same conversation.

This is the fastest way to move from prompt to reliable onchain analysis.

Dune MCP currently ships with these official tools:

Category	Tool	Description
Discovery	searchDocs	Search Dune docs for guides, examples, and API references
Discovery	searchTables	Find tables by protocol, chain, category, or schema
Discovery	listBlockchains	List indexed blockchains with table counts
Discovery	searchTablesByContractAddress	Find decoded event/call tables for a contract address
Query Lifecycle	createDuneQuery	Create and save a new Dune query
Query Lifecycle	getDuneQuery	Fetch SQL and metadata for an existing query
Query Lifecycle	updateDuneQuery	Update SQL, title, description, tags, or parameters
Query Lifecycle	executeQueryById	Execute a saved query and return an execution ID
Query Lifecycle	getExecutionResults	Fetch status and results for a query execution
Visualization	generateVisualization	Create charts, counters, and tables from query results
Account	getUsage	Check current billing-period credit usage

Connect Dune MCP

All clients authenticate to Dune MCP with your Dune API key.

• MCP endpoint: https://api.dune.com/mcp/v1
• Header auth: x-dune-api-key: <dune-api-key>
• Query auth (for clients that prefer URL auth): ?api_key=<dune_api_key>

OAuth with your Dune account is coming soon. For now, authenticate with a Dune API key.

Claude Code

claude mcp add --scope user --transport http dune https://api.dune.com/mcp/v1 --header "x-dune-api-key: <dune-api-key>"

Claude Desktop / Web App

OpenCode

Codex

codex mcp add dune_prod --url "https://api.dune.com/mcp/v1?api_key=<dune_api_key>"

Cursor

ChatGPT

ChatGPT support is planned via OAuth and will be documented here once available.

---

Key Benefits

Natural Language to SQL

Describe the question in plain English and let your agent discover tables, draft SQL, and return results.

Cross-Chain Coverage

Work across Dune’s indexed chains through one MCP interface, with discovery and query tools in the same flow.

End-to-End Workflow

Go from question to execution to visualization in one conversation without switching apps.

Use Cases

Protocol Analytics

Track core metrics like volume, users, or activity using curated and decoded datasets.

Wallet Intelligence

Analyze wallet behavior, holdings, and flows across multiple chains from a single prompt.

Market Research

Compare sectors, tokens, and venues with reusable query and visualization workflows.

Data Workflow Prototyping

Iterate quickly on query ideas, validate results, and turn them into saved assets.