> ## Documentation Index
> Fetch the complete documentation index at: https://docs.runlayer.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Metabase

> MCP server for Metabase integration

<Warning>
  **No longer maintained.** This Runlayer-built connector is deprecated and
  will not receive further updates. Use Metabase's official hosted MCP server instead. See the [Metabase MCP docs](https://www.metabase.com/docs/latest/ai/mcp).
</Warning>

Connect your AI assistant to [Metabase](https://www.metabase.com) for dashboards, queries, and analytics. Uses **API Key** authentication.

## Available Tools

| Tool                         | Description                                                                                                     |
| ---------------------------- | --------------------------------------------------------------------------------------------------------------- |
| `list_all`                   | List all available Metabase content in one call: dashboards, cards/questions, databases, collections, and users |
| `search_content`             | Search across all content types                                                                                 |
| `list_cards`                 | List all questions/cards                                                                                        |
| `get_card`                   | Get a specific card by ID                                                                                       |
| `create_card`                | Create a new question with full MBQL/native query and visualization settings payloads                           |
| `update_card`                | Modify an existing card with full MBQL/native query and visualization settings payloads                         |
| `delete_card`                | Delete a card (archives by default, or permanently deletes if hard\_delete is true)                             |
| `execute_card`               | Run a question and get results                                                                                  |
| `list_collections`           | List all collections                                                                                            |
| `get_collection`             | Get collection details                                                                                          |
| `create_collection`          | Create a new collection                                                                                         |
| `update_collection`          | Modify a collection                                                                                             |
| `delete_collection`          | Remove a collection                                                                                             |
| `list_dashboards`            | List all dashboards                                                                                             |
| `get_dashboard`              | Get dashboard with cards                                                                                        |
| `create_dashboard`           | Create a new dashboard                                                                                          |
| `update_dashboard`           | Modify dashboard settings                                                                                       |
| `delete_dashboard`           | Delete a dashboard (archives by default, or permanently deletes if hard\_delete is true)                        |
| `get_dashboard_cards`        | List cards in a dashboard                                                                                       |
| `add_card_to_dashboard`      | Add a card to a dashboard with positioning                                                                      |
| `remove_card_from_dashboard` | Remove a card from a dashboard                                                                                  |
| `list_databases`             | List connected databases                                                                                        |
| `get_database`               | Get database details                                                                                            |
| `get_database_schema`        | List schemas in a database                                                                                      |
| `get_database_tables`        | Get all tables with metadata                                                                                    |
| `get_table`                  | Get table details with columns                                                                                  |
| `create_database_connection` | Add a new database connection                                                                                   |
| `sync_database_schema`       | Refresh database metadata                                                                                       |
| `execute_query`              | Run raw SQL queries                                                                                             |
| `list_users`                 | List all users                                                                                                  |
| `get_user`                   | Get user details                                                                                                |
| `create_user`                | Add a new user                                                                                                  |
| `update_user`                | Modify user information                                                                                         |
| `delete_user`                | Remove a user                                                                                                   |
| `list_permission_groups`     | List permission groups                                                                                          |
| `create_permission_group`    | Create a permission group                                                                                       |
| `update_permission_group`    | Modify a group                                                                                                  |
| `delete_permission_group`    | Remove a group                                                                                                  |

## Setup

<Steps>
  <Step title="Get API Key">
    1. Log in to Metabase as an admin
    2. Go to **Settings** > **Admin settings** > **Authentication**
    3. Under **API Keys**, click **Create API Key**
    4. Copy the key (shown only once)
  </Step>

  <Step title="Add Server in Runlayer">
    1. In Runlayer, go to **My connectors**, find **Metabase**, and click **Add connector**
    2. Enter:
       * **METABASE\_URL**: Your Metabase URL (e.g., `https://metabase.company.com`)
       * **METABASE\_API\_KEY**: Your API key
    3. Click **Deploy Server**
  </Step>
</Steps>

## Troubleshooting

<Accordion title="Connection refused">
  Verify your Metabase URL is correct and accessible. Check firewall rules for self-hosted instances.
</Accordion>

<Accordion title="Authentication failed">
  Verify your API key is correct and hasn't expired. Try generating a new key.
</Accordion>

<Accordion title="Permission denied">
  Ensure the API key is associated with a user that has the necessary permissions.
</Accordion>