Model Context Protocol (MCP) support with new use case (#42)

* initial mcp

* food ordering with mcp

* prompt eng

* splitting out goals and updating docs

* a diff so I can get tests from codex

* a diff so I can get tests from codex

* oops, missing files

* tests, file formatting

* readme and setup updates

* setup.md link fixes

* readme change

* readme change

* readme change

* stripe food setup script

* single agent mode default

* prompt engineering for better multi agent performance

* performance should be greatly improved

* Update goals/finance.py

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Update activities/tool_activities.py

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* co-pilot PR suggested this change, and now fixed it

* stronger wording around json format response

* formatting

* moved docs to dir

* moved image assets under docs

* cleanup env example, stripe guidance

* cleanup

---------

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

tests/workflowtests/agent_goal_workflow_test.py

@@ -1,9 +1,11 @@
 import concurrent.futures
 import uuid
 from contextlib import contextmanager
+from typing import Any, Dict, List, Optional, Sequence
 
 from temporalio import activity
 from temporalio.client import Client, WorkflowExecutionStatus
+from temporalio.common import RawValue
 from temporalio.worker import Worker
 
 from api.main import get_initial_agent_goal
@@ -16,6 +18,7 @@ from models.data_types import (
     ValidationInput,
     ValidationResult,
 )
+from models.tool_definitions import MCPServerDefinition
 from workflows.agent_goal_workflow import AgentGoalWorkflow
 
 
@@ -53,6 +56,23 @@ async def test_flight_booking(client: Client):
         async def mock_agent_toolPlanner(input: ToolPromptInput) -> dict:
             return {"next": "done", "response": "Test response from LLM"}
 
+        @activity.defn(name="mcp_list_tools")
+        async def mock_mcp_list_tools(
+            server_definition: MCPServerDefinition,
+            include_tools: Optional[List[str]] = None,
+        ) -> Dict[str, Any]:
+            return {"success": True, "tools": {}, "server_name": "test"}
+
+        @activity.defn(name="mcp_tool_activity")
+        async def mock_mcp_tool_activity(
+            tool_name: str, tool_args: Dict[str, Any]
+        ) -> Dict[str, Any]:
+            return {"success": True, "result": "Mock MCP tool result"}
+
+        @activity.defn(name="dynamic_tool_activity", dynamic=True)
+        async def mock_dynamic_tool_activity(args: Sequence[RawValue]) -> dict:
+            return {"success": True, "result": "Mock dynamic tool result"}
+
         with concurrent.futures.ThreadPoolExecutor(
             max_workers=100
         ) as activity_executor:
@@ -64,6 +84,9 @@ async def test_flight_booking(client: Client):
                     mock_get_wf_env_vars,
                     mock_agent_validatePrompt,
                     mock_agent_toolPlanner,
+                    mock_mcp_list_tools,
+                    mock_mcp_tool_activity,
+                    mock_dynamic_tool_activity,
                 ],
                 activity_executor=activity_executor,
             )