claude-team-mcp 0.9.0__tar.gz → 0.9.1__tar.gz

{claude_team_mcp-0.9.0 → claude_team_mcp-0.9.1}/.pebbles/events.jsonl

@@ -228,3 +228,6 @@
 {"type":"create","timestamp":"2026-02-02T23:29:52.330658Z","issue_id":"cic-ebd","payload":{"description":"tmux_session_name_for_project() hashes the full project_path. Worktree paths produce unique hashes, creating one tmux session per worker instead of one per project. Fix: resolve worktree paths to main repo before hashing.","priority":"1","title":"tmux: worktree paths create separate sessions instead of sharing per-project session","type":"bug"}}
 {"type":"status_update","timestamp":"2026-02-02T23:30:32.877924Z","issue_id":"cic-ebd","payload":{"status":"in_progress"}}
 {"type":"close","timestamp":"2026-02-02T23:33:33.785116Z","issue_id":"cic-ebd","payload":{}}
+{"type":"create","timestamp":"2026-02-04T22:18:18.544978Z","issue_id":"cic-c29","payload":{"description":"","priority":"2","title":"message_workers: wait_mode validation rejects None from MCP clients","type":"task"}}
+{"type":"comment","timestamp":"2026-02-04T22:18:27.550553Z","issue_id":"cic-c29","payload":{"body":"When message_workers is called via MCP clients (e.g. mcporter) that send explicit null for omitted optional params, pydantic rejects it:\n\nError: Input should be a valid string [type=string_type, input_value=None, input_type=NoneType]\n\nThe type annotation is wait_mode: str = 'none' but needs to accept None.\n\nFix: Change to wait_mode: str | None = 'none' and add wait_mode = wait_mode or 'none' guard at the top of the function. Same for timeout: float = 600.0.\n\nFile: src/claude_team_mcp/tools/message_workers.py\nFunction: message_workers (line ~127)"}}
+{"type":"update","timestamp":"2026-02-04T22:18:30.31878Z","issue_id":"cic-c29","payload":{"type":"bug"}}

{claude_team_mcp-0.9.0 → claude_team_mcp-0.9.1}/CHANGELOG.md

@@ -7,6 +7,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.9.1] - 2026-02-04
+
+### Fixed
+- **MCP tool optional param validation**: All 9 MCP tools now accept `null` for optional parameters with defaults. MCP clients (e.g. mcporter) that send explicit `null` for omitted params no longer trigger pydantic validation errors.
+
 ## [0.9.0] - 2026-02-03
 
 ### Added

