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

{fast_agent_mcp-0.2.57 → fast_agent_mcp-0.3.0}/.gitignore

@@ -161,7 +161,7 @@ examples/**/*.secrets.yaml
 !examples/**/*.secrets.yaml.example
 
 # Build-generated resources (copied from examples/ during build)
-src/mcp_agent/resources/examples/
+src/fast_agent/resources/
 
 # Test data files
 examples/mcp_root_test/test_data/*.png
@@ -179,8 +179,6 @@ project_contents.md
 
 # example logs
 examples/**/*.jsonl
-mcp_agent.config.yaml
-mcp_agent.secrets.yaml
 fastagent.secrets.yaml
 CLAUDE.md
 example-outputs/

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fast-agent-mcp
-Version: 0.2.57
+Version: 0.3.0
 Summary: Define, Prompt and Test MCP enabled Agents and Workflows
 Author-email: Shaun Smith <fastagent@llmindset.co.uk>
 License:                                  Apache License
@@ -208,18 +208,18 @@ License-File: LICENSE
 Classifier: License :: OSI Approved :: Apache Software License
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
-Requires-Python: >=3.13
+Requires-Python: >=3.13.7
 Requires-Dist: a2a-sdk>=0.3.0
 Requires-Dist: aiohttp>=3.11.13
-Requires-Dist: anthropic>=0.63.0
+Requires-Dist: anthropic>=0.66.0
 Requires-Dist: azure-identity>=1.14.0
 Requires-Dist: boto3>=1.35.0
 Requires-Dist: deprecated>=1.2.18
 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.99.9
+Requires-Dist: google-genai>=1.33.0
+Requires-Dist: mcp==1.14.0
+Requires-Dist: openai>=1.106.1
 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'
@@ -321,7 +321,7 @@ Here is the complete `sizer.py` Agent application, with boilerplate code:
 
 ```python
 import asyncio
-from mcp_agent.core.fastagent import FastAgent
+from fast_agent.core.fastagent import FastAgent
 
 # Create the application
 fast = FastAgent("Agent Example")

{fast_agent_mcp-0.2.57 → fast_agent_mcp-0.3.0}/README.md

@@ -83,7 +83,7 @@ Here is the complete `sizer.py` Agent application, with boilerplate code:
 
 ```python
 import asyncio
-from mcp_agent.core.fastagent import FastAgent
+from fast_agent.core.fastagent import FastAgent
 
 # Create the application
 fast = FastAgent("Agent Example")

fast_agent_mcp-0.3.0/examples/bedrock/fast-agent.config.yaml

@@ -0,0 +1,24 @@
+# Example minimal fast-agent.config.yaml for Bedrock
+
+# List of supported models: https://docs.aws.amazon.com/bedrock/latest/userguide/models-supported.html
+# Model string format: bedrock.<model_id>.<reasoning_effort>
+# Examples:
+#   bedrock.amazon.nova-lite-v1:0           # No reasoning
+#   bedrock.claude-sonnet-4-0.high          # High reasoning effort
+#   bedrock.anthropic.claude-3-7-sonnet-20250219-v1:0.medium  # Medium reasoning
+default_model: bedrock.amazon.nova-lite-v1:0
+
+# Bedrock uses the AWS credentials provider chain to authenticate.
+# This can be accomplished with aws sso login on local machines,
+# or by IAM roles within AWS.
+# see https://docs.aws.amazon.com/res/latest/ug/sso-idc.html
+bedrock:
+  region: "us-east-1" # required
+  profile: "default"  # optional, defaults to "default" - only needed if you have multiple profiles. 
+                      # Only needed on local machines, not on AWS.
+  
+  # Default reasoning effort for all Bedrock models (can be overridden in model string)
+  # Options: "minimal" (off), "low" (512 tokens), "medium" (1024 tokens), "high" (2048 tokens)
+  # Note: Only Claude 4, Claude 3.7 Sonnet, and DeepSeek-R1 support reasoning
+  # Other models will automatically fallback to no reasoning if unsupported
+  reasoning_effort: "minimal"  # Default: disabled

