feat: add MCP tool to expose server version

Add a new get_mcp_server_version tool that returns the current version
of the dbt-mcp server. This toolset is disabled by default and can be
enabled via DBT_MCP_ENABLE_MCP_SERVER_METADATA=true.

Author: b-per

.changes/unreleased/Enhancement or New Feature-20260114-server-version-tool.yaml

@@ -0,0 +1,3 @@
+kind: Enhancement or New Feature
+body: Add MCP tool to expose server version
+time: 2026-01-14T10:00:00.000000+01:00

.task/checksum/d2

@@ -1 +1 @@
-f795cdc3073a1e601e0609c2ecdc6af6
+fb7ca5e5d199fba3a564f3d8b49d7e48

README.md

@@ -88,6 +88,9 @@ The dbt MCP server architecture allows for your agent to connect to a variety of
 - `fusion.get_column_lineage`
 - `get_column_lineage`
 
+### Mcp Server Metadata
+- `get_mcp_server_version`
+
 
 ## Examples
 

docs/d2.png

@@ -56,6 +56,10 @@ tools: Tools {
     style.border-radius: 8
   }
 
+  mcp_server_metadata: Mcp Server Metadata {
+    style.border-radius: 8
+  }
+
 }
 
 mcp -- tools.*

docs/diagram.d2

@@ -27,6 +27,7 @@
     Toolset.DISCOVERY: "disable_discovery",
     Toolset.DBT_LSP: "disable_lsp",
     Toolset.SQL: "actual_disable_sql",
+    Toolset.MCP_SERVER_METADATA: "disable_mcp_server_metadata",
 }
 
 TOOLSET_TO_ENABLE_ATTR = {
@@ -37,6 +38,7 @@
     Toolset.DISCOVERY: "enable_discovery",
     Toolset.DBT_LSP: "enable_lsp",
     Toolset.SQL: "enable_sql",
+    Toolset.MCP_SERVER_METADATA: "enable_mcp_server_metadata",
 }
 
 

src/dbt_mcp/config/config.py

@@ -77,6 +77,7 @@ class DbtMcpSettings(BaseSettings):
         None, alias="DISABLE_TOOLS"
     )
     disable_lsp: bool | None = Field(None, alias="DISABLE_LSP")
+    disable_mcp_server_metadata: bool = Field(True, alias="DISABLE_MCP_SERVER_METADATA")
 
     # Enable tool settings (allowlist)
     enable_tools: Annotated[list[ToolName] | None, NoDecode] = Field(
@@ -89,6 +90,9 @@ class DbtMcpSettings(BaseSettings):
     enable_discovery: bool = Field(False, alias="DBT_MCP_ENABLE_DISCOVERY")
     enable_lsp: bool = Field(False, alias="DBT_MCP_ENABLE_LSP")
     enable_sql: bool = Field(False, alias="DBT_MCP_ENABLE_SQL")
+    enable_mcp_server_metadata: bool = Field(
+        False, alias="DBT_MCP_ENABLE_MCP_SERVER_METADATA"
+    )
 
     # Tracking settings
     do_not_track: str | None = Field(None, alias="DO_NOT_TRACK")

src/dbt_mcp/config/settings.py

@@ -16,6 +16,7 @@
 from dbt_mcp.dbt_cli.tools import register_dbt_cli_tools
 from dbt_mcp.dbt_codegen.tools import register_dbt_codegen_tools
 from dbt_mcp.discovery.tools import register_discovery_tools
+from dbt_mcp.mcp_server_metadata.tools import register_mcp_server_tools
 from dbt_mcp.lsp.providers.local_lsp_client_provider import LocalLSPClientProvider
 from dbt_mcp.lsp.providers.local_lsp_connection_provider import (
     LocalLSPConnectionProvider,
@@ -153,11 +154,22 @@ async def create_dbt_mcp(config: Config) -> DbtMCP:
         name="dbt",
         lifespan=app_lifespan,
     )
+
     disabled_tools = set(config.disable_tools)
     enabled_tools = set(config.enable_tools)
     enabled_toolsets = config.enabled_toolsets
     disabled_toolsets = config.disabled_toolsets
 
+    # Register MCP server tools (always available)
+    logger.info("Registering MCP server tools")
+    register_mcp_server_tools(
+        dbt_mcp,
+        disabled_tools=disabled_tools,
+        enabled_tools=enabled_tools,
+        enabled_toolsets=enabled_toolsets,
+        disabled_toolsets=disabled_toolsets,
+    )
+
     if config.semantic_layer_config_provider:
         logger.info("Registering semantic layer tools")
         register_sl_tools(

src/dbt_mcp/mcp/server.py

@@ -0,0 +1 @@
+"""MCP Server tools module."""

src/dbt_mcp/mcp_server_metadata/__init__.py

@@ -0,0 +1,58 @@
+"""MCP Server tools for server information and management."""
+
+import logging
+from importlib.metadata import version
+
+from mcp.server.fastmcp import FastMCP
+
+from dbt_mcp.tools.definitions import ToolDefinition, dbt_mcp_tool
+from dbt_mcp.tools.register import register_tools
+from dbt_mcp.tools.tool_names import ToolName
+from dbt_mcp.tools.toolsets import Toolset
+
+logger = logging.getLogger(__name__)
+
+
+def _get_server_version() -> str:
+    """Get the dbt-mcp server version from package metadata."""
+    try:
+        return version("dbt-mcp")
+    except Exception:
+        return "unknown"
+
+
+@dbt_mcp_tool(
+    description="Get the version of the dbt MCP server. Use this to check what version of the dbt MCP server is running.",
+    title="Get MCP Server Version",
+    read_only_hint=True,
+    destructive_hint=False,
+    idempotent_hint=True,
+    open_world_hint=False,
+)
+def get_mcp_server_version() -> str:
+    """Returns the current version of the dbt MCP server."""
+    return _get_server_version()
+
+
+MCP_SERVER_TOOLS: list[ToolDefinition] = [
+    get_mcp_server_version,
+]
+
+
+def register_mcp_server_tools(
+    dbt_mcp: FastMCP,
+    *,
+    disabled_tools: set[ToolName],
+    enabled_tools: set[ToolName],
+    enabled_toolsets: set[Toolset],
+    disabled_toolsets: set[Toolset],
+) -> None:
+    """Register MCP server tools."""
+    register_tools(
+        dbt_mcp,
+        tool_definitions=MCP_SERVER_TOOLS,
+        disabled_tools=disabled_tools,
+        enabled_tools=enabled_tools,
+        enabled_toolsets=enabled_toolsets,
+        disabled_toolsets=disabled_toolsets,
+    )