Skip to main content
Call extension__metric__search_metrics with the inputs below. Open an MCP session with mcp__initialise first and pass its session_id. The authenticated tools/list response is the final check for the name and schema available to your account. Find metric definitions in ONE workspace, ranked by relevance to query (or resolved exactly by name). Each item carries the Core owner_id, semantic version, population, grain, output, dimension and parameter names, plus Core version and release facts. Generic registry__search_artifacts also supports workspace scope; this tool adds a compact metric projection and exact-name lookup. Read one metric in full with registry__get_artifact with artifact_id and channel latest (or release_id) to consume a published version. Search discovers heads; it does not establish publication.

Inputs

Permissions and result

The call uses your authenticated Atlan identity and the target workspace’s permissions. This tool reads existing data. A missing or inaccessible target can be refused even when the tool is listed. See MCP tool catalog for related tools and MCP Gateway errors for refusal and connection diagnostics.