get_dive_guide

Public Preview

Dives are currently in public preview and functionality is subject to change.

Load instructions for creating MotherDuck Dives. Call this before creating or saving dives.

Description

The get_dive_guide tool returns comprehensive instructions on how to write MotherDuck Dives—interactive React data apps that query live MotherDuck data. It provides guidance on the useSQLQuery hook, data type conversions, available libraries, and design system. The guide content is tailored to the AI client you are using.

Call this tool before using save_dive or update_dive to ensure the generated code follows the correct format.

note

Dives require a Business plan or Free Trial. If your plan doesn't support Dives, the tool returns an upgrade message.

Input Parameters

Parameter	Type	Required	Description
client	string	Yes	The AI client being used: "claude", "chatgpt", "claude_code", or "other"

Client options

Client	Use case
claude	Claude (Anthropic) via Claude.ai or API
chatgpt	ChatGPT (OpenAI)
claude_code	Claude Code (terminal-based agent)
other	Any other AI client or custom integration

Output Schema

{
  "success": boolean,
  "guide": string,              // Dive guide content (on success) or upgrade message
  "client": string,             // The client that was used (on success)
  "reason": string,             // "upgrade_required" (when plan doesn't support Dives)
  "plan": string,               // Current plan name (when upgrade required)
  "error": string               // Error message (on failure)
}

On success, guide contains the client-specific instructions for building Dives. If the user's plan doesn't support Dives, guide contains an upgrade message and reason is set to "upgrade_required".

Example Usage

Build a new Dive from Claude:

Create a Dive showing monthly revenue trends for my sales database

The AI assistant will first call get_dive_guide to load the instructions:

{
  "client": "claude"
}

Build a Dive from ChatGPT:

Create a Dive with a bar chart of customer signups by region

{
  "client": "chatgpt"
}

Build a Dive from Claude Code:

Create a Dive showing daily active users over the past 90 days

{
  "client": "claude_code"
}