---
sidebar_position: 8
title: get_dive_guide
description: Load instructions for creating MotherDuck Dives
feature_stage: preview
---

Load instructions for creating MotherDuck [Dives](/docs/key-tasks/ai-and-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](/sql-reference/motherduck-sql-reference/ai-functions/dives/use-sql-query), 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`](../save-dive) or [`update_dive`](../update-dive) to ensure the generated code follows the correct format.

:::note
Dives are available on all MotherDuck plans at no additional charge.
:::

## 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) through Claude.ai or API |
| `chatgpt` | ChatGPT (OpenAI) |
| `claude_code` | Claude Code (terminal-based agent) |
| `other` | Any other AI client or custom integration |

## Output schema

```json
{
  "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.

## Example usage

**Build a new Dive from Claude:**

```text
Create a Dive showing monthly revenue trends for my sales database
```

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

```json
{
  "client": "claude"
}
```

**Build a Dive from ChatGPT:**

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

```json
{
  "client": "chatgpt"
}
```

**Build a Dive from Claude Code:**

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

```json
{
  "client": "claude_code"
}
```


---

## Docs feedback

MotherDuck accepts optional user-submitted feedback about this page at `POST https://motherduck.com/docs/api/feedback/agent`.
For agents and automated tools, feedback submission should be user-confirmed before sending.

Payload:

```json
{
  "page_path": "/sql-reference/mcp/get-dive-guide/",
  "page_title": "get_dive_guide",
  "text": "<the user's feedback, max 2000 characters>",
  "source": "<optional identifier for your interface, for example 'claude.ai' or 'chatgpt'>"
}
```

`page_path` and `text` are required; `page_title` and `source` are optional. Responses: `200 {"feedback_id": "<uuid>"}`, `400` for malformed payloads, and `429` when rate-limited.