Dune MCP Skill

Use this skill to run Dune MCP operations through uxc.

Reuse the uxc skill for shared protocol discovery, output parsing, and generic auth/binding flows.

Prerequisites

• - uxc is installed and available in PATH.
• Network access to https://api.dune.com/mcp/v1.
• Dune API key is available for authenticated calls.

Core Workflow

1. 1. Confirm endpoint and protocol with help-first probing:

1. 2. Configure credential/binding for repeatable auth:

1. 3. Use fixed link command by default:

1. 4. Inspect operation schema before execution:

1. 5. Prefer read/discovery operations first, then query creation or credit-consuming execution.

Capability Map

• - Discovery:

• - Query lifecycle:

• - Analysis helpers:

Recommended Usage Pattern

1. 1. Find the right table first:

1. 2. Prefer higher-level spell tables when they already expose the metrics you need.
2. Keep SQL partition-aware:

1. 4. Create a temporary query only after confirming table choice and date range.
2. Execute and fetch results by execution ID.

Guardrails

• - Keep automation on JSON output envelope; do not rely on --text.
• Parse stable fields first: ok, kind, protocol, data, error.
• Use dune-mcp-cli as default command path.
• INLINECODE42 is equivalent to uxc https://api.dune.com/mcp/v1 <operation> ....
• Discovery operations are read-only:

• - Require explicit user confirmation before credit-consuming or state-changing operations:

• - Be careful with privacy:

• - key=value input now supports automatic type conversion for numeric MCP arguments.
• Numeric IDs can be passed directly with key=value, for example:

• - Positional JSON is still useful for nested objects or when mixing string and numeric fields precisely:

• - For SQL passed via key=value, wrap the whole SQL string in double quotes so inner SQL single quotes survive shell parsing.
• If listBlockchains returns a Dune-side schema/facet error, fall back to searchTables with blockchains filters.

Tested Real Scenario

The following flow was exercised successfully through uxc:

• - discover table: INLINECODE68
• create temporary query for Base daily volume
• execute query
• fetch results

The successful SQL shape was:

CODEBLOCK0

References

• - Invocation patterns: