DI-4002 consolidate 8 get_*_details Discovery tools into get_details

Replaces get_model_details, get_source_details, get_exposure_details,
get_test_details, get_seed_details, get_snapshot_details, get_macro_details,
and get_semantic_model_details with a single get_details(resource_type, ...)
tool that dispatches to the existing ResourceDetailsFetcher.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

Author: theyostalservice

.changes/unreleased/Enhancement or New Feature-20260622-103900.yaml

@@ -0,0 +1,3 @@
+kind: Enhancement or New Feature
+body: Consolidate 8 get_*_details Discovery tools into a single get_details(resource_type, ...) tool
+time: 2026-06-22T10:39:00.432662-07:00

README.md

@@ -45,20 +45,13 @@ To learn more about the dbt Discovery API, click [here](https://docs.getdbt.com/
 - `get_all_macros`: Retrieves macros; option to filter by package or return package names only.
 - `get_all_models`: Retrieves name and description of all models.
 - `get_all_sources`: Gets all sources with freshness status; option to filter by source name.
-- `get_exposure_details`: Gets exposure details including owner, parents, and freshness status.
+- `get_details`: Gets full details for any dbt resource type (model, source, exposure, test, seed, snapshot, macro, semantic_model).
 - `get_exposures`: Gets all exposures (downstream dashboards, apps, or analyses).
 - `get_lineage`: Gets full lineage graph (ancestors and descendants) with type and depth filtering; use depth=1 to get immediate parents or children.
-- `get_macro_details`: Gets details for a specific macro.
 - `get_mart_models`: Retrieves all mart models.
-- `get_model_details`: Gets model details including compiled SQL, columns, and schema.
 - `get_model_health`: Gets health signals: run status, test results, and upstream source freshness.
 - `get_model_performance`: Gets execution history for a model; option to include test results.
 - `get_related_models`: Finds similar models using semantic search.
-- `get_seed_details`: Gets details for a specific seed.
-- `get_semantic_model_details`: Gets details for a specific semantic model.
-- `get_snapshot_details`: Gets details for a specific snapshot.
-- `get_source_details`: Gets source details including columns and freshness.
-- `get_test_details`: Gets details for a specific test.
 - `search`: [Alpha] Searches for resources across the dbt project (not generally available).
 
 ### dbt CLI

src/dbt_mcp/discovery/param_descriptions.py

@@ -33,3 +33,10 @@
 MACRO_INCLUDE_DEFAULT_DBT_PACKAGES = (
     "When true, include default dbt Labs core/adapter macro packages"
 )
+
+RESOURCE_TYPE_DESCRIPTION = (
+    "The type of dbt resource to fetch details for. "
+    "One of: model, source, exposure, test, seed, snapshot, macro, semantic_model. "
+    "Tip: the resource_type is encoded in the unique_id prefix "
+    "(e.g. `model.my_project.orders` → model)."
+)

src/dbt_mcp/discovery/tools.py

@@ -23,6 +23,7 @@
     MACRO_RETURN_PACKAGE_NAMES_ONLY,
     MODEL_PERF_INCLUDE_TESTS,
     MODEL_PERF_NUM_RUNS,
+    RESOURCE_TYPE_DESCRIPTION,
     SOURCE_NAMES_FILTER,
     SOURCE_UNIQUE_IDS_FILTER,
 )
@@ -139,20 +140,23 @@ async def get_all_models(
 
 
 @dbt_mcp_tool(
-    description=get_prompt("discovery/get_model_details"),
-    title="Get Model Details",
+    description=get_prompt("discovery/get_details"),
+    title="Get Details",
     read_only_hint=True,
     destructive_hint=False,
     idempotent_hint=True,
 )
-async def get_model_details(
+async def get_details(
     context: DiscoveryToolContext,
+    resource_type: Annotated[
+        AppliedResourceType, Field(description=RESOURCE_TYPE_DESCRIPTION)
+    ],
     name: str | None = NAME_FIELD,
     unique_id: str | None = UNIQUE_ID_FIELD,
 ) -> list[dict]:
     config = await context.config_provider.get_config()
     return await context.resource_details_fetcher.fetch_details(
-        resource_type=AppliedResourceType.MODEL,
+        resource_type=resource_type,
         unique_id=unique_id,
         name=name,
         config=config,
@@ -243,27 +247,6 @@ async def get_exposures(
     return await context.exposures_fetcher.fetch_exposures(config=config)
 
 
-@dbt_mcp_tool(
-    description=get_prompt("discovery/get_exposure_details"),
-    title="Get Exposure Details",
-    read_only_hint=True,
-    destructive_hint=False,
-    idempotent_hint=True,
-)
-async def get_exposure_details(
-    context: DiscoveryToolContext,
-    name: str | None = NAME_FIELD,
-    unique_id: str | None = UNIQUE_ID_FIELD,
-) -> list[dict]:
-    config = await context.config_provider.get_config()
-    return await context.resource_details_fetcher.fetch_details(
-        resource_type=AppliedResourceType.EXPOSURE,
-        unique_id=unique_id,
-        name=name,
-        config=config,
-    )
-
-
 @dbt_mcp_tool(
     description=get_prompt("discovery/get_all_sources"),
     title="Get All Sources",
@@ -286,27 +269,6 @@ async def get_all_sources(
     )
 
 
-@dbt_mcp_tool(
-    description=get_prompt("discovery/get_source_details"),
-    title="Get Source Details",
-    read_only_hint=True,
-    destructive_hint=False,
-    idempotent_hint=True,
-)
-async def get_source_details(
-    context: DiscoveryToolContext,
-    name: str | None = NAME_FIELD,
-    unique_id: str | None = UNIQUE_ID_FIELD,
-) -> list[dict]:
-    config = await context.config_provider.get_config()
-    return await context.resource_details_fetcher.fetch_details(
-        resource_type=AppliedResourceType.SOURCE,
-        unique_id=unique_id,
-        name=name,
-        config=config,
-    )
-
-
 @dbt_mcp_tool(
     description=get_prompt("discovery/get_all_macros"),
     title="Get All Macros",
@@ -335,128 +297,16 @@ async def get_all_macros(
     )
 
 
-@dbt_mcp_tool(
-    description=get_prompt("discovery/get_macro_details"),
-    title="Get Macro Details",
-    read_only_hint=True,
-    destructive_hint=False,
-    idempotent_hint=True,
-)
-async def get_macro_details(
-    context: DiscoveryToolContext,
-    name: str | None = NAME_FIELD,
-    unique_id: str | None = UNIQUE_ID_FIELD,
-) -> list[dict]:
-    config = await context.config_provider.get_config()
-    return await context.resource_details_fetcher.fetch_details(
-        resource_type=AppliedResourceType.MACRO,
-        unique_id=unique_id,
-        name=name,
-        config=config,
-    )
-
-
-@dbt_mcp_tool(
-    description=get_prompt("discovery/get_seed_details"),
-    title="Get Seed Details",
-    read_only_hint=True,
-    destructive_hint=False,
-    idempotent_hint=True,
-)
-async def get_seed_details(
-    context: DiscoveryToolContext,
-    name: str | None = NAME_FIELD,
-    unique_id: str | None = UNIQUE_ID_FIELD,
-) -> list[dict]:
-    config = await context.config_provider.get_config()
-    return await context.resource_details_fetcher.fetch_details(
-        resource_type=AppliedResourceType.SEED,
-        unique_id=unique_id,
-        name=name,
-        config=config,
-    )
-
-
-@dbt_mcp_tool(
-    description=get_prompt("discovery/get_semantic_model_details"),
-    title="Get Semantic Model Details",
-    read_only_hint=True,
-    destructive_hint=False,
-    idempotent_hint=True,
-)
-async def get_semantic_model_details(
-    context: DiscoveryToolContext,
-    name: str | None = NAME_FIELD,
-    unique_id: str | None = UNIQUE_ID_FIELD,
-) -> list[dict]:
-    config = await context.config_provider.get_config()
-    return await context.resource_details_fetcher.fetch_details(
-        resource_type=AppliedResourceType.SEMANTIC_MODEL,
-        unique_id=unique_id,
-        name=name,
-        config=config,
-    )
-
-
-@dbt_mcp_tool(
-    description=get_prompt("discovery/get_snapshot_details"),
-    title="Get Snapshot Details",
-    read_only_hint=True,
-    destructive_hint=False,
-    idempotent_hint=True,
-)
-async def get_snapshot_details(
-    context: DiscoveryToolContext,
-    name: str | None = NAME_FIELD,
-    unique_id: str | None = UNIQUE_ID_FIELD,
-) -> list[dict]:
-    config = await context.config_provider.get_config()
-    return await context.resource_details_fetcher.fetch_details(
-        resource_type=AppliedResourceType.SNAPSHOT,
-        unique_id=unique_id,
-        name=name,
-        config=config,
-    )
-
-
-@dbt_mcp_tool(
-    description=get_prompt("discovery/get_test_details"),
-    title="Get Test Details",
-    read_only_hint=True,
-    destructive_hint=False,
-    idempotent_hint=True,
-)
-async def get_test_details(
-    context: DiscoveryToolContext,
-    name: str | None = NAME_FIELD,
-    unique_id: str | None = UNIQUE_ID_FIELD,
-) -> list[dict]:
-    config = await context.config_provider.get_config()
-    return await context.resource_details_fetcher.fetch_details(
-        resource_type=AppliedResourceType.TEST,
-        unique_id=unique_id,
-        name=name,
-        config=config,
-    )
-
-
 DISCOVERY_TOOLS = [
     get_mart_models,
     get_all_models,
-    get_model_details,
+    get_details,
     get_model_health,
     get_model_performance,
     get_lineage,
     get_exposures,
-    get_exposure_details,
     get_all_sources,
-    get_source_details,
     get_all_macros,
-    get_macro_details,
-    get_seed_details,
-    get_semantic_model_details,
-    get_snapshot_details,
-    get_test_details,
 ]