{fast_agent_mcp-0.2.57 → fast_agent_mcp-0.3.0}/examples/custom-agents/agent.py

@@ -1,13 +1,13 @@
 import asyncio
 
-from mcp_agent.agents.base_agent import BaseAgent
-from mcp_agent.core.fastagent import FastAgent
+from fast_agent.agents.mcp_agent import McpAgent
+from fast_agent.core.fastagent import FastAgent
 
 # Create the application
 fast = FastAgent("fast-agent example")
 
 
-class MyAgent(BaseAgent):
+class MyAgent(McpAgent):
     async def initialize(self):
         await super().initialize()
         print("it's a-me!...Mario!")

{fast_agent_mcp-0.2.57/src/mcp_agent/resources → fast_agent_mcp-0.3.0}/examples/data-analysis/analysis-campaign.py

@@ -1,7 +1,7 @@
 import asyncio
 
-from mcp_agent.core.fastagent import FastAgent
-from mcp_agent.llm.augmented_llm import RequestParams
+from fast_agent.core.fastagent import FastAgent
+from fast_agent.llm.fastagent_llm import RequestParams
 
 # Create the application
 fast = FastAgent("Data Analysis & Campaign Generator")
@@ -179,8 +179,9 @@ async def main() -> None:
     )
 
     async with fast.run() as agent:
-        await agent.research_campaign_creator.prompt(
-            default_prompt="Analyze the CSV file in the current directory and create a comprehensive multi-lingual social media campaign based on the findings. Save all campaign elements as separate files."
+        await agent.interactive(
+            "research_campaign_creator",
+            default_prompt="Analyze the CSV file in the current directory and create a comprehensive multi-lingual social media campaign based on the findings. Save all campaign elements as separate files.",
         )
 
 

{fast_agent_mcp-0.2.57/src/mcp_agent/resources → fast_agent_mcp-0.3.0}/examples/data-analysis/analysis.py

@@ -1,6 +1,6 @@
 import asyncio
 
-from mcp_agent.core.fastagent import FastAgent
+from fast_agent.core.fastagent import FastAgent
 
 # Create the application
 fast = FastAgent("Data Analysis (Roots)")

{fast_agent_mcp-0.2.57 → fast_agent_mcp-0.3.0}/examples/mcp/elicitations/elicitation_forms_server.py

@@ -100,11 +100,25 @@ async def product_review() -> ReadResourceResult:
             },
         )
         review_text: str = Field(
-            description="Tell us about your experience", min_length=10, max_length=1000
+            description="Tell us about your experience",
+            default="""Great product!
+Here's what I loved:
+
+- Excellent build quality
+- Fast shipping
+- Works as advertised
+
+One minor issue:
+- Instructions could be clearer
+
+Overall, highly recommended!""",
+            min_length=10,
+            max_length=1000
         )
 
     result = await mcp.get_context().elicit(
-        "Share your product review - Help others make informed decisions!", schema=ProductReview
+        "Share your product review - Help others make informed decisions!",
+        schema=ProductReview,
     )
 
     match result:
@@ -140,6 +154,7 @@ async def account_settings() -> ReadResourceResult:
         email_notifications: bool = Field(True, description="Receive email notifications?")
         marketing_emails: bool = Field(False, description="Subscribe to marketing emails?")
         theme: str = Field(
+            "dark",
             description="Choose your preferred theme",
             json_schema_extra={
                 "enum": ["light", "dark", "auto"],
@@ -147,7 +162,9 @@ async def account_settings() -> ReadResourceResult:
             },
         )
         privacy_public: bool = Field(False, description="Make your profile public?")
-        items_per_page: int = Field(description="Items to show per page (10-100)", ge=10, le=100)
+        items_per_page: int = Field(
+            25, description="Items to show per page (10-100)", ge=10, le=100
+        )
 
     result = await mcp.get_context().elicit("Update your account settings", schema=AccountSettings)
 
@@ -182,7 +199,11 @@ async def service_appointment() -> ReadResourceResult:
 
     class ServiceAppointment(BaseModel):
         customer_name: str = Field(description="Your full name", min_length=2, max_length=50)
