> This page is for Agent Handler.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.merge.dev/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.merge.dev/_mcp/server.

# Metabase

**Authentication:** API key. See [Magic Link](/merge-agent-handler/features/magic-link) for the runtime auth flow.

## Sample use cases

* Run the `Weekly Active Users` saved question and post the result to the team channel.
* Search dashboards and questions for anything referencing a deprecated table.
* Run an ad-hoc query against the warehouse and summarize the result.

## Available Tools

#### list\_cards

List cards (saved questions) with client-side pagination (the Metabase API returns the full list; this tool slices it...

#### get\_card

Get a card (saved question) by ID

#### create\_card

Create a new card (saved question)

#### update\_card

Update a card's name, description, query, display, collection, or archived status

#### delete\_card

Permanently and irreversibly delete a card by ID (hard delete — cannot be undone)

#### run\_card\_query

Run a card's saved query and return its result rows and columns, truncated to `limit` rows (default 500) to avoid overflowing context

#### list\_collections

List collections (folders that organize dashboards and questions) with client-side pagination (the Metabase API returns...

#### get\_collection

Get a collection by ID

#### list\_dashboards

List dashboards with server-side pagination and filters, including by collection\_id

#### get\_dashboard

Get a dashboard by ID

#### create\_dashboard

Create a new dashboard

#### update\_dashboard

Update a dashboard's name, description, collection, or archived status

#### delete\_dashboard

Permanently and irreversibly delete a dashboard by ID (hard delete — cannot be undone)

#### list\_databases

List databases connected to this Metabase instance with client-side pagination (the Metabase API returns the full list...

#### get\_database

Get a database by ID

#### list\_groups

List permission groups with client-side pagination (the Metabase API returns the full list; this tool slices it for you)

#### get\_group

Get a permission group by ID, including its member list (user id/email/name per member)

#### search

Search dashboards, cards (questions), collections, tables, and databases by name substring, with server-side filters...

#### list\_users

List Metabase users with server-side pagination and filters

#### get\_user

Get a Metabase user by ID