| 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 Desktop / Web App
OpenCode
Codex
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.