fast-agent-mcp 0.2.55__tar.gz → 0.2.57__tar.gz

{fast_agent_mcp-0.2.55 → fast_agent_mcp-0.2.57}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fast-agent-mcp
-Version: 0.2.55
+Version: 0.2.57
 Summary: Define, Prompt and Test MCP enabled Agents and Workflows
 Author-email: Shaun Smith <fastagent@llmindset.co.uk>
 License:                                  Apache License
@@ -211,7 +211,7 @@ Classifier: Programming Language :: Python :: 3
 Requires-Python: >=3.13
 Requires-Dist: a2a-sdk>=0.3.0
 Requires-Dist: aiohttp>=3.11.13
-Requires-Dist: anthropic>=0.59.0
+Requires-Dist: anthropic>=0.63.0
 Requires-Dist: azure-identity>=1.14.0
 Requires-Dist: boto3>=1.35.0
 Requires-Dist: deprecated>=1.2.18
@@ -219,7 +219,7 @@ Requires-Dist: email-validator>=2.2.0
 Requires-Dist: fastapi>=0.115.6
 Requires-Dist: google-genai>=1.27.0
 Requires-Dist: mcp==1.12.4
-Requires-Dist: openai>=1.97.1
+Requires-Dist: openai>=1.99.9
 Requires-Dist: opentelemetry-distro>=0.55b0
 Requires-Dist: opentelemetry-exporter-otlp-proto-http>=1.7.0
 Requires-Dist: opentelemetry-instrumentation-anthropic>=0.43.1; python_version >= '3.10' and python_version < '4.0'
@@ -234,20 +234,6 @@ Requires-Dist: pyyaml>=6.0.2
 Requires-Dist: rich>=14.1.0
 Requires-Dist: tensorzero>=2025.7.5
 Requires-Dist: typer>=0.15.1
-Provides-Extra: azure
-Requires-Dist: azure-identity>=1.14.0; extra == 'azure'
-Provides-Extra: dev
-Requires-Dist: anthropic>=0.42.0; extra == 'dev'
-Requires-Dist: pre-commit>=4.0.1; extra == 'dev'
-Requires-Dist: pydantic>=2.10.4; extra == 'dev'
-Requires-Dist: pytest-asyncio>=0.21.1; extra == 'dev'
-Requires-Dist: pytest-cov; extra == 'dev'
-Requires-Dist: pytest>=7.4.0; extra == 'dev'
-Requires-Dist: pyyaml>=6.0.2; extra == 'dev'
-Requires-Dist: ruff>=0.8.4; extra == 'dev'
-Requires-Dist: tomli>=2.2.1; extra == 'dev'
-Provides-Extra: openai
-Requires-Dist: openai>=1.58.1; extra == 'openai'
 Description-Content-Type: text/markdown
 
 <p align="center">

{fast_agent_mcp-0.2.55 → fast_agent_mcp-0.2.57}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "fast-agent-mcp"
-version = "0.2.55"
+version = "0.2.57"
 description = "Define, Prompt and Test MCP enabled Agents and Workflows"
 readme = "README.md"
 license = { file = "LICENSE" }
