Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
12 changes: 10 additions & 2 deletions _data/shared_chrome.json

Large diffs are not rendered by default.

2 changes: 1 addition & 1 deletion _docs/latest/CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
version: v0.61
version: v0.62
has_magic_breadcrumbs: true
show_category_breadcrumb: false
show_title_breadcrumb: true
Expand Down
6 changes: 4 additions & 2 deletions _docs/latest/README.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
version: v0.61
version: v0.62
has_magic_breadcrumbs: true
show_category_breadcrumb: false
show_title_breadcrumb: true
Expand Down Expand Up @@ -61,7 +61,8 @@ Metabase's reference documentation.
- [Development instances](./installation-and-operation/development-instance)
- [Serialization](./installation-and-operation/serialization)
- [Remote sync](./installation-and-operation/remote-sync)
- [Commands](./installation-and-operation/commands)
- [Metabase CLI](./installation-and-operation/metabase-cli)
- [Metabase JAR commands](./installation-and-operation/commands)
- [Supported browsers](./installation-and-operation/supported-browsers)
- [Privacy](./installation-and-operation/privacy)
- [About the anonymous usage data we collect](./installation-and-operation/information-collection)
Expand Down Expand Up @@ -106,6 +107,7 @@ Metabase's reference documentation.
- [Visualizing data](./questions/visualizations/visualizing-results)
- [Box plots](./questions/visualizations/box-plot)
- [Combo charts](./questions/visualizations/combo-chart)
- [Custom visualizations](./questions/visualizations/custom)
- [Detail](./questions/visualizations/detail)
- [Funnel charts](./questions/visualizations/funnel)
- [Gauge charts](./questions/visualizations/gauge)
Expand Down
2 changes: 1 addition & 1 deletion _docs/latest/actions/basic.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
version: v0.61
version: v0.62
has_magic_breadcrumbs: true
show_category_breadcrumb: true
show_title_breadcrumb: true
Expand Down
2 changes: 1 addition & 1 deletion _docs/latest/actions/custom.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
version: v0.61
version: v0.62
has_magic_breadcrumbs: true
show_category_breadcrumb: true
show_title_breadcrumb: true
Expand Down
2 changes: 1 addition & 1 deletion _docs/latest/actions/introduction.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
version: v0.61
version: v0.62
has_magic_breadcrumbs: true
show_category_breadcrumb: true
show_title_breadcrumb: true
Expand Down
2 changes: 1 addition & 1 deletion _docs/latest/actions/start.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
version: v0.61
version: v0.62
has_magic_breadcrumbs: true
show_category_breadcrumb: true
show_title_breadcrumb: false
Expand Down
2 changes: 1 addition & 1 deletion _docs/latest/ai/agent-api.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
version: v0.61
version: v0.62
has_magic_breadcrumbs: true
show_category_breadcrumb: true
show_title_breadcrumb: true
Expand Down
2 changes: 1 addition & 1 deletion _docs/latest/ai/customization.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
version: v0.61
version: v0.62
has_magic_breadcrumbs: true
show_category_breadcrumb: true
show_title_breadcrumb: true
Expand Down
305 changes: 62 additions & 243 deletions _docs/latest/ai/file-based-development.md

Large diffs are not rendered by default.

29 changes: 19 additions & 10 deletions _docs/latest/ai/mcp.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
version: v0.61
version: v0.62
has_magic_breadcrumbs: true
show_category_breadcrumb: true
show_title_breadcrumb: true
Expand Down Expand Up @@ -106,16 +106,25 @@ You don't need to have an [AI provider](settings#choose-ai-provider) configured

Some clients (like Claude Desktop) will ask you to approve each tool the first time it's used. The MCP server builds on Metabase's [Agent API](./agent-api), and exposes the following tools. If you're building a custom integration and need full control, use the [Agent API](./agent-api) directly instead.

- **search**: Find tables and metrics using keyword or natural language search.
- **get_table**: Get details about a table, including its fields, related tables, and metrics.
- **get_table_field_values**: Get sample values and statistics for a field in a table.
- **get_metric**: Get details about a metric, including its queryable dimensions.
- **get_metric_field_values**: Get sample values and statistics for a field in a metric.
- **construct_query**: Construct a query against a table or metric. Returns an opaque query string that can be executed with `execute_query`.
- **execute_query**: Execute a previously constructed query and return the results with column metadata, row count, and execution time.
### Discovery and reading

