1luvc0d3/metabase-mcp

Introduces CodeAct-inspired composable tools and makes compact responses the default. Inspired by Apple's CodeAct research and Cloudflare Code Mode.

What's New

batch_execute — parallel operations in one call

Run up to 20 read operations simultaneously. Ideal for fetching multiple dashboards, cards, or schemas in a single round trip.

{
  "operations": [
    { "tool": "get_dashboard", "args": { "dashboard_id": 1 } },
    { "tool": "get_dashboard", "args": { "dashboard_id": 2 } },
    { "tool": "execute_card", "args": { "card_id": 5 } }
  ]
}

run_workflow — composable multi-step pipelines

Chain tools sequentially with $stepName.path references to pipe outputs between steps. Eliminates multi-turn chatter for common data exploration flows.

{
  "steps": [
    { "name": "find", "tool": "search_content", "args": { "query": "revenue" } },
    { "name": "details", "tool": "get_card", "args": { "card_id": "$find.results[0].id" } },
    { "name": "data", "tool": "execute_card", "args": { "card_id": "$find.results[0].id" } }
  ]
}

Default compact responses

All tools now return compact JSON by default (~50% token reduction). Use format: "default" to opt into pretty-printed output.

What's Changed

• batch_execute tool — parallel execution of multiple read operations (#40)
• run_workflow tool — composable pipelines with output chaining and per-step error handling (#40)
• Compact responses by default — all 30 tools now use compact JSON (#40)
• 30 total tools (up from 28)

Install

One-click

Download metabase-mcp-1.3.0.mcpb below, double-click in Claude Desktop.

npm

npx @ai-1luvc0d3/[email protected]

Full Changelog: https://github.com/1luvc0d3/metabase-mcp/compare/v1.2.0...v1.3.0

Adds token-optimized compact response format and Streamable HTTP transport alongside stdio.

What's Changed

• Compact response format — new format: "compact" option on query/schema tools reduces token usage by ~50% (#38)
• Streamable HTTP transport — MCP server now supports HTTP in addition to stdio for remote deployments (#38)
• README repositioned vs Metabase's official MCP (v0.60) — clarifies our differentiation (#37)

Install

npm

npx @ai-1luvc0d3/[email protected]

Full Changelog: https://github.com/1luvc0d3/metabase-mcp/compare/v1.1.1...v1.2.0

Patch release bringing the repo into full compliance with Anthropic's MCP Directory Policy ahead of directory submission.

What's Changed

• Tool annotations on all 28 tools (#32) — every tool declares `readOnlyHint` or `destructiveHint` plus `title`, per MCP spec
• Privacy Policy section in README (#32) — documents what's collected, transmitted, and retained
• Troubleshooting and Support sections in README (#32)

Install

One-click

Download `metabase-mcp-1.1.1.mcpb` below, double-click in Claude Desktop.

npm

```bash
npx @ai-1luvc0d3/[email protected]
```

Full Changelog: https://github.com/1luvc0d3/metabase-mcp/compare/v1.1.0...v1.1.1