@@ -23,8 +23,8 @@ dependencies = [
     "pyyaml>=6.0.2",
     "rich>=14.1.0",
     "typer>=0.15.1",
-    "anthropic>=0.59.0",
-    "openai>=1.97.1",
+    "anthropic>=0.63.0",
+    "openai>=1.99.9",
     "azure-identity>=1.14.0",
     "boto3>=1.35.0",
     "prompt-toolkit>=3.0.51",
@@ -41,10 +41,6 @@ dependencies = [
     "pyperclip>=1.9.0",
 ]
 
-[project.optional-dependencies]
-openai = [
-    "openai>=1.58.1",
-]
 # For Azure OpenAI with DefaultAzureCredential support, install with: pip install fast-agent-mcp[azure]
 azure = [
     "azure-identity>=1.14.0"

{fast_agent_mcp-0.2.55 → fast_agent_mcp-0.2.57}/src/mcp_agent/agents/agent.py

@@ -10,6 +10,7 @@ from typing import TYPE_CHECKING, Any, Callable, Dict, List, Optional, TypeVar
 from mcp_agent.agents.base_agent import BaseAgent
 from mcp_agent.core.agent_types import AgentConfig
 from mcp_agent.core.interactive_prompt import InteractivePrompt
+from mcp_agent.core.request_params import RequestParams
 from mcp_agent.human_input.types import HumanInputCallback
 from mcp_agent.logging.logger import get_logger
 from mcp_agent.mcp.interfaces import AugmentedLLMProtocol
@@ -51,13 +52,19 @@ class Agent(BaseAgent):
             **kwargs,
         )
 
-    async def prompt(self, default_prompt: str = "", agent_name: Optional[str] = None) -> str:
+    async def prompt(
+        self, 
+        default_prompt: str = "", 
+        agent_name: Optional[str] = None,
+        request_params: RequestParams | None = None
+    ) -> str:
         """
         Start an interactive prompt session with this agent.
 
         Args:
             default: Default message to use when user presses enter
             agent_name: Ignored for single agents, included for API compatibility
+            request_params: Optional request parameters
 
         Returns:
             The result of the interactive session
@@ -66,14 +73,14 @@ class Agent(BaseAgent):
         agent_name_str = str(self.name)
 
         # Create agent_types dictionary with just this agent
-        agent_types = {agent_name_str: self.agent_type.value}
+        agent_types = {agent_name_str: self.agent_type}
 
         # Create the interactive prompt
         prompt = InteractivePrompt(agent_types=agent_types)
 
         # Define wrapper for send function
         async def send_wrapper(message, agent_name):
-            return await self.send(message)
+            return await self.send(message, request_params)
 
         # Start the prompt loop with just this agent
         return await prompt.prompt_loop(

{fast_agent_mcp-0.2.55 → fast_agent_mcp-0.2.57}/src/mcp_agent/agents/base_agent.py

@@ -208,7 +208,11 @@ class BaseAgent(MCPAggregator, AgentProtocol):
         result: PromptMessageMultipart = await self.generate([Prompt.user(message)], request_params)
         return result.first_text()
 
-    async def send(self, message: Union[str, PromptMessage, PromptMessageMultipart]) -> str:
+    async def send(
+        self, 
+        message: Union[str, PromptMessage, PromptMessageMultipart],
+        request_params: RequestParams | None = None
+    ) -> str:
         """
         Send a message to the agent and get a response.
 
@@ -217,6 +221,7 @@ class BaseAgent(MCPAggregator, AgentProtocol):
                 - String: Converted to a user PromptMessageMultipart
                 - PromptMessage: Converted to PromptMessageMultipart
                 - PromptMessageMultipart: Used directly
+                - request_params: Optional request parameters
 
         Returns:
             The agent's response as a string
@@ -225,7 +230,7 @@ class BaseAgent(MCPAggregator, AgentProtocol):
         prompt = self._normalize_message_input(message)
 
         # Use the LLM to generate a response
-        response = await self.generate([prompt], None)
+        response = await self.generate([prompt], request_params)
         return response.all_text()
 
     def _normalize_message_input(
@@ -364,12 +369,15 @@ class BaseAgent(MCPAggregator, AgentProtocol):
         if self.config.tools is not None:
             filtered_tools = []
             for tool in result.tools:
-                # Extract server name from tool name (e.g., "mathematics-add" -> "mathematics")
-                if "-" in tool.name:
-                    server_name = tool.name.split("-", 1)[0]
+                # Extract server name from tool name, handling server names with hyphens
+                server_name = None
+                for configured_server in self.config.tools.keys():
+                    if tool.name.startswith(f"{configured_server}-"):
+                        server_name = configured_server
+                        break
 
-                    # Check if this server has tool filters
-                    if server_name in self.config.tools:
+                # Check if this server has tool filters
+                if server_name and server_name in self.config.tools:
                         # Check if tool matches any pattern for this server
                         for pattern in self.config.tools[server_name]:
                             if self._matches_pattern(tool.name, pattern, server_name):

{fast_agent_mcp-0.2.55 → fast_agent_mcp-0.2.57}/src/mcp_agent/cli/commands/go.py

@@ -121,9 +121,9 @@ async def _run_agent(
                     print(response)
                 elif prompt_file:
                     prompt = load_prompt_multipart(Path(prompt_file))
-                    response = await agent.generate(prompt)
-                    # Print the response text and exit
-                    print(response.last_text())
+                    response = await agent.agent.generate(prompt)
+                    print(f"\nLoaded {len(prompt)} messages from prompt file '{prompt_file}'")
+                    await agent.interactive()
                 else:
                     await agent.interactive()
 

{fast_agent_mcp-0.2.55 → fast_agent_mcp-0.2.57}/src/mcp_agent/core/agent_app.py

@@ -11,6 +11,7 @@ from rich import print as rich_print
 from mcp_agent.agents.agent import Agent
 from mcp_agent.core.agent_types import AgentType
 from mcp_agent.core.interactive_prompt import InteractivePrompt
+from mcp_agent.core.request_params import RequestParams
 from mcp_agent.mcp.prompt_message_multipart import PromptMessageMultipart
 from mcp_agent.progress_display import progress_display
 
@@ -53,6 +54,7 @@ class AgentApp:
         message: Union[str, PromptMessage, PromptMessageMultipart] | None = None,
         agent_name: str | None = None,
         default_prompt: str = "",
+        request_params: RequestParams | None = None,
     ) -> str:
         """
         Make the object callable to send messages or start interactive prompt.
@@ -65,19 +67,21 @@ class AgentApp:
                 - PromptMessageMultipart: Used directly
             agent_name: Optional name of the agent to send to (defaults to first agent)
             default_prompt: Default message to use in interactive prompt mode
+            request_params: Optional request parameters including MCP metadata
 
         Returns:
             The agent's response as a string or the result of the interactive session
         """
         if message:
-            return await self._agent(agent_name).send(message)
+            return await self._agent(agent_name).send(message, request_params)
 
-        return await self.interactive(agent_name=agent_name, default_prompt=default_prompt)
+        return await self.interactive(agent_name=agent_name, default_prompt=default_prompt, request_params=request_params)
 
     async def send(
         self,
         message: Union[str, PromptMessage, PromptMessageMultipart],
         agent_name: Optional[str] = None,
+        request_params: RequestParams | None = None,
     ) -> str:
         """
         Send a message to the specified agent (or to all agents).
@@ -88,11 +92,12 @@ class AgentApp:
                 - PromptMessage: Converted to PromptMessageMultipart
                 - PromptMessageMultipart: Used directly
             agent_name: Optional name of the agent to send to
+            request_params: Optional request parameters including MCP metadata
 
         Returns:
             The agent's response as a string
         """
-        return await self._agent(agent_name).send(message)
+        return await self._agent(agent_name).send(message, request_params)
 
     def _agent(self, agent_name: str | None) -> Agent:
         if agent_name:
@@ -233,17 +238,23 @@ class AgentApp:
         )
 
     @deprecated
-    async def prompt(self, agent_name: str | None = None, default_prompt: str = "") -> str:
+    async def prompt(
+        self, 
+        agent_name: str | None = None, 
+        default_prompt: str = "",
+        request_params: RequestParams | None = None
+    ) -> str:
         """
         Deprecated - use interactive() instead.
         """
-        return await self.interactive(agent_name=agent_name, default_prompt=default_prompt)
+        return await self.interactive(agent_name=agent_name, default_prompt=default_prompt, request_params=request_params)
 
     async def interactive(
         self,
         agent_name: str | None = None,
         default_prompt: str = "",
         pretty_print_parallel: bool = False,
+        request_params: RequestParams | None = None,
     ) -> str:
         """
         Interactive prompt for sending messages with advanced features.
@@ -252,6 +263,7 @@ class AgentApp:
             agent_name: Optional target agent name (uses default if not specified)
             default: Default message to use when user presses enter
             pretty_print_parallel: Enable clean parallel results display for parallel agents
+            request_params: Optional request parameters including MCP metadata
 
         Returns:
             The result of the interactive session
@@ -285,7 +297,7 @@ class AgentApp:
 
         # Define the wrapper for send function
         async def send_wrapper(message, agent_name):
-            result = await self.send(message, agent_name)
+            result = await self.send(message, agent_name, request_params)
 
             # Show parallel results if enabled and this is a parallel agent
             if pretty_print_parallel:

{fast_agent_mcp-0.2.55 → fast_agent_mcp-0.2.57}/src/mcp_agent/core/enhanced_prompt.py

@@ -428,9 +428,14 @@ def create_keybindings(on_toggle_multiline=None, app=None, agent_provider=None,
         """Enter: accept input when not in multiline mode."""
         event.current_buffer.validate_and_handle()
 
+    @kb.add("c-j", filter=Condition(lambda: not in_multiline_mode))
+    def _(event) -> None:
+        """Ctrl+J: Insert newline when in normal mode."""
+        event.current_buffer.insert_text("\n")
+
     @kb.add("c-m", filter=Condition(lambda: in_multiline_mode))
     def _(event) -> None:
-        """Enter: insert newline when in multiline mode."""
+        """Enter: Insert newline when in multiline mode."""
         event.current_buffer.insert_text("\n")
 
     # Use c-j (Ctrl+J) as an alternative to represent Ctrl+Enter in multiline mode
@@ -581,13 +586,15 @@ async def get_enhanced_input(
 
         shortcuts = [
             ("Ctrl+T", toggle_text),
+            ("Ctrl+J", "Newline" if not in_multiline_mode else None),
             ("Ctrl+E", "External"),
             ("Ctrl+Y", "Copy"),
             ("Ctrl+L", "Clear"),
             ("↑/↓", "History"),
+            ("EXIT", "Exit")
         ]
 
-        newline = "Ctrl+<Enter>:Submit" if in_multiline_mode else "<Enter>:Submit"
+        newline = "Ctrl+J:Submit" if in_multiline_mode else "<Enter>:Submit"
 
         # Only show relevant shortcuts based on mode
         shortcuts = [(k, v) for k, v in shortcuts if v]
@@ -669,6 +676,8 @@ async def get_enhanced_input(
     def pre_process_input(text):
         # Command processing
         if text and text.startswith("/"):
+            if text == "/": 
+                return ""
             cmd_parts = text[1:].strip().split(maxsplit=1)
             cmd = cmd_parts[0].lower()
 

{fast_agent_mcp-0.2.55 → fast_agent_mcp-0.2.57}/src/mcp_agent/core/fastagent.py

@@ -87,6 +87,7 @@ class FastAgent:
         ignore_unknown_args: bool = False,
         parse_cli_args: bool = True,
         quiet: bool = False,  # Add quiet parameter
+        **kwargs
     ) -> None:
         """
         Initialize the fast-agent application.
@@ -203,6 +204,7 @@ class FastAgent:
             self.app = MCPApp(
                 name=name,
                 settings=config.Settings(**self.config) if hasattr(self, "config") else None,
+                **kwargs
             )
 
             # Stop progress display immediately if quiet mode is requested

{fast_agent_mcp-0.2.55 → fast_agent_mcp-0.2.57}/src/mcp_agent/core/request_params.py

@@ -52,3 +52,8 @@ class RequestParams(CreateMessageRequestParams):
     """
     Optional dictionary of template variables for dynamic templates. Currently only works for TensorZero inference backend
     """
+
+    mcp_metadata: Dict[str, Any] | None = None
+    """
+    Metadata to pass through to MCP tool calls via the _meta field.
+    """

{fast_agent_mcp-0.2.55 → fast_agent_mcp-0.2.57}/src/mcp_agent/event_progress.py

@@ -25,6 +25,9 @@ class ProgressAction(str, Enum):
     FINISHED = "Finished"
     SHUTDOWN = "Shutdown"
     AGGREGATOR_INITIALIZED = "Running"
+    SERVER_OFFLINE = "Offline"
+    SERVER_RECONNECTING = "Reconnecting"
+    SERVER_ONLINE = "Online"
     FATAL_ERROR = "Error"
 
 

{fast_agent_mcp-0.2.55 → fast_agent_mcp-0.2.57}/src/mcp_agent/llm/augmented_llm.py

@@ -1,4 +1,5 @@
 from abc import abstractmethod
+from contextvars import ContextVar
 from typing import (
     TYPE_CHECKING,
     Any,
@@ -61,6 +62,9 @@ if TYPE_CHECKING:
 # TODO -- move this to a constant
 HUMAN_INPUT_TOOL_NAME = "__human_input__"
 
+# Context variable for storing MCP metadata
+_mcp_metadata_var: ContextVar[Dict[str, Any] | None] = ContextVar('mcp_metadata', default=None)
+
 
 def deep_merge(dict1: Dict[Any, Any], dict2: Dict[Any, Any]) -> Dict[Any, Any]:
     """
@@ -232,6 +236,11 @@ class AugmentedLLM(ContextDependent, AugmentedLLMProtocol, Generic[MessageParamT
 
         self._precall(multipart_messages)
 
+        # Store MCP metadata in context variable
+        final_request_params = self.get_request_params(request_params)
+        if final_request_params.mcp_metadata:
+            _mcp_metadata_var.set(final_request_params.mcp_metadata)
+
         assistant_response: PromptMessageMultipart = await self._apply_prompt_provider_specific(
             multipart_messages, request_params
         )
@@ -275,6 +284,12 @@ class AugmentedLLM(ContextDependent, AugmentedLLMProtocol, Generic[MessageParamT
             multipart_messages = PromptMessageMultipart.to_multipart(multipart_messages)
 
         self._precall(multipart_messages)
+        
+        # Store MCP metadata in context variable
+        final_request_params = self.get_request_params(request_params)
+        if final_request_params.mcp_metadata:
+            _mcp_metadata_var.set(final_request_params.mcp_metadata)
+            
         result, assistant_response = await self._apply_prompt_provider_specific_structured(
             multipart_messages, model, request_params
         )

{fast_agent_mcp-0.2.55 → fast_agent_mcp-0.2.57}/src/mcp_agent/llm/providers/augmented_llm_bedrock.py

@@ -86,6 +86,7 @@ class BedrockAugmentedLLM(AugmentedLLM[BedrockMessageParam, BedrockMessage]):
             r"^cohere\..*",  # Cohere models
             r"^ai21\..*",  # AI21 models
             r"^stability\..*",  # Stability AI models
+            r"^openai\..*",  # OpenAI models
         ]
 
         import re

{fast_agent_mcp-0.2.55 → fast_agent_mcp-0.2.57}/src/mcp_agent/llm/providers/augmented_llm_groq.py

@@ -49,35 +49,22 @@ class GroqAugmentedLLM(OpenAIAugmentedLLM):
         if "object" == json_mode:
             request_params.response_format = {"type": "json_object"}
 
-        # Get the full schema and extract just the properties
-        full_schema = model.model_json_schema()
-        properties = full_schema.get("properties", {})
-        required_fields = full_schema.get("required", [])
-
-        # Create a cleaner format description
-        format_description = "{\n"
-        for field_name, field_info in properties.items():
-            field_type = field_info.get("type", "string")
-            description = field_info.get("description", "")
-            format_description += f'  "{field_name}": "{field_type}"'
-            if description:
-                format_description += f"  // {description}"
-            if field_name in required_fields:
-                format_description += "  // REQUIRED"
-            format_description += "\n"
-        format_description += "}"
-
-        multipart_messages[-1].add_text(
-            f"""YOU MUST RESPOND WITH A JSON OBJECT IN EXACTLY THIS FORMAT:
-            {format_description}
-
-            IMPORTANT RULES:
-            - Respond ONLY with the JSON object, no other text
-            - Do NOT include "properties" or "schema" wrappers
-            - Do NOT use code fences or markdown
-            - The response must be valid JSON that matches the format above
-            - All required fields must be included"""
-        )
+            # Create a cleaner format description from full schema
+            full_schema = model.model_json_schema()
+            format_description = self._schema_to_json_object(
+                full_schema, full_schema.get("$defs")
+            )
+
+            multipart_messages[-1].add_text(
+                f"""YOU MUST RESPOND WITH A JSON OBJECT IN EXACTLY THIS FORMAT:
+{format_description}
+
+IMPORTANT RULES:
+- Respond ONLY with the JSON object, no other text
+- Do NOT include "properties" or "schema" wrappers
+- Do NOT use code fences or markdown
+- The response must be valid JSON that matches the format above
+- All required fields must be included""")
 
         result: PromptMessageMultipart = await self._apply_prompt_provider_specific(
             multipart_messages, request_params
@@ -101,3 +88,45 @@ class GroqAugmentedLLM(OpenAIAugmentedLLM):
             base_url = self.context.config.groq.base_url
 
         return base_url if base_url else GROQ_BASE_URL
+
+    def _schema_to_json_object(
+        self, schema: dict, defs: dict | None = None, visited: set | None = None
+    ) -> str:
+        visited = visited or set()
+
+        if id(schema) in visited:
+            return '"<recursive>"'
+        visited.add(id(schema))
+
+        if "$ref" in schema:
+            ref = schema.get("$ref", "")
+            if ref.startswith("#/$defs/"):
+                target = ref.split("/")[-1]
+                if defs and target in defs:
+                    return self._schema_to_json_object(defs[target], defs, visited)
+            return f'"<ref:{ref}>"'
+
+        schema_type = schema.get("type")
+        description = schema.get("description", "")
+        required = schema.get("required", [])
+
+        if schema_type == "object":
+            props = schema.get("properties", {})
+            result = "{\n"
+            for prop_name, prop_schema in props.items():
+                is_required = prop_name in required
+                prop_str = self._schema_to_json_object(prop_schema, defs, visited)
+                if is_required:
+                    prop_str += " // REQUIRED"
+                result += f'  "{prop_name}": {prop_str},\n'
+            result += "}"
+            return result
+        elif schema_type == "array":
+            items = schema.get("items", {})
+            items_str = self._schema_to_json_object(items, defs, visited)
+            return f"[{items_str}]"
+        elif schema_type:
+            comment = f" // {description}" if description else ""
+            return f'"{schema_type}"' + comment
+
+        return '"<unknown>"'

{fast_agent_mcp-0.2.55 → fast_agent_mcp-0.2.57}/src/mcp_agent/llm/providers/augmented_llm_openai.py

@@ -171,7 +171,6 @@ class OpenAIAugmentedLLM(AugmentedLLM[ChatCompletionMessageParam, ChatCompletion
     async def _process_stream_manual(self, stream, model: str):
         """Manual stream processing for providers like Ollama that may not work with ChatCompletionStreamState."""
         from openai.types.chat import ChatCompletionMessageToolCall
-        from openai.types.chat.chat_completion_message_tool_call import Function
 
         # Track estimated output tokens by counting text chunks
         estimated_tokens = 0
@@ -249,10 +248,10 @@ class OpenAIAugmentedLLM(AugmentedLLM[ChatCompletionMessageParam, ChatCompletion
                         ChatCompletionMessageToolCall(
                             id=tool_call_data["id"],
                             type=tool_call_data["type"],
-                            function=Function(
-                                name=tool_call_data["function"]["name"],
-                                arguments=tool_call_data["function"]["arguments"],
-                            ),
+                            function={
+                                "name": tool_call_data["function"]["name"],
+                                "arguments": tool_call_data["function"]["arguments"],
+                            },
                         )
                     )
 

{fast_agent_mcp-0.2.55 → fast_agent_mcp-0.2.57}/src/mcp_agent/mcp/mcp_agent_client_session.py

@@ -14,8 +14,17 @@ from mcp.shared.session import (
     SendRequestT,
 )
 from mcp.types import (
+    CallToolRequest,
+    CallToolRequestParams,
+    CallToolResult,
+    GetPromptRequest,
+    GetPromptRequestParams,
+    GetPromptResult,
     Implementation,
     ListRootsResult,
+    ReadResourceRequest,
+    ReadResourceRequestParams,
+    ReadResourceResult,
     Root,
     ToolListChangedNotification,
 )
@@ -180,8 +189,17 @@ class MCPAgentClientSession(ClientSession, ContextDependent):
             )
             return result
         except Exception as e:
-            logger.error(f"send_request failed: {str(e)}")
-            raise
+            # Handle connection errors cleanly
+            from anyio import ClosedResourceError
+            
+            if isinstance(e, ClosedResourceError):
+                # Show clean offline message and convert to ConnectionError
+                from mcp_agent import console
+                console.console.print(f"[dim red]MCP server {self.session_server_name} offline[/dim red]")
+                raise ConnectionError(f"MCP server {self.session_server_name} offline") from e
+            else:
+                logger.error(f"send_request failed: {str(e)}")
+                raise
 
     async def _received_notification(self, notification: ServerNotification) -> None:
         """
@@ -226,3 +244,88 @@ class MCPAgentClientSession(ClientSession, ContextDependent):
             await self._tool_list_changed_callback(server_name)
         except Exception as e:
             logger.error(f"Error in tool list changed callback: {e}")
+
+    async def call_tool(
+        self, 
+        name: str, 
+        arguments: dict | None = None, 
+        _meta: dict | None = None,
+        **kwargs
+    ) -> CallToolResult:
+        """Call a tool with optional metadata support."""
+        if _meta:
+            from mcp.types import RequestParams
+            
+            # Safe merge - preserve existing meta fields like progressToken
+            existing_meta = kwargs.get('meta')
+            if existing_meta:
+                meta_dict = existing_meta.model_dump() if hasattr(existing_meta, 'model_dump') else {}
+                meta_dict.update(_meta)
+                meta_obj = RequestParams.Meta(**meta_dict)
+            else:
+                meta_obj = RequestParams.Meta(**_meta)
+                
+            # Create CallToolRequestParams without meta, then add _meta via model_dump
+            params = CallToolRequestParams(name=name, arguments=arguments)
+            params_dict = params.model_dump(by_alias=True)
+            params_dict["_meta"] = meta_obj.model_dump()
+            
+            # Create request with proper types
+            request = CallToolRequest(
+                method="tools/call",
+                params=CallToolRequestParams.model_validate(params_dict)
+            )
+            
+            return await self.send_request(request, CallToolResult)
+        else:
+            return await super().call_tool(name, arguments, **kwargs)
+
+    async def read_resource(self, uri: str, _meta: dict | None = None, **kwargs) -> ReadResourceResult:
+        """Read a resource with optional metadata support."""
+        if _meta:
+            from mcp.types import RequestParams
+            
+            # Safe merge - preserve existing meta fields like progressToken
+            existing_meta = kwargs.get('meta')
+            if existing_meta:
+                meta_dict = existing_meta.model_dump() if hasattr(existing_meta, 'model_dump') else {}
+                meta_dict.update(_meta)
+                meta_obj = RequestParams.Meta(**meta_dict)
+            else:
+                meta_obj = RequestParams.Meta(**_meta)
+                
+            request = ReadResourceRequest(
+                method="resources/read",
+                params=ReadResourceRequestParams(uri=uri, meta=meta_obj)
+            )
+            return await self.send_request(request, ReadResourceResult)
+        else:
+            return await super().read_resource(uri, **kwargs)
+
+    async def get_prompt(
+        self, 
+        name: str, 
+        arguments: dict | None = None, 
+        _meta: dict | None = None,
+        **kwargs
+    ) -> GetPromptResult:
+        """Get a prompt with optional metadata support."""
+        if _meta:
+            from mcp.types import RequestParams
+            
+            # Safe merge - preserve existing meta fields like progressToken
+            existing_meta = kwargs.get('meta')
+            if existing_meta:
+                meta_dict = existing_meta.model_dump() if hasattr(existing_meta, 'model_dump') else {}
+                meta_dict.update(_meta)
+                meta_obj = RequestParams.Meta(**meta_dict)
+            else:
+                meta_obj = RequestParams.Meta(**_meta)
+                
+            request = GetPromptRequest(
+                method="prompts/get",
+                params=GetPromptRequestParams(name=name, arguments=arguments, meta=meta_obj)
+            )
+            return await self.send_request(request, GetPromptResult)
+        else:
+            return await super().get_prompt(name, arguments, **kwargs)