{claude_team_mcp-0.9.0 → claude_team_mcp-0.9.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: claude-team-mcp
-Version: 0.9.0
+Version: 0.9.1
 Summary: MCP server for managing multiple Claude Code sessions via iTerm2
 Project-URL: Homepage, https://github.com/Martian-Engineering/claude-team
 Project-URL: Repository, https://github.com/Martian-Engineering/claude-team

{claude_team_mcp-0.9.0 → claude_team_mcp-0.9.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "claude-team-mcp"
-version = "0.9.0"
+version = "0.9.1"
 description = "MCP server for managing multiple Claude Code sessions via iTerm2"
 readme = "README.md"
 requires-python = ">=3.11"

{claude_team_mcp-0.9.0 → claude_team_mcp-0.9.1}/src/claude_team_mcp/tools/adopt_worker.py

@@ -35,7 +35,7 @@ def register_tools(mcp: FastMCP, ensure_connection) -> None:
         iterm_session_id: str | None = None,
         tmux_pane_id: str | None = None,
         session_name: str | None = None,
-        max_age: int = 3600,
+        max_age: int | None = 3600,
     ) -> dict:
         """
         Adopt an existing terminal Claude Code or Codex session into the MCP registry.
@@ -53,6 +53,9 @@ def register_tools(mcp: FastMCP, ensure_connection) -> None:
         Returns:
             Dict with adopted worker info, or error if session not found
         """
+        # Handle None values from MCP clients that send explicit null for omitted params
+        max_age = max_age if max_age is not None else 3600
+
         app_ctx = ctx.request_context.lifespan_context
         registry = app_ctx.registry
 

{claude_team_mcp-0.9.0 → claude_team_mcp-0.9.1}/src/claude_team_mcp/tools/close_workers.py

@@ -133,7 +133,7 @@ def register_tools(mcp: FastMCP) -> None:
     async def close_workers(
         ctx: Context[ServerSession, "AppContext"],
         session_ids: list[str],
-        force: bool = False,
+        force: bool | None = False,
     ) -> dict:
         """
         Close one or more managed Claude Code sessions.
@@ -163,6 +163,9 @@ def register_tools(mcp: FastMCP) -> None:
                 - success_count: Number of sessions closed successfully
                 - failure_count: Number of sessions that failed to close
         """
+        # Handle None values from MCP clients that send explicit null for omitted params
+        force = force if force is not None else False
+
         app_ctx = ctx.request_context.lifespan_context
         registry = app_ctx.registry
         backend = app_ctx.terminal_backend

{claude_team_mcp-0.9.0 → claude_team_mcp-0.9.1}/src/claude_team_mcp/tools/discover_workers.py

@@ -33,7 +33,7 @@ def register_tools(mcp: FastMCP, ensure_connection) -> None:
     @mcp.tool()
     async def discover_workers(
         ctx: Context[ServerSession, "AppContext"],
-        max_age: int = 3600,
+        max_age: int | None = 3600,
     ) -> dict:
         """
         Discover existing Claude Code and Codex sessions running in the active terminal backend.
@@ -69,6 +69,9 @@ def register_tools(mcp: FastMCP, ensure_connection) -> None:
                 - count: Total number of sessions found
                 - unmanaged_count: Number not yet in registry (available to adopt)
         """
+        # Handle None values from MCP clients that send explicit null for omitted params
+        max_age = max_age if max_age is not None else 3600
+
         app_ctx = ctx.request_context.lifespan_context
         registry = app_ctx.registry
 

{claude_team_mcp-0.9.0 → claude_team_mcp-0.9.1}/src/claude_team_mcp/tools/list_worktrees.py

@@ -31,7 +31,7 @@ def register_tools(mcp: FastMCP) -> None:
     async def list_worktrees(
         ctx: Context[ServerSession, "AppContext"],
         repo_path: str,
-        remove_orphans: bool = False,
+        remove_orphans: bool | None = False,
     ) -> dict:
         """
         List worktrees in a repository's .worktrees/ directory.
@@ -58,6 +58,9 @@ def register_tools(mcp: FastMCP) -> None:
                 - orphan_count: Number of orphaned worktrees
                 - removed_count: Number of orphans removed (when remove_orphans=True)
         """
+        # Handle None values from MCP clients that send explicit null for omitted params
+        remove_orphans = remove_orphans if remove_orphans is not None else False
+
         resolved_path = Path(repo_path).resolve()
         if not resolved_path.exists():
             return error_response(

{claude_team_mcp-0.9.0 → claude_team_mcp-0.9.1}/src/claude_team_mcp/tools/message_workers.py

@@ -131,8 +131,8 @@ def register_tools(mcp: FastMCP) -> None:
         ctx: Context[ServerSession, "AppContext"],
         session_ids: list[str],
         message: str,
-        wait_mode: str = "none",
-        timeout: float = 600.0,
+        wait_mode: str | None = "none",
+        timeout: float | None = 600.0,
     ) -> dict:
         """
         Send a message to one or more Claude Code worker sessions.
@@ -163,6 +163,10 @@ def register_tools(mcp: FastMCP) -> None:
                 - all_idle: Whether all sessions are idle (only if wait_mode != "none")
                 - timed_out: Whether the wait timed out (only if wait_mode != "none")
         """
+        # Handle None values from MCP clients that send explicit null for omitted params
+        wait_mode = wait_mode or "none"
+        timeout = timeout if timeout is not None else 600.0
+
         app_ctx = ctx.request_context.lifespan_context
         registry = app_ctx.registry
         backend = app_ctx.terminal_backend

{claude_team_mcp-0.9.0 → claude_team_mcp-0.9.1}/src/claude_team_mcp/tools/poll_worker_changes.py

@@ -122,7 +122,7 @@ def register_tools(mcp: FastMCP) -> None:
         ctx: Context[ServerSession, "AppContext"],
         since: str | None = None,
         stale_threshold_minutes: int | None = None,
-        include_snapshots: bool = False,
+        include_snapshots: bool | None = False,
     ) -> dict:
         """
         Poll worker event changes since a timestamp.
@@ -144,6 +144,9 @@ def register_tools(mcp: FastMCP) -> None:
                 - idle_count: Count of idle workers
                 - poll_ts: Timestamp when poll was generated
         """
