Skip to content

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

fix: preserve empty session visibility selections (#5944)

Himanshu Chawla5910eb240f9f
diff --git a/docs/servers/visibility.mdx b/docs/servers/visibility.mdx
index 376424c08..8ff71867c 100644
--- a/docs/servers/visibility.mdx
+++ b/docs/servers/visibility.mdx
@@ -386,6 +386,8 @@ async def enable_recent_tools(ctx: Context) -> str:
return "Recent tools enabled"
```
+An explicit empty `names` or `keys` set matches no components, even when combined with other filters, unless `match_all=True`. Omit the parameter or pass `None` to leave that criterion unrestricted.
+
### Sessions on MCP 2026-07-28
MCP 2026-07-28 connections, which FastMCP clients negotiate by default, have no session. On those connections, session rules are scoped to the authenticated user, the same identity [`UserSession`](/servers/sessions) uses, so they apply to every connection that user makes. Without authentication, stdio servers keep one set of rules for the process, because a stdio server serves a single client. An unauthenticated HTTP request carries nothing that identifies its client between requests, so `enable_components()`, `disable_components()`, and `reset_visibility()` raise an error rather than changing what every client sees.
diff --git a/fastmcp_slim/fastmcp/server/transforms/visibility.py b/fastmcp_slim/fastmcp/server/transforms/visibility.py
index 664ccd3f4..42cfafd6b 100644
--- a/fastmcp_slim/fastmcp/server/transforms/visibility.py
+++ b/fastmcp_slim/fastmcp/server/transforms/visibility.py
@@ -396,8 +396,10 @@ def create_visibility_transforms(rules: list[dict[str, Any]]) -> list[Visibility
transforms.append(
Visibility(
params["enabled"],
- names=set(params["names"]) if params.get("names") else None,
- keys=set(params["keys"]) if params.get("keys") else None,
+ names=(
+ set(params["names"]) if params.get("names") is not None else None
+ ),
+ keys=(set(params["keys"]) if params.get("keys") is not None else None),
version=version,
tags=set(params["tags"]) if params.get("tags") else None,
components=(
@@ -452,8 +454,8 @@ async def enable_components(
# Create new rule dict
rule: dict[str, Any] = {
"enabled": True,
- "names": list(names) if names else None,
- "keys": list(keys) if keys else None,
+ "names": list(names) if names is not None else None,
+ "keys": list(keys) if keys is not None else None,
"version": (
{"gte": version.gte, "lt": version.lt, "eq": version.eq}
if version
@@ -506,8 +508,8 @@ async def disable_components(
# Create new rule dict
rule: dict[str, Any] = {
"enabled": False,
- "names": list(names) if names else None,
- "keys": list(keys) if keys else None,
+ "names": list(names) if names is not None else None,
+ "keys": list(keys) if keys is not None else None,
"version": (
{"gte": version.gte, "lt": version.lt, "eq": version.eq}
if version
diff --git a/tests/server/test_session_visibility_empty_filters.py b/tests/server/test_session_visibility_empty_filters.py
new file mode 100644
index 000000000..f20b9fbe4
--- /dev/null
+++ b/tests/server/test_session_visibility_empty_filters.py
@@ -0,0 +1,55 @@
+"""Session visibility must preserve explicit empty component selections."""
+
+from typing import Literal
+
+import pytest
+
+from fastmcp import Client, FastMCP
+from fastmcp.server.context import Context
+
+
[email protected]("selector", ["names", "keys"])
[email protected]("selection", ["empty", "matching", "nonmatching", "omitted"])
[email protected]("enabled", [True, False])
+async def test_session_selection_matches_global_selection(
+ selector: Literal["names", "keys"],
+ selection: Literal["empty", "matching", "nonmatching", "omitted"],
+ enabled: bool,
+) -> None:
+ server = FastMCP("Selection")
+ names: set[str] | None = None
+ keys: set[str] | None = None
+ if selection != "omitted":
+ name = "report" if selection == "matching" else "other"
+ value = name if selector == "names" else f"tool:{name}@"
+ selected = set() if selection == "empty" else {value}
+ if selector == "names":
+ names = selected
+ else:
+ keys = selected
+
+ @server.tool(tags={"finance"})
+ def report() -> str:
+ return "report"
+
+ @server.tool
+ async def update_visibility(ctx: Context) -> list[str]:
+ if enabled:
+ await ctx.enable_components(tags={"finance"}, names=names, keys=keys)
+ else:
+ await ctx.disable_components(tags={"finance"}, names=names, keys=keys)
+ return sorted(tool.name for tool in await ctx.fastmcp.list_tools())
+
+ if enabled:
+ server.disable(tags={"finance"})
+ server.enable(tags={"finance"}, names=names, keys=keys)
+ else:
+ server.disable(tags={"finance"}, names=names, keys=keys)
+
+ async with Client(server) as client:
+ expected = sorted(tool.name for tool in await client.list_tools())
+ result = await client.call_tool("update_visibility")
+
+ assert result.data == expected
+ should_match = selection in {"matching", "omitted"}
+ assert ("report" in result.data) is (enabled if should_match else not enabled)