- **search**: Find tables, metrics, cards, dashboards, and collections using keyword or natural language search.
- **read_resource**: Read one or more Metabase entities by `metabase://` URI. Covers database / schema / table / collection / card / dashboard / metric / transform navigation in a single tool. Up to 5 URIs per call.

### Query construction and execution

- **construct_query**: Construct a query against a table or metric. Returns an opaque query handle that can be passed to `execute_query`.
- **query**: Query a table or metric and return results.
- **create_question**: Create questions.
- **create_dashboard**: Create dashboards.
- **execute_query**: Execute a previously constructed query and return the results with column metadata, row count, and execution time.
- **execute_sql**: Execute a raw SQL query against a database. Requires native-query permission on the target database. An admin can disable this tool instance-wide via the `mcp-execute-sql-enabled` setting.

### Writing

- **create_question**: Save a query as a named question (card).
- **update_question**: Update a saved question. Setting `collection_id` moves the card to another collection.
- **create_dashboard**: Create a new dashboard, optionally populated with saved questions.
- **update_dashboard**: Update a dashboard's metadata (name, description, collection, archived).
- **create_collection**: Create a new collection, optionally nested under a parent collection.

## Use the MCP server with file-based development

Expand Down
2 changes: 1 addition & 1 deletion _docs/latest/ai/metabot-slack.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
version: v0.61
version: v0.62
has_magic_breadcrumbs: true
show_category_breadcrumb: true
show_title_breadcrumb: true
Expand Down
2 changes: 1 addition & 1 deletion _docs/latest/ai/metabot.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
version: v0.61
version: v0.62
has_magic_breadcrumbs: true
show_category_breadcrumb: true
show_title_breadcrumb: true
Expand Down
4 changes: 2 additions & 2 deletions _docs/latest/ai/overview.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
version: v0.61
version: v0.62
has_magic_breadcrumbs: true
show_category_breadcrumb: true
show_title_breadcrumb: true
Expand Down Expand Up @@ -58,7 +58,7 @@ See [full docs for MCP server](mcp).

**Best for: developers creating stuff that other people will use.**

Use a coding agent like Claude Code to understand your database's metadata, generate Metabase content as YAML files locally, verify the schema, then sync and import the generated content into your production Metabase. Sky's the limit on what you can accomplish.
Use a coding agent like Claude Code with the Metabase CLI to create Metabase content directly in a development instance, then version that content as YAML files and pull the changes into your production Metabase.

**Controls**: Only admins can sync content to Metabase instances.

Expand Down
2 changes: 1 addition & 1 deletion _docs/latest/ai/privacy.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
version: v0.61
version: v0.62
has_magic_breadcrumbs: true
show_category_breadcrumb: true
show_title_breadcrumb: true
Expand Down
2 changes: 1 addition & 1 deletion _docs/latest/ai/settings.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
version: v0.61
version: v0.62
has_magic_breadcrumbs: true
show_category_breadcrumb: true
show_title_breadcrumb: true
Expand Down
2 changes: 1 addition & 1 deletion _docs/latest/ai/start.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
version: v0.61
version: v0.62
has_magic_breadcrumbs: true
show_category_breadcrumb: true
show_title_breadcrumb: false
Expand Down
2 changes: 1 addition & 1 deletion _docs/latest/ai/system-prompts.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
version: v0.61
version: v0.62
has_magic_breadcrumbs: true
show_category_breadcrumb: true
show_title_breadcrumb: true
Expand Down
2 changes: 1 addition & 1 deletion _docs/latest/ai/usage-auditing.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
version: v0.61
version: v0.62
has_magic_breadcrumbs: true
show_category_breadcrumb: true
show_title_breadcrumb: true
Expand Down
2 changes: 1 addition & 1 deletion _docs/latest/ai/usage-controls.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
version: v0.61
version: v0.62
has_magic_breadcrumbs: true
show_category_breadcrumb: true
show_title_breadcrumb: true
Expand Down
2 changes: 1 addition & 1 deletion _docs/latest/api.html
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
version: v0.61
version: v0.62
has_magic_breadcrumbs: true
show_category_breadcrumb: false
show_title_breadcrumb: true
Expand Down
Loading