+        # Handle None values from MCP clients that send explicit null for omitted params
+        include_snapshots = include_snapshots if include_snapshots is not None else False
+
         app_ctx = ctx.request_context.lifespan_context
         registry = app_ctx.registry
 

{claude_team_mcp-0.9.0 → claude_team_mcp-0.9.1}/src/claude_team_mcp/tools/read_worker_logs.py

@@ -22,8 +22,8 @@ def register_tools(mcp: FastMCP) -> None:
     async def read_worker_logs(
         ctx: Context[ServerSession, "AppContext"],
         session_id: str,
-        pages: int = 1,
-        offset: int = 0,
+        pages: int | None = 1,
+        offset: int | None = 0,
     ) -> dict:
         """
         Get conversation history from a Claude Code session with reverse pagination.
@@ -51,6 +51,10 @@ def register_tools(mcp: FastMCP) -> None:
                 - page_info: Pagination metadata (total_messages, total_pages, etc.)
                 - session_id: The session ID
         """
+        # Handle None values from MCP clients that send explicit null for omitted params
+        pages = pages if pages is not None else 1
+        offset = offset if offset is not None else 0
+
         app_ctx = ctx.request_context.lifespan_context
         registry = app_ctx.registry
 

{claude_team_mcp-0.9.0 → claude_team_mcp-0.9.1}/src/claude_team_mcp/tools/wait_idle_workers.py

@@ -28,9 +28,9 @@ def register_tools(mcp: FastMCP) -> None:
     async def wait_idle_workers(
         ctx: Context[ServerSession, "AppContext"],
         session_ids: list[str],
-        mode: str = "all",
-        timeout: float = 600.0,
-        poll_interval: float = 2.0,
+        mode: str | None = "all",
+        timeout: float | None = 600.0,
+        poll_interval: float | None = 2.0,
     ) -> dict:
         """
         Wait for worker sessions to become idle.
@@ -56,6 +56,11 @@ def register_tools(mcp: FastMCP) -> None:
                 - waited_seconds: How long we waited
                 - timed_out: Whether we hit the timeout
         """
+        # Handle None values from MCP clients that send explicit null for omitted params
+        mode = mode or "all"
+        timeout = timeout if timeout is not None else 600.0
+        poll_interval = poll_interval if poll_interval is not None else 2.0
+
         app_ctx = ctx.request_context.lifespan_context
         registry = app_ctx.registry
 

{claude_team_mcp-0.9.0 → claude_team_mcp-0.9.1}/src/claude_team_mcp/tools/worker_events.py

@@ -193,10 +193,10 @@ def register_tools(mcp: FastMCP) -> None:
     async def worker_events(
         ctx: Context[ServerSession, "AppContext"],
         since: str | None = None,
-        limit: int = 1000,
-        include_snapshot: bool = False,
-        include_summary: bool = False,
-        stale_threshold_minutes: int = 10,
+        limit: int | None = 1000,
+        include_snapshot: bool | None = False,
+        include_summary: bool | None = False,
+        stale_threshold_minutes: int | None = 10,
         project_filter: str | None = None,
     ) -> dict:
         """
@@ -230,6 +230,12 @@ def register_tools(mcp: FastMCP) -> None:
                     - last_event_ts: newest event timestamp
                 - snapshot: (if include_snapshot) Latest snapshot {ts, data}
         """
+        # Handle None values from MCP clients that send explicit null for omitted params
+        limit = limit if limit is not None else 1000
+        include_snapshot = include_snapshot if include_snapshot is not None else False
+        include_summary = include_summary if include_summary is not None else False
+        stale_threshold_minutes = stale_threshold_minutes if stale_threshold_minutes is not None else 10
+
         # Parse the since timestamp if provided.
         parsed_since = None
         if since is not None and since.strip():

{claude_team_mcp-0.9.0 → claude_team_mcp-0.9.1}/uv.lock

@@ -114,7 +114,7 @@ wheels = [
 
 [[package]]
 name = "claude-team-mcp"
-version = "0.8.2"
+version = "0.9.1"
 source = { editable = "." }
 dependencies = [
     { name = "iterm2" },