metabase_describe_ databaseSee what is in a database before writing SQL.
Ask what a dashboard says today, run a saved question with a different filter, explore a table and write the SQL, then save the result as a question on a new dashboard.
PopMCPMetabase
Every Metabase API endpoint an API key can call, on Metabase Cloud or your own server, with query results reduced to columns and rows, failed queries reported as errors, and secrets kept out of view.
662 tools in the full catalog: 368 read and 294 write. 42 load by default, and the rest are found with tool search.
metabase_describe_ databaseSee what is in a database before writing SQL.
metabase_get_ databaseGet a single Database with `id`.
metabase_list_ databasesFetch all `Databases`.
metabase_add_ questions_ to_ dashboardAdd saved questions to a dashboard, placed below what is there.
metabase_copy_ dashboardCopy a Dashboard.
metabase_create_ dashboardCreate a new Dashboard.
metabase_get_ dashboardGet Dashboard with ID.
metabase_get_ dashboard_ resultsRead the data on a dashboard: runs its cards (8 by default) with its filters and returns each card's name, columns and first rows.
metabase_update_ dashboardUpdate a Dashboard, and optionally the `dashcards` and `tabs` of a Dashboard.
metabase_copy_ questionCopy a `Card`, with the new name 'Copy of _name_'
metabase_create_ questionCreate a new `Card`.
metabase_create_ sql_ questionSave SQL as a question in Metabase, with the query envelope and required fields filled in.
metabase_export_ question_ resultsRun the query associated with a Card, and return its results as a file in the specified format.
metabase_get_ questionGet `Card` with ID.
metabase_list_ questionsGet all the Cards.
metabase_run_ questionRun a saved question or model by id or URL and get columns and rows.
metabase_update_ questionUpdate a `Card`.
metabase_list_ groupsFetch all `PermissionsGroups`, including a count of the number of `:members` in that group.
metabase_create_ collectionCreate a new Collection.
metabase_get_ collectionFetch a specific Collection with standard details added
metabase_list_ collection_ itemsFetch a specific Collection's items with the following options: * `models` - only include objects of a specific set of `models`.
metabase_list_ collectionsFetch a list of all Collections that the current user has read permissions for (`:can_write` is returned as an additional property of each Collection so you can tell which of these you have write permissions for.) By default, this returns non-archived Collections, but instead you can show archived ones by passing `?archived=true`.
metabase_list_ root_ collection_ itemsFetch objects that the current user should see at their root level.
metabase_update_ collectionModify an existing Collection, including archiving or unarchiving it, or moving it.
metabase_get_ table_ query_ metadataGet metadata about a `Table` useful for running queries.
metabase_list_ tablesGet all `Tables`.
metabase_get_ field_ valuesIf a Field's value of `has_field_values` is `:list`, return a list of all the distinct values of the Field (or remapped Field), and (if defined by a User) a map of human-readable remapped values.
metabase_list_ metricsGet a list of metrics.
metabase_create_ notificationCreate a new notification, return the created notification.
metabase_list_ notificationsList notifications.
metabase_create_ timeline_ eventCreate a new TimelineEvent.
metabase_list_ timelinesFetch a list of `Timeline`s.
metabase_get_ current_ userFetch the current `User`.
metabase_list_ dashboard_ subscriptionsFetch all dashboard subscriptions.
metabase_list_ usersFetch a list of `Users` for admins or group managers.
metabase_run_ queryExecute a query and retrieve the results in the usual format.
metabase_run_ sqlRun SQL on a database and get columns and rows.
metabase_list_ segmentsFetch *all* `Segments`.
metabase_searchSearch for items in Metabase.
metabase_list_ popular_ itemsGet the list of 5 popular things on the instance.
metabase_list_ recent_ itemsGet a list of recent items the current user has been viewing most recently under the `:recents` key.
metabase_overviewStart here.
metabase_acknowledge_ security_ advisoriesAcknowledge multiple security advisories.
metabase_cancel_ transformCancel the current run for a given transform.
metabase_add_ databaseAdd a new `Database`.
metabase_execute_ public_ actionExecute the Action.
metabase_create_ dashboard_ public_ linkGenerate publicly-accessible links for this Dashboard.
metabase_delete_ metabot_ prompt_ suggestionDelete the prompt suggestion with ID `prompt-id` for the metabot instance with `id`.
metabase_add_ group_ memberAdd a `User` to a `PermissionsGroup`.
metabase_agent_ construct_ native_ queryConstruct a native (raw SQL) query against a database.
metabase_disable_ advanced_ ai_ mcp_ permissionsSwitch back to All Users only.
metabase_create_ question_ public_ linkGenerate publicly-accessible links for this Card.
metabase_export_ embed_ card_ resultsLike `GET /api/embed/card/query`, but returns the results as a file in the specified format.
metabase_append_ csv_ to_ tableInserts the rows of an uploaded CSV file into the table identified by `:id`.
metabase_append_ exploration_ summaryAppend a static `cardEmbed` representing a *composite chart* — built from one or more `ExplorationQuery` snapshots combined into a single qp-result — to the exploration's Summary document.
metabase_cancel_ remote_ sync_ current_ taskCancels the current task if one is running Pro or Enterprise feature.
metabase_add_ app_ groupGrant a batch of internal groups read access to a data app's resource collection atomically.
metabase_delete_ collectionDeletes a collection permanently
metabase_delete_ field_ dimensionRemove the dimension associated to field at ID
metabase_add_ metric_ dimensionAdd dimensions to a metric.
metabase_get_ xrayReturn an automagic dashboard for entity `entity` with id `id`.
metabase_disable_ database_ persistenceAttempt to disable model persistence for a database.
metabase_get_ preview_ embed_ cardFetch a Card you're considering embedding by passing a JWT `token`.
metabase_create_ actionCreate a new action.
metabase_copy_ documentCopy a Document.
metabase_admin_ bulk_ update_ notificationsBulk-archive or -change-creator a set of notifications.
metabase_create_ timelineCreate a new Timeline.
metabase_create_ dev_ custom_ viz_ pluginRegister a dev-only custom visualization plugin from a local dev server.
metabase_data_ studio_ discard_ valuesBatch version of /table/:id/discard_values.
metabase_create_ dashboard_ subscriptionCreate a new `Pulse`.
metabase_convert_ query_ to_ nativeFetch a native version of an MBQL query.
metabase_copy_ embed_ themeCopy an embedding theme.
metabase_create_ llm_ providerCreate a provider connection.
metabase_create_ measureCreate a new `Measure`.
metabase_get_ taskGet `TaskHistory` entry with ID.
metabase_create_ userCreate a new `User`, return a 400 if the email address is already taken
metabase_add_ comment_ reactionToggle a reaction on a comment
metabase_get_ dependency_ backfill_ statusWhether no entity awaits the computation of its dependencies, as `complete`, for superusers.
metabase_create_ row_ sandboxCreate a new GTAP.
metabase_cancel_ replacement_ runCancel a running source replacement.
metabase_create_ channelCreate a channel
metabase_debug_ searchSuperuser-only.
metabase_create_ segmentCreate a new `Segment`.
metabase_acknowledge_ security_ advisoryAcknowledge a security advisory.
metabase_cancel_ transform_ dag_ runCancel an in-progress manual DAG run and request cancellation of its still-running transforms.
metabase_add_ sample_ databaseAdd the sample database as a new `Database`.
metabase_execute_ public_ dashboard_ card_ actionExecute the associated Action in the context of a `Dashboard` and `DashboardCard` that includes it.
metabase_delete_ dashboardHard delete a Dashboard.
metabase_delete_ metabot_ prompt_ suggestionsDelete all prompt suggestions for the metabot instance with `id`.
metabase_clear_ group_ membersRemove all members from a `PermissionsGroup`.
metabase_agent_ construct_ queryConstruct an MBQL query from a portable MBQL 5 representations JSON payload.
metabase_disable_ advanced_ ai_ permissionsSwitch back to simple permissions.
metabase_delete_ questionHard delete a Card.
metabase_export_ embed_ dashboard_ card_ resultsFetch the results of running a Card belonging to a Dashboard using a JSON Web Token signed with the `embedding-secret-key` return the data in one of the export formats
metabase_bulk_ update_ tablesUpdate all `Table` in `ids`.
metabase_cancel_ exploration_ threadCancel an in-flight exploration thread.
metabase_create_ remote_ sync_ branchCreate a new branch from the current remote-sync branch and switches the current remote-sync branch to it.
metabase_create_ appCreate a data app with its resource collection and an empty bundle.
metabase_get_ collection_ items_ metadataMetadata about the collection's items list: the models with at least one visible item plus the item count.
metabase_discard_ field_ valuesDiscard the FieldValues belonging to this Field.
metabase_get_ metricFetch a `Metric` with ID.
metabase_get_ xray_ cellReturn an automagic dashboard analyzing cell in automagic dashboard for entity `entity` defined by query `cell-query`.
metabase_disable_ model_ persistenceDisable global setting to allow databases to persist models.
metabase_get_ preview_ embed_ card_ param_ remappingEmbedded version of api.card filter values endpoint.
metabase_create_ action_ public_ linkGenerate publicly-accessible links for this Action.
metabase_create_ documentCreate a new `Document`.
metabase_admin_ get_ notificationGet a single card-type notification with last_check, last_send, check_history (up to 10 most-recent terminal alert-type TaskRuns) and send_history (up to 10 most-recent channel-send delivery attempts).
metabase_delete_ timelineDelete a Timeline.
metabase_delete_ custom_ viz_ pluginRemove a custom visualization plugin and evict its on-disk cache.
metabase_data_ studio_ rescan_ valuesBatch version of /table/:id/rescan_values.
metabase_get_ dashboard_ subscriptionFetch `Pulse` with ID.
metabase_export_ query_ resultsExecute a query and download the result data as a file in the specified format.
metabase_create_ embed_ themeCreate a new embedding theme.
metabase_delete_ llm_ providerDelete a provider connection.
metabase_get_ measureFetch `Measure` with ID.
metabase_get_ task_ infoReturn raw data about all scheduled tasks (i.e., Quartz Jobs and Triggers).
metabase_deactivate_ userDisable a `User`.
metabase_create_ commentCreate a new comment
metabase_get_ dependency_ graphThis endpoint takes an :id and a supported entity :type, and returns a graph of all its upstream dependencies.
metabase_delete_ row_ sandboxDelete a GTAP entry.
metabase_check_ source_ replacementCheck whether a source entity can be replaced by a target entity.
metabase_get_ channelGet a channel
metabase_force_ search_ reindexThis will trigger an immediate reindexing, if we are using search index.
metabase_delete_ segmentArchive a Segment.
metabase_adjust_ log_ levelsTemporarily adjust the log levels.
metabase_cancel_ transform_ job_ runCancel an in-progress job run and request cancellation of its still-running transforms.
metabase_delete_ databaseDelete a `Database`.
metabase_export_ public_ card_ resultsFetch a publicly-accessible Card and return query results in the specified format.
metabase_delete_ dashboard_ public_ linkDelete the publicly-accessible link to this Dashboard.
metabase_fork_ metabot_ conversationFork a conversation at an assistant message, returning a brand-new conversation that copies the thread from the start up to and including that message.
metabase_create_ groupCreate a new `PermissionsGroup`.
metabase_agent_ create_ collectionCreate a new Collection.
metabase_enable_ advanced_ ai_ mcp_ permissionsSwitch to group-level MCP tool access.
metabase_delete_ question_ public_ linkDelete the publicly-accessible link to this Card.
metabase_get_ embed_ cardFetch a Card via a JSON Web Token signed with the `embedding-secret-key`.
metabase_discard_ table_ valuesDiscard the FieldValues belonging to the Fields in this Table.
metabase_create_ explorationCreate a new exploration with a single thread, persist the user's selected metrics, dimensions, and timelines, and stamp the thread as started.
metabase_export_ remote_ syncExport the current state of the Remote Sync collection to a Source.
metabase_delete_ appDelete a data app, its bundle, and its collection with the grants on it.
metabase_get_ collection_ permissions_ graphFetch a graph of all Collection Permissions.
metabase_get_ fieldGet `Field` with ID.
metabase_get_ metric_ breakout_ valuesFetch distinct breakout dimension values for a metric or measure definition.
metabase_get_ xray_ cell_ compareReturn an automagic comparison dashboard for cell in automagic dashboard for entity `entity` with id `id` defined by query `cell-query`; compared with entity `comparison-entity` with id `comparison-entity-id-or-query.`.
metabase_enable_ database_ persistenceAttempt to enable model persistence for a database.
metabase_get_ preview_ embed_ card_ param_ valuesEmbedded version of api.card filter values endpoint.
metabase_delete_ actionDelete an Action.
metabase_create_ document_ public_ linkGenerate a publicly-accessible UUID for a Document.
metabase_admin_ list_ notificationsList card-type notifications (alerts) for admin management.
metabase_delete_ timeline_ eventDelete a TimelineEvent.
metabase_get_ custom_ viz_ plugin_ listList active and enabled custom visualization plugins.
metabase_data_ studio_ sync_ schemaBatch version of /table/:id/sync_schema.
metabase_get_ dashboard_ subscription_ optionsProvides relevant configuration information and user choices for creating/updating Pulses.
metabase_get_ query_ metadataGet all of the required query metadata for an ad-hoc query.
metabase_delete_ embed_ themeDelete an embedding theme.
metabase_get_ llm_ modelsList the models available from every configured connection, grouped by connection.
metabase_get_ measure_ dimension_ remappingFetch remapped value for a specific dimension value.
metabase_get_ task_ runGet a single task run with all its child tasks.
metabase_dismiss_ user_ modalIndicate that an user has been informed about the vast intricacies of 'the' Query Builder.
metabase_delete_ commentSoft delete a comment
metabase_get_ dependency_ graph_ breakingReturns a list of entities that are breaking other entities (sources of errors).
metabase_get_ row_ sandboxFetch GTAP by `id` Pro or Enterprise feature.
metabase_get_ replacement_ runGet the status of a source replacement run.
metabase_list_ channelsGet all channels
metabase_get_ search_ weightsReturn the current weights being used to rank the search results
metabase_get_ segmentFetch `Segment` with ID.
metabase_admin_ remove_ user_ mfaAdmin: remove *another* user's two-factor enrollment entirely — the lockout escape hatch for a lost authenticator with no recovery codes.
metabase_create_ transformCreate a new transform.
metabase_discard_ database_ valuesDiscards all saved field values for this `Database`.
metabase_export_ public_ dashboard_ card_ resultsFetch the results of running a publicly-accessible Card belonging to a Dashboard and return the data in one of the export formats.
metabase_execute_ dashboard_ card_ actionExecute the associated Action in the context of a `Dashboard` and `DashboardCard` that includes it.
metabase_get_ metabotRetrieve one metabot instance
metabase_delete_ advanced_ permission_ impersonationDelete a Connection Impersonation entry.
metabase_agent_ create_ dashboardCreate a new dashboard, optionally populated with saved questions.
metabase_enable_ advanced_ ai_ permissionsSwitch to group-level permissions.
metabase_get_ question_ param_ remappingFetch the remapped value for a given value of the parameter with ID `:param-key`.
metabase_get_ embed_ card_ param_ remappingEmbedded version of api.card filter values endpoint.
metabase_get_ question_ table_ query_ metadataReturn metadata for the 'virtual' table for a Card.
metabase_delete_ explorationHard-delete an exploration.
metabase_get_ remote_ sync_ branchesGet list of branches from the configured source.
metabase_delete_ app_ groupRevoke a group's access to a data app's resource collection.
metabase_get_ collection_ treeSimilar to `GET /`, but returns Collections in a tree structure, e.g. ``` [{:name "A" :below #{:card :dataset} :children [{:name "B"} {:name "C" :here #{:dataset :card} :below #{:dataset :card} :children [{:name "D" :here #{:dataset} :children [{:name "E"}]} {:name "F" :here #{:card} :children [{:name "G"}]}]}]} {:name "H"}] ``` The here and below keys indicate the types of items at this particular level of the tree (here) and in its subtree (below).
metabase_get_ field_ remappingFetch remapped Field values.
metabase_get_ metric_ dimension_ remappingFetch remapped value for a specific dimension value.
metabase_get_ xray_ cell_ with_ templateReturn an automagic dashboard analyzing cell in question with id `id` defined by query `cell-query` using dashboard-template `dashboard-template`.
metabase_enable_ model_ persistenceEnable global setting to allow databases to persist models.
metabase_get_ preview_ embed_ card_ resultsFetch the query results for a Card you're considering embedding by passing a JWT `token`.
metabase_delete_ action_ public_ linkDelete the publicly-accessible link to this Dashboard.
metabase_delete_ documentPermanently deletes an archived Document.
metabase_get_ notificationGet a notification by id.
metabase_get_ timelineFetch the `Timeline` with `id`.
metabase_get_ custom_ viz_ plugin_ sandbox_ hostServe a minimal HTML document used as the iframe `src` for the near-membrane custom-viz sandbox.
metabase_data_ studio_ table_ selectionGets information about selected tables
metabase_test_ dashboard_ subscriptionTest send an unsaved pulse.
metabase_get_ query_ parameter_ remappingReturn the remapped parameter values for cards or dashboards that are being edited.
metabase_get_ embed_ themeFetch a single embedding theme by ID.
metabase_get_ llm_ provider_ typesList the provider types a connection can be created for, with the credential fields each one needs.
metabase_get_ measure_ dimension_ valuesFetch values for a dimension of a measure.
metabase_get_ task_ run_ entitiesGet distinct entities that have task runs for a given run type.
metabase_get_ userFetch a `User`.
metabase_get_ comment_ mentionsGet a list of entities suitable for mentions.
metabase_get_ dependency_ graph_ brokenReturns the broken dependents for a specific source entity.
metabase_list_ row_ sandboxesFetch a list of all GTAPs currently in use, or a single GTAP if both `group_id` and `table_id` are provided.
metabase_list_ replacement_ runsList replacement runs, optionally filtered by is-active.
metabase_test_ channelTest a channel connection
metabase_reinitialize_ search_ indexThis will blow away any search indexes, re-create, and re-populate them.
metabase_get_ segment_ relatedReturn related entities.
metabase_cancel_ cloud_ addonRemove an add-on.
metabase_create_ transform_ jobCreate a new transform job.
metabase_dismiss_ database_ sync_ spinnerManually set the initial sync status of the `Database` and corresponding tables to be `complete` (see #20863)
metabase_export_ public_ document_ card_ resultsFetch a Card embedded in a public Document and return query results in the specified format.
metabase_export_ dashboard_ card_ resultsRun the query associated with a Saved Question (`Card`) in the context of a `Dashboard` that includes it, and return its results as a file in the specified format.
metabase_get_ metabot_ analytic_ conversationReturn full details for a specific conversation including all messages.
metabase_delete_ groupDelete a specific `PermissionsGroup`.
metabase_agent_ create_ metricSave a previously constructed query as a named metric.
metabase_get_ ai_ control_ mcp_ permissionsList the MCP tool policy of every group, with the tools it can name and the current permission mode.
metabase_get_ question_ param_ valuesFetch possible values of the parameter whose ID is `:param-key`.
metabase_get_ embed_ card_ param_ searchEmbedded version of chain filter search endpoint.
metabase_get_ tableGet `Table` with ID.
metabase_explore_ furtherStart a follow-up investigation scoped to a clicked chart segment.
metabase_get_ remote_ sync_ current_ taskGet the current sync task Pro or Enterprise feature.
metabase_get_ appFetch metadata for a single data app by its slug, disabled ones to superusers only.
metabase_get_ root_ collectionReturn the 'Root' Collection object with standard details added
metabase_get_ field_ summaryGet the count and distinct count of `Field` with ID.
metabase_get_ metric_ dimension_ valuesFetch values for a dimension of a metric.
metabase_get_ xray_ cell_ with_ template_ compareReturn an automagic comparison dashboard for cell in automagic dashboard for entity `entity` with id `id` defined by query `cell-query` using dashboard-template `dashboard-template`; compared with entity `comparison-entity` with id `comparison-entity-id-or-query.`.
metabase_get_ persisted_ modelFetch a particular PersistedInfo by id.
metabase_get_ preview_ embed_ dashboardFetch a Dashboard you're considering embedding by passing a JWT `token`.
metabase_execute_ actionExecute the Action.
metabase_delete_ document_ public_ linkRemove the public link for a Document.
metabase_send_ notificationSend a notification by id.
metabase_get_ timeline_ eventFetch the TimelineEvent with `id`.
metabase_list_ custom_ viz_ pluginsList all registered custom visualization plugins.
metabase_edit_ data_ studio_ tableBulk updating tables.
metabase_undo_ dashboard_ subscription_ unsubscribeAllow non-users to undo an unsubscribe from pulses/subscriptions, with the hash given through email.
metabase_get_ query_ parameter_ valuesReturn parameter values for cards or dashboards that are being edited.
metabase_list_ embed_ themesFetch a list of all embedding themes.
metabase_list_ llm_ providersList the configured provider connections, with their secrets masked.
metabase_list_ measuresFetch *all* `Measures`.
metabase_get_ task_ unique_ tasksReturns possibly empty vector of unique task names in alphabetical order.
metabase_list_ user_ recipientsFetch a list of `Users`.
metabase_list_ commentsGet comments for an entity
metabase_get_ dependency_ graph_ dependentsReturns a list of dependents for the specified entity.
metabase_update_ row_ sandboxUpdate a GTAP entry.
metabase_replace_ model_ with_ transformCreate a transform from a model, execute it, and replace all usages of the model with the output table.
metabase_update_ channelUpdate a channel
metabase_update_ search_ weightsUpdate the current weights being used to rank the search results
metabase_update_ segmentUpdate a `Segment` with ID.
metabase_cancel_ cloud_ migrationCancel any ongoing cloud migrations, if any.
metabase_create_ transform_ tagCreate a new transform tag.
metabase_get_ database_ autocomplete_ suggestionsReturn a list of autocomplete suggestions for a given `prefix`, or `substring`.
metabase_get_ public_ actionFetch a publicly-accessible Action.
metabase_get_ dashboard_ card_ action_ valuesFetches the values for filling in execution parameters.
metabase_get_ metabot_ conversationReturn a single conversation with its flattened chat messages.
metabase_get_ advanced_ permission_ application_ graphFetch a graph of Application Permissions.
metabase_agent_ create_ questionSave a previously constructed query as a named question (card).
metabase_get_ ai_ control_ permissionsList all metabot permissions for all groups, filling in defaults for missing entries.
metabase_get_ question_ query_ metadataGet all of the required query metadata for a card.
metabase_get_ embed_ card_ param_ valuesEmbedded version of api.card filter values endpoint.
metabase_get_ table_ dataGet the data for the given table
metabase_get_ explorationFetch an exploration with its thread, selections, and generated queries.
metabase_get_ remote_ sync_ dirtyReturn all models with changes that have not been pushed to the remote sync source in any remote-synced collection.
metabase_get_ app_ group_ permission_ warningsReturn missing table access for the groups listed for this app.
metabase_get_ root_ collection_ items_ metadataMetadata about the Root Collection's items list: the models with at least one visible item plus the item count.
metabase_get_ table_ ids_ for_ fieldsGet unique Table IDs for a list of Field IDs.
metabase_list_ metric_ dimensionsList a metric's curated dimensions, and (when `with-addable=true`) the columns still available to add, grouped by source table.
metabase_get_ xray_ compareReturn an automagic comparison dashboard for entity `entity` with id `id` compared with entity `comparison-entity` with id `comparison-entity-id-or-query.`
metabase_get_ persisted_ model_ for_ questionFetch a particular PersistedInfo by card-id.
metabase_get_ preview_ embed_ dashboard_ card_ resultsFetch the results of running a Card belonging to a Dashboard you're considering embedding with JWT `token`.
metabase_get_ actionFetch an Action.
metabase_export_ document_ card_ resultsDownload query results for a Card embedded in a Document.
metabase_send_ notification_ previewSend an unsaved notification.
metabase_list_ collection_ timelinesFetch a specific Collection's timelines.
metabase_refresh_ custom_ viz_ pluginRe-fetch the manifest from the dev server for a dev-only plugin.
metabase_get_ data_ studio_ table_ publishing_ infoReturn the latest valid publishing information for a published table, or no content when unavailable.
metabase_unsubscribe_ dashboard_ subscription_ by_ linkAllow non-users to unsubscribe from pulses/subscriptions, with the hash given through email.
metabase_run_ pivot_ queryGenerate a pivoted dataset for an ad-hoc query
metabase_seed_ default_ embed_ themesSeed default embedding themes on first call, using the payloads built by the frontend from the `METABASE_LIGHT_THEME` / `METABASE_DARK_THEME` constants.
metabase_llm_ extract_ sourcesParse native query sources and return referenced tables and cards/models.
metabase_search_ measure_ dimension_ valuesSearch for values of a dimension that contain the query string.
metabase_list_ task_ runsList task runs with optional filters.
metabase_reactivate_ userReactivate user at `:id`
metabase_update_ commentUpdate a comment
metabase_get_ dependency_ graph_ unreferencedReturns a list of all unreferenced items in the instance.
metabase_validate_ row_ sandboxValidate a sandbox which may not have yet been saved.
metabase_replace_ sourceReplace all usages of a source entity with a target entity asynchronously.
metabase_count_ api_ keysGet the count of API keys in the DB with the default scope.
metabase_create_ transform_ testCreate a transform test.
metabase_get_ database_ card_ autocomplete_ suggestionsReturn a list of `Card` autocomplete suggestions for a given `query` in a given `Database`.
metabase_get_ public_ cardFetch a publicly-accessible Card an return query results as well as `:card` information.
metabase_get_ dashboard_ param_ remappingFetch the remapped value for a given value of the parameter with ID `:param-key`.
metabase_get_ metabot_ conversation_ titleReturn the title generation status for a conversation.
metabase_get_ database_ permissions_ graphFetch a graph of all Permissions for db-id `db-id`.
metabase_agent_ execute_ queryExecute an MBQL query and return results.
metabase_get_ ai_ control_ usage_ groupGet the metabot usage limit for a specific group.
metabase_list_ dashboards_ for_ questionsGet the dashboards that multiple cards appear in.
metabase_get_ embed_ card_ resultsFetch the results of running a Card using a JSON Web Token signed with the `embedding-secret-key`.
metabase_list_ question_ table_ foreign_ keysReturn FK info for the 'virtual' table for a Card.
metabase_get_ exploration_ dimensionsHydrated metrics plus a deduplicated dimension list, for the Exploration data modal.
metabase_get_ remote_ sync_ export_ preflightDry-run preview of what pushing the current state would do given the live remote branch, without writing anything.
metabase_get_ app_ repo_ statusStatus of the connected repository as it relates to data apps.
metabase_get_ trash_ collectionFetch the trash collection, as in `/api/collection/:trash-id`
metabase_list_ field_ relatedReturn related entities.
metabase_remove_ metric_ dimensionRemove dimensions (by UUID) from a metric.
metabase_get_ xray_ for_ model_ recordReturn an automagic dashboard for the record of the model indexed by `model-index-id` whose primary key is `pk-id`.
metabase_list_ persisted_ modelsList the entries of PersistedInfo in order to show a status page.
metabase_get_ preview_ embed_ dashboard_ param_ remappingEmbedded version of the remapped dashboard param value endpoint.
metabase_get_ action_ valuesFetches the values for filling in execution parameters.
metabase_get_ documentReturns an existing Document by ID.
metabase_undo_ notification_ unsubscribeAllow non-users to undo an unsubscribe from notifications, with the hash given through email.
metabase_list_ root_ collection_ timelinesFetch the root Collection's timelines.
metabase_update_ custom_ viz_ pluginUpdate a custom visualization plugin.
metabase_publish_ data_ studio_ tablesSet collection for each of selected tables and all upstream dependencies recursively.
metabase_unsubscribe_ from_ dashboard_ subscriptionFor users to unsubscribe themselves from a pulse subscription.
metabase_search_ query_ parameter_ valuesReturn parameter values for cards or dashboards that are being edited.
metabase_update_ embed_ themeUpdate an embedding theme.
metabase_update_ llm_ providerUpdate a provider connection.
metabase_update_ measureUpdate a `Measure` with ID.
metabase_list_ tasksFetch a list of recent tasks stored as Task History
metabase_update_ userUpdate an existing, active `User`.
metabase_create_ bookmarkCreate a new bookmark for user.
metabase_delete_ transformDelete a transform.
metabase_get_ database_ healthcheckReports whether the database can currently connect
metabase_get_ public_ card_ param_ remappingFetch the remapped value for the given `value` of parameter with ID `:param-key` of card with UUID `uuid`.
metabase_get_ dashboard_ param_ valuesFetch possible values of the parameter whose ID is `:param-key`.
metabase_get_ metabot_ permission_ user_ permissionsReturn the current user's resolved metabot permissions, taking the most permissive value across all their groups.
metabase_get_ groupFetch the details for a certain permissions group.
metabase_agent_ execute_ sqlExecute a raw SQL query against a database.
metabase_get_ ai_ control_ usage_ instanceGet the instance-wide metabot usage limit.
metabase_list_ embeddable_ questionsFetch a list of Cards where `enable_embedding` is `true`.
metabase_get_ embed_ dashboardFetch a Dashboard via a JSON Web Token signed with the `embedding-secret-key`.
metabase_list_ table_ foreign_ keysGet all foreign keys whose destination is a `Field` that belongs to this `Table`.
metabase_get_ exploration_ queryStream the result of a single completed exploration query.
metabase_get_ remote_ sync_ has_ remote_ changesCheck if there are new changes on the remote branch that can be pulled.
metabase_get_ app_ sandbox_ hostServe the document used as the `src` of the Near-Membrane realm iframe, carrying a per-document CSP that confines `'unsafe-eval'` to that realm.
metabase_list_ collection_ dashboard_ question_ candidatesFind cards in this collection that can be moved into dashboards in this collection.
metabase_rescan_ field_ valuesManually trigger an update for the FieldValues for this Field.
metabase_reorder_ metric_ dimensionPersist a new ordering for a metric's dimensions.
metabase_get_ xray_ query_ metadataReturn all metadata for an automagic dashboard for entity `entity` with id `id`.
metabase_persist_ modelMark the model (card) as persisted.
metabase_get_ preview_ embed_ dashboard_ param_ searchEmbedded version of chain filter search endpoint.
metabase_list_ actionsReturns the actions the current user can read, unarchived unless `?archived=true`.
metabase_list_ documentsGets existing `Documents`.
metabase_unsubscribe_ from_ notificationUnsubscribe current user from a notification.
metabase_update_ timelineUpdate the Timeline with `id`.
metabase_update_ custom_ viz_ plugin_ dev_ urlSet or clear the dev base URL for a plugin (e.g. `http://localhost:5174`).
metabase_unpublish_ data_ studio_ tablesUnset collection for each of selected tables and all downstream dependents recursively.
metabase_update_ dashboard_ subscriptionUpdate a Pulse with `id`.
metabase_create_ database_ replication_ connectionCreate a new PG replication connection for the specified database.
metabase_delete_ transform_ jobDelete a transform job.
metabase_get_ database_ metadataGet metadata about a `Database`, including all of its `Tables` and `Fields`.
metabase_get_ public_ card_ param_ searchFetch values for a parameter on a public card containing `query`.
metabase_get_ dashboard_ query_ metadataGet all of the required query metadata for the cards on dashboard.
metabase_get_ metabot_ usageFetch current Metabot token usage for the current billing period.
metabase_get_ group_ permissions_ graphFetch a graph of all Permissions for group-id `group-id`.
metabase_agent_ pingHealth check endpoint for the Agent API.
metabase_get_ ai_ control_ usage_ tenantGet the metabot usage limit for a specific tenant.
metabase_list_ public_ questionsFetch a list of Cards with public UUIDs.
metabase_get_ embed_ dashboard_ card_ resultsFetch the results of running a Card belonging to a Dashboard using a JSON Web Token signed with the `embedding-secret-key`
metabase_list_ table_ relatedReturn related entities.
metabase_list_ my_ explorationsExplorations the current user created or edited, most-recently-touched first, paginated.
metabase_get_ remote_ sync_ is_ dirtyCheck if any remote-synced collection or collection item has local changes that have not been pushed to the remote sync source.
metabase_get_ app_ typed_ schemaReturn the TypeScript module of the data app's queries and actions: a `defineQuery` call for each question and metric and a `defineAction` call for each action in the app's collection, addressed by entity ID.
metabase_list_ root_ dashboard_ question_ candidatesFind cards in the root collection that can be moved into dashboards in the root collection.
metabase_search_ field_ valuesSearch for values of a Field with `search-id` that start with `value`.
metabase_run_ metric_ queryExecute a metric or measure-based query and stream the results.
metabase_get_ xray_ with_ templateReturn an automagic dashboard for entity `entity` with id `id` using dashboard-template `dashboard-template`.
metabase_refresh_ persisted_ modelRefresh the persisted model caching `card-id`.
metabase_get_ preview_ embed_ dashboard_ param_ valuesEmbedded version of chain filter values endpoint.
metabase_list_ public_ actionsFetch a list of Actions with public UUIDs.
metabase_list_ public_ documentsList all Documents that have public links.
metabase_unsubscribe_ notification_ by_ linkAllow non-users to unsubscribe from notifications, with the hash given through email.
metabase_update_ timeline_ eventUpdate a TimelineEvent.
metabase_create_ glossaryCreate a new glossary entry.
metabase_delete_ transform_ tableDelete a transform's output table.
metabase_get_ database_ settings_ availableGet all database-local settings and their availability for the given database.
metabase_get_ public_ card_ param_ valuesFetch values for a parameter on a public card.
metabase_get_ dashboard_ valid_ filter_ fieldsUtility endpoint for powering Dashboard UI.
metabase_list_ metabot_ analytic_ conversationsReturn paginated list of AI conversations with summary statistics.
metabase_get_ invite_ group_ idsIDs of the permission groups holding a stored read (or read-write) grant on the collection of a shareable item (a `dashboard` or a `question`).
metabase_agent_ read_ resourceRead one or more Metabase resources via metabase:// URI patterns.
metabase_list_ ai_ control_ usage_ groupsGet all group-level metabot usage limits.
metabase_list_ question_ dashboardsGet a list of `{:name ...
metabase_get_ embed_ dashboard_ param_ remappingEmbedded version of the remapped dashboard param value endpoint.
metabase_replace_ table_ with_ csvReplaces the contents of the table identified by `:id` with the rows of an uploaded CSV file.
metabase_restart_ exploration_ threadRe-run one exploration thread in place, keeping its selections: drops the thread's materialized queries and clears the terminal-state gates so the background planner re-claims it.
metabase_import_ remote_ syncImport Metabase content from configured Remote Sync source.
metabase_list_ app_ groupsList the groups other than Administrators that can read a data app's resource collection.
metabase_move_ collection_ dashboard_ question_ candidatesMove candidate cards to the dashboards they appear in.
metabase_set_ field_ dimensionSets the dimension for the given field at ID
metabase_search_ metric_ dimension_ valuesSearch for values of a dimension that contain the query string.
metabase_get_ xray_ with_ template_ compareReturn an automagic comparison dashboard for entity `entity` with id `id` using dashboard-template `dashboard-template`; compared with entity `comparison-entity` with id `comparison-entity-id-or-query.`.
metabase_set_ model_ persistence_ scheduleSet the cron schedule to refresh persisted models.
metabase_get_ preview_ embed_ pivot_ card_ queryFetch the query results for a Card you're considering embedding by passing a JWT `token`.
metabase_update_ actionUpdate an Action.
metabase_update_ documentUpdates an existing `Document`.
metabase_update_ notificationUpdate a notification, can also update its subscriptions, handlers.
metabase_create_ gsheet_ connectionHook up a new google drive folder or sheet that will be watched and have its content ETL'd into Metabase.
metabase_delete_ transform_ tagDelete a transform tag.
metabase_get_ database_ syncable_ schemasReturns a list of all syncable schemas found for the database `id`.
metabase_get_ public_ card_ resultsFetch a publicly-accessible Card an return query results as well as `:card` information.
metabase_list_ dashboard_ itemsGet Dashboard with ID.
metabase_list_ metabot_ conversationsList conversations visible in the current user's history, most-recent first.
metabase_get_ permissions_ graphFetch a graph of all Permissions.
metabase_agent_ run_ queryExecute a portable MBQL 5 representations JSON query and stream the results, with continuation-token pagination.
metabase_list_ ai_ control_ usage_ tenantsGet all tenant-level metabot usage limits.
metabase_list_ question_ seriesFetches a list of compatible series with the card with id `card_id`.
metabase_get_ embed_ dashboard_ param_ searchEmbedded version of chain filter search endpoint.
metabase_rescan_ table_ valuesManually trigger an update for the FieldValues for the Fields belonging to this Table.
metabase_update_ explorationUpdate an exploration's metadata, archive state, or move it to a different collection.
metabase_stash_ remote_ syncStashes changes to a new branch, and changes the current branch to it.
metabase_list_ appsList the data apps the user can read.
metabase_move_ root_ dashboard_ question_ candidatesMove candidate cards to the dashboards they appear in (for the root collection)
metabase_update_ fieldUpdate `Field` with ID.
metabase_set_ default_ metric_ dimensionMark exactly one dimension as the metric's default, clearing any previous default.
metabase_list_ xray_ candidatesReturn a list of candidates for automagic dashboards ordered by interestingness.
metabase_unpersist_ modelUnpersist this model.
metabase_get_ preview_ embed_ pivot_ dashboard_ dashcard_ cardFetch the results of running a Card belonging to a Dashboard you're considering embedding with JWT `token`.
metabase_create_ index_ requestCreate an index request on a transform's target table.
metabase_delete_ transform_ testDelete a transform test.
metabase_get_ database_ usage_ infoGet usage info for a database.
metabase_get_ public_ dashboardFetch a publicly-accessible Dashboard.
metabase_list_ dashboard_ relatedReturn related entities.
metabase_list_ metabot_ prompt_ suggestionsReturn the prompt suggestions for the metabot instance with `id`.
metabase_list_ advanced_ permission_ impersonationsFetch a list of all Impersonation policies currently in effect, or a single policy if both `group_id` and `db_id` are provided.
metabase_agent_ run_ questionRun a saved question (card) and return its results.
metabase_update_ ai_ control_ mcp_ permissionsSet the MCP tool policy of the given groups, in one transaction, and return the policy of every group.
metabase_move_ questionsMoves a number of Cards to a single collection or dashboard.
metabase_get_ embed_ dashboard_ param_ valuesEmbedded version of chain filter values endpoint.
metabase_sync_ table_ schemaTrigger a manual update of the schema metadata for this `Table`.
metabase_update_ exploration_ page_ hiddenSet whether one or more exploration pages are hidden from the sidebar.
metabase_test_ remote_ sync_ connectionTest whether the Remote Sync credentials can reach the git repository.
metabase_update_ appUpdate a data app's manifest fields, or enable or disable it.
metabase_update_ collection_ permissions_ graphDo a batch update of Collections Permissions by passing in a modified graph.
metabase_update_ field_ valuesUpdate the fields values and human-readable values for a `Field` whose semantic type is `category`/`city`/`state`/`country` or whose base type is `type/Boolean`.
metabase_update_ metric_ dimensionUpdate a metric dimension's `display_name`, `description`, `default_temporal_unit`, and/or source column.
metabase_create_ libraryCreates the Library if it doesn't exist.
metabase_get_ transformGet a specific transform.
metabase_get_ saved_ questions_ metadataEndpoint that provides metadata for the Saved Questions 'virtual' database.
metabase_get_ public_ dashboard_ card_ action_ valuesFetches the values for filling in execution parameters.
metabase_list_ embeddable_ dashboardsFetch a list of Dashboards where `enable_embedding` is `true`.
metabase_list_ metabotsList configured metabot instances
metabase_list_ group_ membershipsFetch a map describing the group memberships of various users.
metabase_agent_ searchSearch for tables, models, metrics, saved questions, dashboards, and collections.
metabase_update_ ai_ control_ permissionsUpdate metabot permissions for all groups.
metabase_move_ questions_ to_ collectionBulk update endpoint for Card Collections.
metabase_get_ embed_ pivot_ card_ queryFetch the results of running a Card using a JSON Web Token signed with the `embedding-secret-key`.
metabase_update_ tableUpdate `Table` with ID.
metabase_update_ exploration_ page_ starredSet whether an exploration page is starred.
metabase_update_ remote_ sync_ settingsUpdate Remote Sync related settings.
metabase_create_ model_ indexCreate ModelIndex.
metabase_get_ transform_ dag_ run_ transform_ runsGet the transform runs that made up a specific DAG run.
metabase_list_ database_ fieldsGet a list of all `Fields` in `Database`.
metabase_get_ public_ dashboard_ card_ resultsFetch the results for a Card in a publicly-accessible Dashboard.
metabase_list_ public_ dashboardsFetch a list of Dashboards with public UUIDs.
metabase_regenerate_ metabot_ prompt_ suggestionsRemove any existing prompt suggestions for the Metabot with `id` and generate new ones.
metabase_remove_ group_ memberRemove a User from a PermissionsGroup (delete their membership).
metabase_agent_ update_ dashboardUpdate a dashboard.
metabase_update_ ai_ control_ usage_ groupSet or update the metabot usage limit for a specific group.
metabase_run_ question_ pivot_ queryRun the query associated with a Card.
metabase_get_ embed_ pivot_ dashboard_ dashcard_ cardFetch the results of running a Card belonging to a Dashboard using a JSON Web Token signed with the `embedding-secret-key`
metabase_update_ table_ field_ orderReorder fields
metabase_create_ moderation_ reviewCreate a new `ModerationReview`.
metabase_get_ transform_ dag_ transformsPreview the transforms a DAG reprocess from this transform would run (see `POST /:id/run-dag`), in execution order.
metabase_list_ database_ id_ fieldsGet a list of all primary key `Fields` for `Database`.
metabase_get_ public_ dashboard_ param_ remappingFetch the remapped value for the given `value` of parameter with ID `:param-key` of dashboard with UUID `uuid`.
metabase_replace_ dashboard_ cards(DEPRECATED -- Use the `PUT /api/dashboard/:id` endpoint instead.) Update `Cards` and `Tabs` on a Dashboard.
metabase_save_ metabot_ conversation_ entitySave a Metabot-generated chart from this conversation as a card, stamping the card's origin columns in the same request — used by the inline chart's manual Save button, which runs outside any agent turn.
metabase_update_ advanced_ permission_ application_ graphDo a batch update of Application Permissions by passing a modified graph.
metabase_agent_ update_ metricUpdate a saved metric.
metabase_update_ ai_ control_ usage_ instanceSet or update the instance-wide metabot usage limit.
metabase_run_ question_ queryRun the query associated with a Card.
metabase_create_ routing_ destination_ databaseCreate new Destination Databases.
metabase_get_ transform_ dependenciesGet the dependencies of a specific transform.
metabase_list_ database_ schemasReturns a list of all the schemas with tables found for the database `id`.
metabase_get_ public_ dashboard_ param_ searchFetch filter values for dashboard parameter `param-key`, containing specified `query`.
metabase_run_ dashboard_ card_ pivot_ queryRun a pivot table query for a specific DashCard.
metabase_send_ metabot_ feedbackPersist Metabot feedback.
metabase_update_ groupUpdate the name of a `PermissionsGroup`.
metabase_agent_ update_ questionUpdate a saved question (card).
metabase_update_ ai_ control_ usage_ tenantSet or update the metabot usage limit for a specific tenant.
metabase_search_ question_ param_ valuesFetch possible values of the parameter whose ID is `:param-key` that contain `:query`.
metabase_create_ snippetCreate a new `NativeQuerySnippet`.
metabase_get_ transform_ inspectPhase 2: Get full lens contents for a transform.
metabase_list_ default_ schema_ tablesReturn a list of Tables for a Database whose schema is the `schema` query parameter, or `nil` or an empty string when no `schema` is given.
metabase_get_ public_ dashboard_ param_ valuesFetch filter values for dashboard parameter `param-key`.
metabase_run_ dashboard_ card_ queryRun the query associated with a Saved Question (`Card`) in the context of a `Dashboard` that includes it.
metabase_send_ metabot_ source_ feedbackPersist Metabot source feedback.
metabase_update_ group_ membershipUpdate a Permission Group membership.
metabase_create_ tenantCreate a new Tenant Pro or Enterprise feature.
metabase_get_ transform_ jobGet a transform job by ID.
metabase_list_ saved_ questions_ schema_ datasetsReturns a list of Tables for the datasets virtual database.
metabase_get_ public_ documentFetch a publicly-accessible Document.
metabase_save_ dashboardSave a denormalized description of dashboard.
metabase_update_ metabotUpdate a metabot instance
metabase_update_ permissions_ graphDo a batch update of Permissions by passing in a modified graph.
metabase_debug_ permissionsThis endpoint expects a `user_id`, a `model_id` to debug permissions against, and `action_type`.
metabase_get_ transform_ job_ run_ transform_ runsGet the transform runs that made up a specific job run.
metabase_list_ saved_ questions_ schema_ tablesReturns a list of Tables for the saved questions virtual database.
metabase_get_ public_ document_ cardRun a query for a Card that's embedded in a public Document.
metabase_save_ dashboard_ to_ collectionSave a denormalized description of dashboard into collection with ID `:parent-collection-id`.
metabase_update_ metabot_ slack_ settingsUpdate Metabot Slack settings atomically.
metabase_delete_ api_ keyDelete an ApiKey
metabase_get_ transform_ job_ transformsGet the transforms of job specified by the job's ID.
metabase_list_ saved_ questions_ schemasReturns a list of all the schemas found for the saved questions virtual database.
metabase_get_ public_ oembedoEmbed endpoint used to retrieve embed code and metadata for a (public) Metabase URL.
metabase_search_ dashboard_ param_ valuesFetch possible values of the parameter whose ID is `:param-key` that contain `:query`.
metabase_delete_ bookmarkDelete a bookmark.
metabase_get_ transform_ runGet a transform run by ID.
metabase_list_ saved_ questions_ schemas_ datasetsReturns a list of all the datasets found for the saved questions virtual database.
metabase_get_ public_ pivot_ card_ queryFetch a publicly-accessible Card an return query results as well as `:card` information.
metabase_delete_ cache_ configDelete cache configurations.
metabase_get_ transform_ testGet a transform test with its newest run.
metabase_list_ schema_ tablesReturns a list of Tables for the given Database `id` and `schema`.
metabase_get_ public_ pivot_ dashboard_ dashcard_ cardFetch the results for a Card in a publicly-accessible Dashboard.
metabase_delete_ database_ replication_ connectionDelete PG replication connection for the specified database.
metabase_get_ transform_ test_ runList the runs of a transform test, newest first.
metabase_rescan_ database_ valuesTrigger a manual scan of the field values for this `Database`.
metabase_delete_ emailClear all email related settings.
metabase_get_ transforms_ python_ libraryGet the Python library for user modules.
metabase_sync_ database_ schemaTrigger a manual update of the schema metadata for this `Database`.
metabase_delete_ email_ overrideClear all cloud email related settings.
metabase_list_ transform_ inspectsPhase 1: Discover available lenses for a transform.
metabase_update_ databaseUpdate a `Database`.
metabase_delete_ glossaryDelete a glossary entry.
metabase_list_ transform_ job_ runsGet paginated run history for a transform job.
metabase_validate_ database_ connectionValidate that we can connect to a database given a set of details.
metabase_delete_ gsheet_ connectionDisconnect the google service account.
metabase_list_ transform_ jobsGet all transform jobs.
metabase_delete_ index_ requestMark an index request `delete-pending`.
metabase_list_ transform_ runsGet transform runs based on a set of filter params.
metabase_delete_ model_ indexDelete ModelIndex.
metabase_list_ transform_ tagsGet a list of all transform tags.
metabase_delete_ osi_ ai_ contextDelete the ai_context entry for an entity by its logical key.
metabase_list_ transform_ testsList the transform tests with their newest runs, optionally only those of one transform.
metabase_delete_ upload_ management_ tableDelete the uploaded table from the database, optionally archiving cards for which it is the primary source.
metabase_list_ transformsGet a list of transforms.
metabase_delete_ user_ key_ value_ namespace_ keyDeletes a KV-pair for the user
metabase_query_ transform_ inspectExecute a query in the context of a transform inspector lens.
metabase_delete_ user_ subscriptionsDelete all Alert and DashboardSubscription subscriptions for a User (i.e., so they will no longer receive them).
metabase_reset_ checkpoint_ transformReset the stored checkpoint for an incremental transform.
metabase_execute_ action_ v2Execute an action with a single input.
metabase_run_ dag_ transformTrigger a DAG-reprocess run starting from a single transform: runs the transform and every transform in its transitive dependency closure.
metabase_execute_ bulk_ action_ v2Execute an action with multiple inputs.
metabase_run_ transformRun a transform.
metabase_execute_ form_ action_ v2Temporary endpoint for describing an actions parameters such that they can be presented correctly in a modal ahead of execution.
metabase_run_ transform_ jobRun a transform job manually.
metabase_generate_ random_ tokenReturn a cryptographically secure random 32-byte token, encoded as a hexadecimal string.
metabase_run_ transform_ testRun a transform test.
metabase_get_ alertFetch an alert by ID
metabase_search_ transform_ runsPaginated unified run history: every row is a root run — a job run, a manual DAG-reprocess run, or a standalone transform run — never a member run of a job/DAG (those are listed by `GET /run` and the per-run `transform-runs` endpoints).
metabase_get_ anonymous_ statsAnonymous usage stats.
metabase_test_ run_ transforms_ pythonEvaluate an ad-hoc python transform on a sample of input data.
metabase_get_ billingGet billing information.
metabase_update_ transformUpdate a transform.
metabase_get_ cache_ configsReturn cache configuration.
metabase_update_ transform_ jobUpdate a transform job.
metabase_get_ cloud_ migrationGet the latest cloud migration, if any.
metabase_update_ transform_ job_ activeActivate or deactivate every transform job.
metabase_get_ connection_ pool_ detailsReturns database connection pool info for the current Metabase instance.
metabase_update_ transform_ tagUpdate a transform tag.
metabase_get_ content_ diagnostic_ duplicatedList **duplicated** findings - the latest valid finding per (entity, finding-type) across the duplicated finding types (currently just `duplicate_name`), permission-filtered for the current user.
metabase_update_ transform_ testUpdate a transform test.
metabase_get_ content_ diagnostic_ imbalancedList **imbalanced** findings - the latest valid finding per (entity, finding-type) across the `empty`/`sparse`/`crowded` checkers, permission-filtered for the current user.
metabase_update_ transforms_ python_ libraryUpdate the Python library source code for user modules.
metabase_get_ content_ diagnostic_ slowList **slow** findings - the latest valid `slow` finding per entity, permission-filtered for the current user.
metabase_get_ content_ diagnostic_ staleList **stale** findings - the latest valid `stale` finding per entity, permission-filtered for the current user.
metabase_get_ content_ translation_ csvProvides content translation dictionary in CSV Pro or Enterprise feature.
metabase_get_ content_ translation_ dictionaryFetch the content translation dictionary via a JSON Web Token signed with the `embedding-secret-key`.
metabase_get_ data_ complexity_ scoreReturn the most recently stored Data Complexity Score for this instance.
metabase_get_ diagnostic_ detailsReturns version and system information relevant to filing a bug report against Metabase.
metabase_get_ embedding_ hub_ checklistGet the setup guide checklist status, indicating which setup steps have been completed.
metabase_get_ entity_ relationship_ diagramReturn an Entity Relationship Diagram (ERD) for tables and their FK relationships.
metabase_get_ geojsonFetch a custom GeoJSON file as defined in the metabase.geojson.settings/custom-geojson setting.
metabase_get_ gsheet_ connectionCheck the status of a connection.
metabase_get_ gsheet_ service_ accountChecks to see if service-account is setup or not, delegates to HM only if we haven't set it from a metabase cluster before.
metabase_get_ health_ inspectorGet a list of recent health check runs.
metabase_get_ index_ requestFetch a single index request (e.g. to poll its status).
metabase_get_ instance_ propertiesGet all properties and their values.
metabase_get_ libraryGet the Library.
metabase_get_ library_ treeThis matches /api/collection/tree but only returns the library collection.
metabase_get_ license_ statusFetch info about the current Premium-Features premium features token including whether it is `valid`, a `trial` token, its `features`, when it is `valid-thru`, and the `status` of the account.
metabase_get_ logger_ presetsGet all known presets.
metabase_get_ login_ historyFetch recent logins for the current user.
metabase_get_ mfa_ admin_ enrolled_ usersAdmin: users who have a confirmed second factor.
metabase_get_ mfa_ admin_ overviewAdmin: enrollment overview — how many users have (and haven't) set up a second factor, and whether the instance encrypts secrets at rest.
metabase_get_ mfa_ admin_ unenrolled_ usersAdmin: active users who have not set up a second factor.
metabase_get_ model_ indexRetrieve ModelIndex.
metabase_get_ most_ recently_ viewed_ dashboardGet the most recently viewed dashboard for the current user.
metabase_get_ oauth_ authorizationsList OAuth dynamic client registration events (registered, approved, or denied), newest first.
metabase_get_ osi_ ai_ contextGet the ai_context entry for an entity by its logical `(entity_type, entity_local_id)` key.
metabase_get_ query_ execution_ logsFetch rows for the month specified by `:yyyy-mm` from the query_execution logs table.
metabase_get_ revisionFetch `Revisions` for an object with ID.
metabase_get_ security_ centerList all security advisories with match status.
metabase_get_ semantic_ search_ statusFetch the indexing status of the currently active semantic search index table.
metabase_get_ server_ logsLogs.
metabase_get_ settingFetch a single `Setting`.
metabase_get_ slack_ app_ infoReturns the Slack app_id and team_id.
metabase_get_ slack_ manifestReturns the JSON manifest file that should be used to bootstrap new Slack apps
metabase_get_ snippetFetch native query snippet with ID.
metabase_get_ support_ access_ grant_ currentGet the currently active support access grant, if one exists.
Credentials off one Metabase screen, then an endpoint your client signs into. Nothing to deploy, and nothing to install.
In Metabase, click the grid icon and choose Admin, then Settings, then Authentication, then API keys. Create a key, name it, pick a group and copy the key. Paste your Metabase address and the key. The Administrators group gives every tool; any other group reaches what that group can.
https://yourcompany.metabaseapp.com••••••••••••3f7aCreating questions, changing permissions, sending alerts and running actions take effect as soon as the AI calls them, and deletes are permanent. Tick Metabase on the PopMCP consent screen only for clients that should change it. On a read-only connection, SQL must be a single SELECT, and a database login that can only read is the firm guarantee. Teammates start on read-only.
Drop the PopMCP URL into Claude, ChatGPT, Claude Code, Codex or any other supported client. It signs in through PopMCP with OAuth, so your Metabase credential never leaves the server.
app.popmcp.com/mcpAsk for something harmless before the agent changes anything. Writes run as soon as it calls them, so confirm it reads the right account first.
Find our revenue dashboard and tell me what changed in the numbers it shows
metabase_searchok
Then just ask for the work
“Find our revenue dashboard and tell me what changed in the numbers it shows”
“What tables hold orders in the warehouse, and how many orders did we get per week this quarter”
“Run the Churn by plan question for the EU region only and list the three worst plans”
“Save that query as a question called Weekly orders and add it to the Sales dashboard”
One hosted endpoint, registered once per client. The same tools and the same permissions, whichever window the request comes from.
Add the PopMCP URL under Customize → Connectors and the tools appear in every chat.
The same endpoint, registered in the browser. Nothing to install on the machine you are working from.
Register PopMCP as a custom connector, then let ChatGPT read and update the account.
Wire the endpoint into Codex or the Codex CLI when a task needs live business context, not a fixture.
Register the remote MCP server in OpenCode's config for terminal-first and scripted agent runs.
Add PopMCP as an MCP server in Z.ai's desktop app and work the account from the same window.
FAQ
What teams ask before putting Metabase behind an AI client.
Your Metabase address and an API key. An admin makes the key in Metabase under Admin, Settings, Authentication, then API keys. API keys are on every Metabase plan, including the free open-source edition, from version 0.49. Metabase shows the key once, and PopMCP stores it encrypted.
Yes, on any HTTPS address the internet can reach, including Metabase served under a subdirectory. PopMCP cannot reach a Metabase that is only on a private network. Metabase Cloud works the same way, with an address like yourcompany.metabaseapp.com.
What the API key's Metabase group can see. A key in the Administrators group reaches every tool, including people, settings and permissions. A key in another group reaches only the questions, dashboards and data that group has access to, and Metabase refuses the rest. Choosing a group with limited access is the way to narrow it.
On a read-only connection, PopMCP allows only a single statement that reads, and refuses anything with a writing keyword before it reaches Metabase. That is a check on the text of the query, so the firm guarantee is connecting Metabase to your database with a login that can only read. Saved questions run as they were saved. On a connection with write actions on, SQL is sent as written and your database login decides.
200 rows by default, and up to 2,000 if the AI asks, with a clear note when there are more. Metabase itself stops at 2,000 raw rows or 10,000 aggregated rows unless an admin changed that. Queries run on your own database, so a heavy one costs what it would cost anywhere else, and the tools tell the AI to filter and limit.
A new key would land in the AI conversation in full, so creating and regenerating keys stays in Metabase's Admin screens, along with passwords and sign-in links. The AI can list keys, which Metabase masks, rename them and delete them. Secret settings and database passwords are hidden in every answer as well.
664: every Metabase API endpoint an API key can call that returns text, plus seven multi-step tools for an overview, describing a database, running SQL and questions, reading a dashboard, saving SQL as a question and adding questions to a dashboard. Forty-two everyday tools load by default and the rest stay searchable, so your AI client is not crowded.
No. PopMCP hosts it and gives you a Streamable HTTP MCP URL. There is nothing to deploy, no callback URL to register, and no infrastructure to keep running or patch.
Any client that supports a remote Streamable HTTP MCP server: Claude Desktop, Claude Web, Claude Code, ChatGPT custom connectors, Codex and the Codex CLI, OpenCode and Z.ai's ZCode, as well as editors such as Cursor, Windsurf and Zed. Your client signs in to PopMCP with OAuth; the provider credential never leaves the server.
Connect Metabase in PopMCP first, then run claude mcp add --transport http popmcp https://app.popmcp.com/mcp in a terminal. Inside Claude Code, run /mcp and sign in to PopMCP in the browser window it opens, ticking Metabase on the consent screen. The Metabase tools are then available in that session, and no Metabase credential is stored on your machine.
Loading 662 tool definitions into every conversation burns context before the work starts. PopMCP loads a curated 42-tool set covering the everyday workflows and keeps the rest searchable, so your AI pulls a specialist tool only when a task needs it. Every tool stays searchable, and on Scale the owner can load the full catalog for a teammate's connection.
A tool is something your AI calls, and there are 662 here. A trigger is something PopMCP watches for you: 9 Metabase events that can start work on the PopMCP side. Triggers never enter your AI client's context, and none of them ask you to paste a callback URL into Metabase.
Launch a hosted MCP endpoint for Metabase, keep tool access under control, and start testing real workflow prompts right away.