π 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.mdxindex 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 Transformdiff --git a/src/fastmcp/server/providers/local_provider.py b/src/fastmcp/server/providers/local_provider.pyindex 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 tooldef 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 resourcedef 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 promptdef 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_objelse:from fastmcp.tools.function_tool import ToolMeta