Skip to content

The easy-to-use open source Business Intelligence and Embedded Analytics tool that lets everyone work with data :bar_chart:

Update tool description for read_resource (#76609)

Jeff Bruemmer342b6fcb79f9
diff --git a/src/metabase/agent_api/api.clj b/src/metabase/agent_api/api.clj
index e022805006d..01bedc3b384 100644
--- a/src/metabase/agent_api/api.clj
+++ b/src/metabase/agent_api/api.clj
@@ -697,7 +697,7 @@
:tool {:name "read_resource"
:description (str "Read Metabase entities by metabase:// URI. "
"Examples: metabase://databases, metabase://database/{id}/tables, "
- "metabase://collection/{id}/items, metabase://card/{id}, "
+ "metabase://collection/{id}/items, metabase://question/{id}, "
"metabase://dashboard/{id}/items, metabase://table/{id}/fields. "
"Up to 5 URIs per call. List endpoints cap at 25 items.")}}
[_route-params
diff --git a/src/metabase/mcp/README.md b/src/metabase/mcp/README.md
index 5199559f8e3..4a6444a29ac 100644
--- a/src/metabase/mcp/README.md
+++ b/src/metabase/mcp/README.md
@@ -85,7 +85,7 @@ The MCP server exposes these tools, dynamically generated from the Agent API end
| Tool | Description |
| --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `search` | Search for tables, metrics, cards, dashboards, and collections using keyword or natural-language queries. |
-| `read_resource` | Read one or more Metabase entities by `metabase://` URI. Covers database/schema/table/collection/card/dashboard/metric/transform navigation. Up to 5 URIs per call. |
+| `read_resource` | Read one or more Metabase entities by `metabase://` URI. Covers database/schema/table/collection/question/dashboard/metric/transform navigation. Up to 5 URIs per call. |
### Query construction + execution
@@ -121,7 +121,7 @@ clients can fetch supplementary content by URI without inflating tool descriptio
| ------------------------------------ | ----------------------------------------------------------------------------------------------------------------- |
| `metabase://docs/construct-query.md` | Program syntax for `construct_query` and `query`: sources, operations, operator forms, worked examples, pitfalls. |
-The `read_resource` **tool** (above) uses a separate URI scheme to navigate Metabase entities (`metabase://card/{id}`,
+The `read_resource` **tool** (above) uses a separate URI scheme to navigate Metabase entities (`metabase://question/{id}`,
`metabase://database/{id}/tables`, etc.). The two URI namespaces are independent: `metabase://docs/...` is for static
reference content fetched via MCP `resources/read`, while `metabase://table/...` and friends are entity URIs passed
to the `read_resource` tool.