Skip to content

πŸš€ The fast, Pythonic way to build MCP servers and clients.

Simplify disable calls to use keys only; fix filtering docs

Jeremiah Lowin84eb35bcb4fb
diff --git a/docs/servers/enabled.mdx b/docs/servers/enabled.mdx
index fe4836a26..af47f30dd 100644
--- a/docs/servers/enabled.mdx
+++ b/docs/servers/enabled.mdx
@@ -305,14 +305,13 @@ mcp.disable(tags={"maintenance"})
Understanding the filtering logic helps when debugging enabled state issues.
-The `is_enabled()` function checks components in this order:
+The `is_enabled()` function checks a component's internal metadata:
-1. **Blocklist by key**: If the component's key is in `_disabled_keys`, it's disabled
-2. **Blocklist by tag**: If any of the component's tags are in `_disabled_tags`, it's disabled
-3. **Allowlist check**: If default enabled is off (allowlist mode) and the component isn't in the allowlist, it's disabled
-4. **Default**: Otherwise, the component is enabled
+1. If the component has `meta.fastmcp._internal.enabled = False`, it's disabled
+2. If the component has `meta.fastmcp._internal.enabled = True`, it's enabled
+3. If no enabled state is set, the component is enabled by default
-The blocklist always wins over the allowlist. A component that matches both is disabled.
+When multiple `enable()` and `disable()` calls are made, transforms are applied in order. **Later transforms override earlier ones**, so the last matching transform wins.
## The Enabled Transform
diff --git a/src/fastmcp/server/providers/local_provider.py b/src/fastmcp/server/providers/local_provider.py
index abdcdbd65..1bc507ce3 100644
--- a/src/fastmcp/server/providers/local_provider.py
+++ b/src/fastmcp/server/providers/local_provider.py
@@ -283,7 +283,7 @@ class LocalProvider(Provider):
tool = Tool.from_function(tool)
self._add_component(tool)
if not enabled:
- self.disable(keys={tool.key}, components=["tool"], version=tool.version)
+ self.disable(keys={tool.key})
return tool
def remove_tool(self, name: str, version: str | None = None) -> None:
@@ -374,18 +374,7 @@ class LocalProvider(Provider):
)
self._add_component(resource)
if not enabled:
- if isinstance(resource, ResourceTemplate):
- self.disable(
- keys={resource.key},
- components=["template"],
- version=resource.version,
- )
- else:
- self.disable(
- keys={resource.key},
- components=["resource"],
- version=resource.version,
- )
+ self.disable(keys={resource.key})
return resource
def remove_resource(self, uri: str, version: str | None = None) -> None:
@@ -483,9 +472,7 @@ class LocalProvider(Provider):
)
self._add_component(prompt)
if not enabled:
- self.disable(
- keys={prompt.key}, components=["prompt"], version=prompt.version
- )
+ self.disable(keys={prompt.key})
return prompt
def remove_prompt(self, name: str, version: str | None = None) -> None:
@@ -809,11 +796,7 @@ class LocalProvider(Provider):
)
self._add_component(tool_obj)
if not enabled:
- self.disable(
- keys={tool_obj.key},
- components=["tool"],
- version=tool_obj.version,
- )
+ self.disable(keys={tool_obj.key})
return tool_obj
else:
from fastmcp.tools.function_tool import ToolMeta