---
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"
}
```