Dune MCP

Documentation Index

Fetch the complete documentation index at: https://docs.dune.com/llms.txt

Use this file to discover all available pages before exploring further.

​

Setup and Usage

​

Authentication

1. OAuth 2.0 (recommended for Browser agents or agents with access to the browser)
2. Dune API key (recommended for environments with no access to a browser)

​

OAuth

• Name: Dune
• url: https://api.dune.com/mcp/v1

​

Api Key

• Header auth: x-dune-api-key: <dune-api-key>
• Query auth (for clients that prefer URL auth): ?api_key=<dune_api_key>

​

Setup exampls

​

Claude Code

​

Oauth

claude mcp add --scope user --transport http dune https://api.dune.com/mcp/v1

​

API Key

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

​

Claude Desktop

​

OpenCode

​

Oauth

​

API Key

​

Codex

​

Oauth

codex mcp add dune --url "https://api.dune.com/mcp/v1"

# Login after adding the MCP
codex mcp login dune

​

API Key

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

[mcp_servers.dune]
url = "https://api.dune.com/mcp/v1"
tool_timeout_sec = 300

​

Cursor

{
  "mcpServers": {
    "dune": {
      "url": "https://api.dune.com/mcp/v1",
    }
  }
}

{
  "mcpServers": {
    "dune": {
      "url": "https://api.dune.com/mcp/v1",
      "headers": {
        "X-DUNE-API-KEY": "<api_key>"
      }
    }
  }
}

​

Tools and Resources Inventory

​

Tools

​

Resources

​

Server Details

• Server name: dune
• Remote MCP URL: https://api.dune.com/mcp/v1
• Tagline: Query, analyze, and visualize onchain data from Dune directly inside your MCP-compatible AI client.
• Primary use cases:
  • Discover datasets and docs relevant to a protocol, contract, or chain
  • Create, update, execute, and troubleshoot Dune SQL queries
  • Turn query results into charts/tables/counters without leaving your chat
  • Create and manage full dashboards from natural language prompts
  • Track account credit usage while iterating on analysis

​

Prompt Examples

1. “Find the best Dune table for tracking Uniswap v3 swap volume on Ethereum, then create and run a daily volume query for the last 90 days.”
2. “I have contract 0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48. Find decoded tables, build a weekly transfer count query, execute it, and show the top 20 recipient wallets.”
3. “Review query 1234567, optimize it for lower scan cost, update it in place, run it, and summarize result quality and execution credits used.”
4. “Generate a visualization from my latest execution results: a line chart of daily active addresses and a counter for total unique users.”
5. “Create a dashboard showing Ethereum activity in the past 30 days — include daily transactions, active addresses, and gas usage.”
6. “Update my existing dashboard to add a new chart showing weekly DEX volume by protocol.”

​

Connection Details

​

Transport

• Protocol: Remote MCP over Streamable HTTP
• Endpoint: https://api.dune.com/mcp/v1
• Interaction pattern:
  • POST /mcp/v1 for MCP requests
  • GET /mcp/v1 for stream resumption/event replay

​

OAuth 2.0 details

• Authorization server issuer: https://dune.com/oauth/mcp
• Discovery metadata: https://dune.com/.well-known/oauth-authorization-server/oauth/mcp
• Authorization endpoint: https://dune.com/oauth/mcp/authorize
• Token endpoint: https://dune.com/oauth/mcp/token
• Dynamic client registration endpoint: https://dune.com/oauth/mcp/register
• JWKS endpoint: https://dune.com/oauth/mcp/jwks.json
• Grant types: authorization_code, refresh_token
• Client auth at token endpoint: none (public clients)
• PKCE: required (S256)
• Scope: mcp:dune:full
• Resource parameter for authorization requests: https://api.dune.com

​

Troubleshooting

• OAuth invalid_request on authorize: Verify required params (client_id, redirect_uri, state, code_challenge, code_challenge_method=S256, resource=https://api.dune.com).
• OAuth unsupported_grant_type on token: Use only authorization_code or refresh_token.
• OAuth invalid_grant on token exchange: Ensure your code_verifier matches the original PKCE challenge and redirect_uri exactly matches the authorize request.
• Unauthorized from MCP endpoint: Confirm valid auth (OAuth bearer token or Dune API key).
• Codex Transport closed during long polls: Increase MCP tool timeout (for example tool_timeout_sec = 300) and restart the session if the transport already closed.

​

Related Resources

​

Privacy and Support

• Privacy policy: https://dune.com/privacy
• Support: support@dune.com