+        phone_number: str = Field(
+            "555-", description="Contact phone number", min_length=10, max_length=20
+        )
         vehicle_type: str = Field(
+            default="sedan",
             description="What type of vehicle do you have?",
             json_schema_extra={
                 "enum": ["sedan", "suv", "truck", "motorcycle", "other"],
@@ -205,6 +226,7 @@ async def service_appointment() -> ReadResourceResult:
             lines = [
                 "🔧 Service Appointment Scheduled!",
                 f"👤 Customer: {data.customer_name}",
+                f"📞 Phone: {data.phone_number}",
                 f"🚗 Vehicle: {data.vehicle_type.title()}",
                 f"🚙 Loaner needed: {'Yes' if data.needs_loaner else 'No'}",
                 f"📅 Appointment: {data.appointment_time}",

{fast_agent_mcp-0.2.57 → fast_agent_mcp-0.3.0}/examples/mcp/elicitations/forms_demo.py

@@ -13,8 +13,8 @@ import asyncio
 from rich.console import Console
 from rich.panel import Panel
 
-from mcp_agent.core.fastagent import FastAgent
-from mcp_agent.mcp.helpers.content_helpers import get_resource_text
+from fast_agent.core.fastagent import FastAgent
+from fast_agent.mcp.helpers.content_helpers import get_resource_text
 
 fast = FastAgent("Elicitation Forms Demo", quiet=True)
 console = Console()
@@ -38,7 +38,7 @@ async def main():
         console.print(
             "[dim]Demonstrates: string validation, email format, URL format, date format[/dim]"
         )
-        result = await agent.get_resource("elicitation://event-registration")
+        result = await agent["forms-demo"].get_resource("elicitation://event-registration")
 
         if result_text := get_resource_text(result):
             panel = Panel(

{fast_agent_mcp-0.2.57 → fast_agent_mcp-0.3.0}/examples/mcp/elicitations/game_character.py

@@ -14,8 +14,8 @@ from game_character_handler import game_character_elicitation_handler
 from rich.console import Console
 from rich.panel import Panel
 
-from mcp_agent.core.fastagent import FastAgent
-from mcp_agent.mcp.helpers.content_helpers import get_resource_text
+from fast_agent.core.fastagent import FastAgent
+from fast_agent.mcp.helpers.content_helpers import get_resource_text
 
 fast = FastAgent("Game Character Creator", quiet=True)
 console = Console()

{fast_agent_mcp-0.2.57/src/mcp_agent/resources → fast_agent_mcp-0.3.0}/examples/mcp/elicitations/game_character_handler.py

@@ -17,7 +17,7 @@ from rich.progress import BarColumn, Progress, TextColumn
 from rich.prompt import Confirm
 from rich.table import Table
 
-from mcp_agent.logging.logger import get_logger
+from fast_agent.core.logging.logger import get_logger
 
 if TYPE_CHECKING:
     from mcp import ClientSession

{fast_agent_mcp-0.2.57 → fast_agent_mcp-0.3.0}/examples/mcp/elicitations/tool_call.py

@@ -1,6 +1,6 @@
 import asyncio
 
-from mcp_agent.core.fastagent import FastAgent
+from fast_agent.core.fastagent import FastAgent
 
 # Create the application
 fast = FastAgent("fast-agent example")

{fast_agent_mcp-0.2.57 → fast_agent_mcp-0.3.0}/examples/mcp/mcp-filtering/test_mcp_filtering.py

@@ -1,16 +1,13 @@
 import asyncio
 import sys
 
-from mcp_agent.core.fastagent import FastAgent, PromptExitError
+from fast_agent.core.fastagent import FastAgent, PromptExitError
+
+fast_agent = FastAgent(name="MCP Filtering Demo", parse_cli_args=False, quiet=False)
 
-fast_agent = FastAgent(
-    name="MCP Filtering Demo",
-    parse_cli_args=False,
-    quiet=False
-)
 
 @fast_agent.agent(
-    name="filtered_agent",    
+    name="filtered_agent",
     model="gpt-4o-mini",
     instruction="You are a creative writer with filtered access to tools, resources, and prompts.",
     servers=["creativity"],
@@ -19,75 +16,82 @@ fast_agent = FastAgent(
     # Resource filtering: only writing resources (not coding resources)
     resources={"creativity": ["resource://writing/*"]},
     # Prompt filtering: only writing prompts (not coding prompts)
-    prompts={"creativity": ["writing_*"]}
+    prompts={"creativity": ["writing_*"]},
 )
 async def filtered_agent():
     return "Filtered agent ready"
 
+
 @fast_agent.agent(
     name="unfiltered_agent",
-    model="gpt-4o-mini", 
+    model="gpt-4o-mini",
     instruction="You are a creative writer with access to all tools, resources, and prompts.",
-    servers=["creativity"]
+    servers=["creativity"],
     # No filtering - gets everything
 )
 async def unfiltered_agent():
     return "Unfiltered agent ready"
 
+
 async def main():
     try:
         async with fast_agent.run() as agent:
             try:
                 print("🎯 MCP Filtering Demo")
                 print("=" * 50)
-                
+
                 # Show filtered agent capabilities
                 print("\n📦 FILTERED AGENT:")
                 filtered = agent._agent("filtered_agent")
-                
+
                 tools = await filtered.list_tools()
-                print(f"✅ Available tools ({len(tools.tools)}): {[tool.name for tool in tools.tools]}")
-                
+                print(
+                    f"✅ Available tools ({len(tools.tools)}): {[tool.name for tool in tools.tools]}"
+                )
+
                 resources = await filtered.list_resources()
                 resource_list = resources.get("creativity", [])
                 print(f"📚 Available resources ({len(resource_list)}): {resource_list}")
-                
+
                 prompts = await filtered.list_prompts()
                 prompt_list = prompts.get("creativity", [])
                 prompt_names = [p.name for p in prompt_list]
                 print(f"💬 Available prompts ({len(prompt_names)}): {prompt_names}")
-                
+
                 # Show unfiltered agent capabilities
                 print("\n🌐 UNFILTERED AGENT:")
                 unfiltered = agent._agent("unfiltered_agent")
-                
+
                 tools = await unfiltered.list_tools()
-                print(f"✅ Available tools ({len(tools.tools)}): {[tool.name for tool in tools.tools]}")
-                
+                print(
+                    f"✅ Available tools ({len(tools.tools)}): {[tool.name for tool in tools.tools]}"
+                )
+
                 resources = await unfiltered.list_resources()
                 resource_list = resources.get("creativity", [])
                 print(f"📚 Available resources ({len(resource_list)}): {resource_list}")
-                
+
                 prompts = await unfiltered.list_prompts()
                 prompt_list = prompts.get("creativity", [])
                 prompt_names = [p.name for p in prompt_list]
                 print(f"💬 Available prompts ({len(prompt_names)}): {prompt_names}")
-                
+
                 print("\n" + "=" * 50)
                 print("🚀 Starting interactive session with filtered agent...")
                 print("Type 'exit' to quit")
-                
+
                 await agent.interactive(agent_name="filtered_agent")
 
             except PromptExitError:
                 print("👋 Goodbye!")
-                
+
     except KeyboardInterrupt:
         print("\nExiting...")
         sys.exit(0)
     except Exception as e:
         print(f"Error: {e}")
         import traceback
+
         traceback.print_exc()
         sys.exit(1)
 

{fast_agent_mcp-0.2.57 → fast_agent_mcp-0.3.0}/examples/mcp/state-transfer/agent_one.py

@@ -1,6 +1,6 @@
 import asyncio
 
-from mcp_agent.core.fastagent import FastAgent
+from fast_agent.core.fastagent import FastAgent
 
 # Create the application
 fast = FastAgent("fast-agent agent_one (mcp server)")

{fast_agent_mcp-0.2.57/src/mcp_agent/resources → fast_agent_mcp-0.3.0}/examples/mcp/state-transfer/agent_two.py

@@ -1,6 +1,6 @@
 import asyncio
 
-from mcp_agent.core.fastagent import FastAgent
+from fast_agent.core.fastagent import FastAgent
 
 # Create the application
 fast = FastAgent("fast-agent agent_two (mcp client)")

{fast_agent_mcp-0.2.57 → fast_agent_mcp-0.3.0}/examples/mcp/vision-examples/example1.py

@@ -1,8 +1,8 @@
 import asyncio
 from pathlib import Path
 
-from mcp_agent.core.fastagent import FastAgent
-from mcp_agent.core.prompt import Prompt
+from fast_agent.core.fastagent import FastAgent
+from fast_agent.core.prompt import Prompt
 
 # Create the application
 fast = FastAgent("fast-agent example")

{fast_agent_mcp-0.2.57 → fast_agent_mcp-0.3.0}/examples/mcp/vision-examples/example2.py

@@ -1,6 +1,6 @@
 import asyncio
 
-from mcp_agent.core.fastagent import FastAgent
+from fast_agent.core.fastagent import FastAgent
 
 # Create the application
 fast = FastAgent("fast-agent example")

{fast_agent_mcp-0.2.57 → fast_agent_mcp-0.3.0}/examples/mcp/vision-examples/example3.py

@@ -1,6 +1,6 @@
 import asyncio
 
-from mcp_agent.core.fastagent import FastAgent
+from fast_agent.core.fastagent import FastAgent
 
 # Create the application
 fast = FastAgent("fast-agent example")

fast_agent_mcp-0.3.0/examples/new-api/display_check.py

@@ -0,0 +1,25 @@
+import asyncio
+
+from fast_agent.agents.agent_types import AgentConfig
+from fast_agent.agents.llm_agent import LlmAgent
+from fast_agent.core import Core
+from fast_agent.llm.model_factory import ModelFactory
+from fast_agent.llm.request_params import RequestParams
+
+
+async def main():
+    core: Core = Core()
+    await core.initialize()
+    test: AgentConfig = AgentConfig("hello", model="kimi")
+    agent: LlmAgent = LlmAgent(test, context=core.context)
+    await agent.attach_llm(ModelFactory.create_factory("haiku"))
+    await agent.send("hello world, render some xml tags both inside and outside of code fences")
+    await agent.generate("write a 200 word story", RequestParams(maxTokens=50))
+    await agent.generate(
+        "repeat after me: `one, two, three, four`",
+        RequestParams(stopSequences=[" two,"]),
+    )
+
+
+if __name__ == "__main__":
+    asyncio.run(main())

fast_agent_mcp-0.3.0/examples/new-api/simple_llm.py

@@ -0,0 +1,80 @@
+import asyncio
+
+from mcp.server.fastmcp import FastMCP
+
+from fast_agent.agents.agent_types import AgentConfig
+from fast_agent.agents.tool_agent import ToolAgent
+from fast_agent.core import Core
+from fast_agent.llm.model_factory import ModelFactory
+
+# Initialize FastMCP instance for decorator-based tools
+# Set log_level to WARNING or ERROR to avoid httpx INFO logs
+mcp = FastMCP("Weather Bot", log_level="WARNING")
+
+
+# Option 1: Using @mcp.tool decorator
+@mcp.tool()
+async def check_weather(city: str) -> str:
+    """Check the weather in a given city.
+
+    Args:
+        city: The city to check the weather for
+
+    Returns:
+        Weather information for the city
+    """
+    return f"The weather in {city} is sunny."
+
+
+# Option 2: Simple function-based tool (without decorator)
+async def check_weather_function(city: str) -> str:
+    """Check the weather in a given city (function version).
+
+    Args:
+        city: The city to check the weather for
+
+    Returns:
+        Weather information for the city
+    """
+    return f"The weather in {city} is sunny."
+
+
+# Alternative: Regular (non-async) function also works
+def get_temperature(city: str) -> int:
+    """Get the temperature in a city.
+
+    Args:
+        city: The city to get temperature for
+
+    Returns:
+        Temperature in degrees Celsius
+    """
+    return 22
+
+
+async def main():
+    core: Core = Core()
+    await core.initialize()
+
+    # Create agent configuration
+    config = AgentConfig(name="weather_bot", model="haiku")
+
+    tool_agent = ToolAgent(
+        config,
+        tools=[
+            check_weather,
+            get_temperature,
+        ],
+        context=core.context,
+    )
+
+    # Attach the LLM
+    await tool_agent.attach_llm(ModelFactory.create_factory("haiku"))
+
+    # Test the agent
+    await tool_agent.send("What's the weather like in San Francisco and what's the temperature?")
+    await core.cleanup()
+
+
+if __name__ == "__main__":
+    asyncio.run(main())

fast_agent_mcp-0.3.0/examples/new-api/simple_llm_advanced.py

@@ -0,0 +1,110 @@
+import asyncio
+from typing import Any, Dict
+
+from mcp.server.fastmcp.tools.base import Tool as FastMCPTool
+
+from fast_agent.agents.agent_types import AgentConfig
+from fast_agent.agents.tool_agent import ToolAgent
+from fast_agent.core import Core
+from fast_agent.llm.model_factory import ModelFactory
+
+
+# Example 1: Simple function that will be wrapped
+async def search_web(query: str, max_results: int = 5) -> str:
+    """Search the web for information.
+
+    Args:
+        query: The search query
+        max_results: Maximum number of results to return
+
+    Returns:
+        Search results as a formatted string
+    """
+    # Mock implementation
+    return f"Found {max_results} results for '{query}': [Result 1, Result 2, ...]"
+
+
+# Example 2: Create a FastMCP Tool directly for more control
+def create_calculator_tool() -> FastMCPTool:
+    """Create a calculator tool with explicit schema."""
+
+    def calculate(operation: str, a: float, b: float) -> float:
+        """Perform a calculation."""
+        operations = {
+            "add": lambda x, y: x + y,
+            "subtract": lambda x, y: x - y,
+            "multiply": lambda x, y: x * y,
+            "divide": lambda x, y: x / y if y != 0 else float("inf"),
+        }
+
+        if operation not in operations:
+            raise ValueError(f"Unknown operation: {operation}")
+
+        return operations[operation](a, b)
+
+    # Create the tool with explicit configuration
+    return FastMCPTool.from_function(
+        fn=calculate,
+        name="calculator",
+        description="Perform basic arithmetic operations",
+        # FastMCP will still generate the schema, but we could override if needed
+    )
+
+
+# Example 3: Complex async tool with side effects
+async def send_email(to: str, subject: str, body: str) -> Dict[str, Any]:
+    """Send an email (mock implementation).
+
+    Args:
+        to: Recipient email address
+        subject: Email subject
+        body: Email body content
+
+    Returns:
+        Dictionary with send status and message ID
+    """
+    # Mock async operation
+    await asyncio.sleep(0.1)
+
+    return {
+        "status": "sent",
+        "message_id": f"msg_{hash((to, subject))}",
+        "timestamp": "2024-01-01T12:00:00Z",
+    }
+
+
+async def main():
+    core: Core = Core()
+    await core.initialize()
+
+    # Create agent configuration
+    config = AgentConfig(name="assistant", model="haiku")
+
+    # Mix different tool types
+    tools = [
+        search_web,  # Async function
+        create_calculator_tool(),  # Pre-configured FastMCP Tool
+        send_email,  # Complex async function
+    ]
+
+    # Create tool agent
+    tool_agent = ToolAgent(config, tools=tools, context=core.context)
+
+    # Attach the LLM
+    await tool_agent.attach_llm(ModelFactory.create_factory("haiku"))
+
+    # Test various tools
+    print("Testing search:")
+    await tool_agent.send("Search for information about Python FastMCP")
+
+    print("\nTesting calculator:")
+    await tool_agent.send("What is 42 multiplied by 17?")
+
+    print("\nTesting email:")
+    await tool_agent.send(
+        "Send an email to test@example.com with subject 'Hello' and body 'Test message'"
+    )
+
+
+if __name__ == "__main__":
+    asyncio.run(main())