Skip to content

v0.4.0

Choose a tag to compare

@Serdnaley Serdnaley released this 26 Oct 10:32
· 43 commits to main since this release
70454c7

Breaking

  • Query tools return compact output by default; pass verbose: true for the raw Metabase response.
  • list_tasks moved from the activity toolset to diagnostics.

Large-result safety

  • Query tools (execute_query, execute_card_query, run_metric) return a compact view by default:
    columns (name, type) + rows, no column internals, results_metadata or insights. verbose: true
    returns the raw Metabase response.
  • Row cap METABASE_MAX_ROWS (default 500) with per-call max_rows and offset paging; a note
    says how to get the rest (next offset, or an export tool with output_path).
  • Every tool response is serialised as compact JSON and capped at METABASE_MAX_RESPONSE_CHARS
    (default 100000) with a truncation notice.
  • Measured on a 10 / 100 / 500-row SELECT * FROM ORDERS: 94% / 76% / 60% fewer characters than 0.3.0.

Resources and prompts

  • MCP resources: metabase://databases, metabase://database/{id}/schema, metabase://card/{id},
    metabase://dashboard/{id}, metabase://collection/{id} (compact JSON summaries).
  • Prompts: explore-database, build-dashboard, explain-card, audit-permissions.
  • Both follow the tool selection: resources need their toolset, prompts need every tool they use.

Admin tools (17 new, 178 total)

  • API keys toolset: list_api_keys, create_api_key (full key returned once),
    update_api_key, regenerate_api_key, delete_api_key.
  • Embedding toolset: get_embedding_status (settings, embeddable items, whether a signing key
    exists, never its value), set_static_embedding, set_resource_embedding (per-parameter
    enabled/locked/disabled), create_embed_url (signed iframe URL, signed locally).
  • Tasks & logs (diagnostics) toolset: list_tasks (now with status/task filters, paging and
    compact output; moved from activity), get_task, list_task_types, list_task_runs,
    get_scheduler_info, get_server_logs (level/text filter, ANSI stripped), list_log_presets,
    set_log_levels / reset_log_levels (temporary), get_premium_token_status.
  • The admin preset includes the three new toolsets.

Types

  • generated/metabase-api.d.ts regenerated from the Metabase v0.64 OpenAPI spec (the CI version;
    scripts/generate-types.ts is now pinned to it, METABASE_SPEC overrides). 27 as any casts
    removed where the new types cover the calls.