fast-agent-mcp 0.2.9__py3-none-any.whl → 0.2.11__py3-none-any.whl

{fast_agent_mcp-0.2.9.dist-info → fast_agent_mcp-0.2.11.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fast-agent-mcp
-Version: 0.2.9
+Version: 0.2.11
 Summary: Define, Prompt and Test MCP enabled Agents and Workflows
 Author-email: Shaun Smith <fastagent@llmindset.co.uk>, Sarmad Qadri <sarmad@lastmileai.dev>
 License:                                  Apache License
@@ -209,6 +209,7 @@ Classifier: License :: OSI Approved :: Apache Software License
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
 Requires-Python: >=3.10
+Requires-Dist: a2a-types>=0.1.0
 Requires-Dist: aiohttp>=3.11.13
 Requires-Dist: anthropic>=0.49.0
 Requires-Dist: fastapi>=0.115.6
@@ -252,7 +253,7 @@ Description-Content-Type: text/markdown
 ## Overview
 
 > [!TIP]
-> Documentation site is in production here : https://fast-agent.ai. Feel free to feed back what's helpful and what's not.
+> Documentation site is in production here : https://fast-agent.ai. Feel free to feed back what's helpful and what's not. llms.txt link is here: https://fast-agent.ai/llms.txt
 
 **`fast-agent`** enables you to create and interact with sophisticated Agents and Workflows in minutes. It is the first framework with complete, end-to-end tested MCP Feature support including Sampling. Both Anthropic (Haiku, Sonnet, Opus) and OpenAI models (gpt-4o family, o1/o3 family) are supported.
 
@@ -282,10 +283,10 @@ uv pip install fast-agent-mcp       # install fast-agent!
 fast-agent setup                    # create an example agent and config files
 uv run agent.py                     # run your first agent
 uv run agent.py --model=o3-mini.low # specify a model
-fast-agent bootstrap workflow       # create "building effective agents" examples
+fast-agent quickstart workflow       # create "building effective agents" examples
 ```
 
-Other bootstrap examples include a Researcher Agent (with Evaluator-Optimizer workflow) and Data Analysis Agent (similar to the ChatGPT experience), demonstrating MCP Roots support.
+Other quickstart examples include a Researcher Agent (with Evaluator-Optimizer workflow) and Data Analysis Agent (similar to the ChatGPT experience), demonstrating MCP Roots support.
 
 > [!TIP]
 > Windows Users - there are a couple of configuration changes needed for the Filesystem and Docker MCP Servers - necessary changes are detailed within the configuration files.
@@ -341,7 +342,7 @@ Specify a model with the `--model` switch - for example `uv run sizer.py --model
 
 ### Combining Agents and using MCP Servers
 
-_To generate examples use `fast-agent bootstrap workflow`. This example can be run with `uv run workflow/chaining.py`. fast-agent looks for configuration files in the current directory before checking parent directories recursively._
+_To generate examples use `fast-agent quickstart workflow`. This example can be run with `uv run workflow/chaining.py`. fast-agent looks for configuration files in the current directory before checking parent directories recursively._
 
 Agents can be chained to build a workflow, using MCP Servers defined in the `fastagent.config.yaml` file:
 
@@ -463,7 +464,7 @@ async with fast.run() as agent:
 
 When used in a workflow, it returns the last `generator` message as the result.
 
-See the `evaluator.py` workflow example, or `fast-agent bootstrap researcher` for a more complete example.
+See the `evaluator.py` workflow example, or `fast-agent quickstart researcher` for a more complete example.
 
 ### Router
 

{fast_agent_mcp-0.2.9.dist-info → fast_agent_mcp-0.2.11.dist-info}/RECORD

@@ -1,11 +1,11 @@
 mcp_agent/__init__.py,sha256=-AIoeL4c9UAp_P4U0z-uIWTTmQWdihOis5nbQ5L_eao,1664
 mcp_agent/app.py,sha256=jBmzYM_o50g8vhlTgkkf5TGiBWNbXWViYnd0WANbpzo,10276
-mcp_agent/config.py,sha256=0GVtAMSiK1oPklHlH-3rbhjPfBx18JfEAn-W-HG5x6k,12167
+mcp_agent/config.py,sha256=z3EtltnwdEM03WevxSHusymMvHB02BN4brDsLYQ-M68,12268
 mcp_agent/console.py,sha256=Gjf2QLFumwG1Lav__c07X_kZxxEUSkzV-1_-YbAwcwo,813
 mcp_agent/context.py,sha256=pp_F1Q1jgAxGrRccSZJutn1JUxYfVue-St3S8tUyptM,7903
 mcp_agent/context_dependent.py,sha256=QXfhw3RaQCKfscEEBRGuZ3sdMWqkgShz2jJ1ivGGX1I,1455
 mcp_agent/event_progress.py,sha256=25iz0yyg-O4glMmtijcYpDdUmtUIKsCmR_8A52GgeC4,2716
-mcp_agent/mcp_server_registry.py,sha256=w0sq-5o_AVVGfwUBo0c_Ekbyjd3Tjg9bzi2r8UZry7o,9945
+mcp_agent/mcp_server_registry.py,sha256=pSD3euU-Oc2LAVenqkLU7UmutAzk6A9liYVLjCj4J70,10068
 mcp_agent/progress_display.py,sha256=GeJU9VUt6qKsFVymG688hCMVCsAygG9ifiiEb5IcbN4,361
 mcp_agent/agents/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 mcp_agent/agents/agent.py,sha256=Tn2YKw_ytx9b8jC-65WYQmrnD43kYiZsLa4sVHxn9d4,3854
@@ -20,11 +20,11 @@ mcp_agent/agents/workflow/parallel_agent.py,sha256=SgIXJx2X_MSlLOv6WXYRezwjDYjU9
 mcp_agent/agents/workflow/router_agent.py,sha256=c4MU55U6q1DRayP0sDoyxdlnKX-N0LPbRv-MFlwbwrY,11165
 mcp_agent/cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 mcp_agent/cli/__main__.py,sha256=AVZ7tQFhU_sDOGuUGJq8ujgKtcxsYJBJwHbVaaiRDlI,166
-mcp_agent/cli/main.py,sha256=PZdPJfsAJOm80vTu7j_XpMPhaDZOpqSe-ciU3YQsmA4,3149
+mcp_agent/cli/main.py,sha256=_yMv39nP5faJ8rsp-4xKofX1Mnj7rTKnhBJnC2taNJU,3241
 mcp_agent/cli/terminal.py,sha256=GRwD-RGW7saIz2IOWZn5vD6JjiArscELBThm1GTFkuI,1065
-mcp_agent/cli/commands/bootstrap.py,sha256=UiTt0fO_IpaHqFCKAW5tg7BIH04vPXf8xH0hJjPM52M,11602
 mcp_agent/cli/commands/config.py,sha256=jU2gl4d5YESrdUboh3u6mxf7CxVT-_DT_sK8Vuh3ajw,231
-mcp_agent/cli/commands/setup.py,sha256=CsmfIvKFfOhU1bOkm1cTqNseQdn3qdlfXN4BALwQ3Ik,6345
+mcp_agent/cli/commands/quickstart.py,sha256=SM3CHMzDgvTxIpKjFuX9BrS_N1vRoXNBDaO90aWx1Rk,14586
+mcp_agent/cli/commands/setup.py,sha256=YoZM5DiYj-4CaB5cOPistH8UHCTzZGnOsFhaFcqosB0,6470
 mcp_agent/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 mcp_agent/core/agent_app.py,sha256=5nQJNo8DocIRWiX4pVKAHUZF8s6HWpc-hJnfzl_1v1c,9697
 mcp_agent/core/agent_types.py,sha256=LuWslu9YI6JRnAWwh_A1ZejK72-e839wH7tf2MHxSIU,1389
@@ -62,9 +62,9 @@ mcp_agent/llm/providers/__init__.py,sha256=heVxtmuqFJOnjjxHz4bWSqTAxXoN1E8twC_gQ
 mcp_agent/llm/providers/anthropic_utils.py,sha256=vYDN5G5jKMhD2CQg8veJYab7tvvzYkDMq8M1g_hUAQg,3275
 mcp_agent/llm/providers/augmented_llm_anthropic.py,sha256=CNKpTEvWqjOteACUx_Vha0uFpPt32C17JrkSXg_allM,14445
 mcp_agent/llm/providers/augmented_llm_deepseek.py,sha256=SdYDqZZ9hM9sBvW1FSItNn_ENEKQXGNKwVHGnjqjyAA,1927
-mcp_agent/llm/providers/augmented_llm_generic.py,sha256=IIgwPYsVGwDdL2mMYsc5seY3pVFblMwmnxoI5dbxras,1524
+mcp_agent/llm/providers/augmented_llm_generic.py,sha256=v6r8mbDO69fpQnvFoy62QyQTnq2qXR2DBbn5o3pyhvg,1533
 mcp_agent/llm/providers/augmented_llm_openai.py,sha256=Wso9GVgsq8y3sqlOzTk_iQqrkCOL3LyuG07nA1PWDng,17913
-mcp_agent/llm/providers/augmented_llm_openrouter.py,sha256=AajWXFIgGEDjeEx8AWCTs3mZGTPaihdsrjEUiNAJkIM,3501
+mcp_agent/llm/providers/augmented_llm_openrouter.py,sha256=jcnbjMO2NHETOOwc3BPZUcfv8gObczpnYDRZeKlV6eY,3552
 mcp_agent/llm/providers/multipart_converter_anthropic.py,sha256=t5lHYGfFUacJldnrVtMNW-8gEMoto8Y7hJkDrnyZR-Y,16650
 mcp_agent/llm/providers/multipart_converter_openai.py,sha256=zCj0LBgd9FDG8aL_GeTrPo2ssloYnmC_Uj3ENWVUJAg,16753
 mcp_agent/llm/providers/openai_multipart.py,sha256=qKBn7d3jSabnJmVgWweVzqh8q9mBqr09fsPmP92niAQ,6899
@@ -85,11 +85,11 @@ mcp_agent/mcp/interfaces.py,sha256=vma7bbWbY3zp1RM6hMYxVO4aV6Vfaygm-nLwzK2jFKI,6
 mcp_agent/mcp/logger_textio.py,sha256=vljC1BtNTCxBAda9ExqNB-FwVNUZIuJT3h1nWmCjMws,3172
 mcp_agent/mcp/mcp_agent_client_session.py,sha256=RMYNltc2pDIzxwEJSS5589RbvPO0KWV4Y3jSyAmhKf0,4181
 mcp_agent/mcp/mcp_aggregator.py,sha256=jaWbOvb3wioECohZ47CubyxfJ5QkfNSshu1hwhZksG4,40486
-mcp_agent/mcp/mcp_connection_manager.py,sha256=AMIm2FBbIk7zHInb8X-kFSQFO5TKcoi9w8WU8nx8Ig0,13834
+mcp_agent/mcp/mcp_connection_manager.py,sha256=FGFF3DruVcHD_8J-VadrRyyrOiiq-N9-_ZzIdx4NUOA,13973
 mcp_agent/mcp/mime_utils.py,sha256=difepNR_gpb4MpMLkBRAoyhDk-AjXUHTiqKvT_VwS1o,1805
 mcp_agent/mcp/prompt_message_multipart.py,sha256=IpIndd75tAcCbJbfqjpAF0tOUUP1TQceDbWoxO5gvpo,3684
 mcp_agent/mcp/prompt_render.py,sha256=k3v4BZDThGE2gGiOYVQtA6x8WTEdOuXIEnRafANhN1U,2996
-mcp_agent/mcp/prompt_serialization.py,sha256=El12k47c9568sju6fqiaYkYySC9RVhScarHeR_QihNk,17323
+mcp_agent/mcp/prompt_serialization.py,sha256=MQY6QxnhQTiq0oBDsyRzFtX8sBiovUjzUFX78As8q60,17974
 mcp_agent/mcp/resource_utils.py,sha256=K4XY8bihmBMleRTZ2viMPiD2Y2HWxFnlgIJi6dd_PYE,6588
 mcp_agent/mcp/sampling.py,sha256=vzWrIdI1CyFSxDWO-O69TpD6RwQcCM694BqMlYPVtaw,4584
 mcp_agent/mcp/helpers/__init__.py,sha256=sKqwlUR3jSsd9PVJKjXtxHgZA1YOdzPtsSW4xVey77Q,52
@@ -98,16 +98,17 @@ mcp_agent/mcp/prompts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3h
 mcp_agent/mcp/prompts/__main__.py,sha256=gr1Tdz9fcK0EXjEuZg_BOnKUmvhYq5AH2lFZicVyNb0,237
 mcp_agent/mcp/prompts/prompt_constants.py,sha256=Q9W0t3rOXl2LHIG9wcghApUV2QZ1iICuo7SwVwHUf3c,566
 mcp_agent/mcp/prompts/prompt_helpers.py,sha256=Joqo2t09pTKDP-Wge3G-ozPEHikzjaqwV6GVk8hNR50,7534
-mcp_agent/mcp/prompts/prompt_load.py,sha256=VkcY6dD1jRCu-OB5AtSO8YwVATjEoYCkyAIGIujIHmw,5583
-mcp_agent/mcp/prompts/prompt_server.py,sha256=tXtQd4EnH86MmdAvHlXm4oOS1dWLSCW5PvoA7uU1TvA,16493
+mcp_agent/mcp/prompts/prompt_load.py,sha256=Zo0FogqWFEG5FtF1d9ZH-RWsCSSMsi5FIEQHpJD8N7M,5404
+mcp_agent/mcp/prompts/prompt_server.py,sha256=SiUR2xYfd3vEpghnYRdzz2rFEMtAbCKx2xzUXgvz1g8,18501
 mcp_agent/mcp/prompts/prompt_template.py,sha256=EejiqGkau8OizORNyKTUwUjrPof5V-hH1H_MBQoQfXw,15732
 mcp_agent/mcp_server/__init__.py,sha256=zBU51ITHIEPScd9nRafnhEddsWqXRPAAvHhkrbRI2_4,155
-mcp_agent/mcp_server/agent_server.py,sha256=LVZNML2_ysK7nVVLDou8pQuQWiEsMFZLryn_KihmkUQ,6431
+mcp_agent/mcp_server/agent_server.py,sha256=Nzws9h-itEqx9ml87Wx_mKhyoHehAvcAgsve0PZgghI,5905
 mcp_agent/resources/examples/data-analysis/analysis-campaign.py,sha256=QdNdo0-7LR4Uzw61hEU_jVKmWyk6A9YpGo81kMwVobM,7267
 mcp_agent/resources/examples/data-analysis/analysis.py,sha256=M9z8Q4YC5OGuqSa5uefYmmfmctqMn-WqCSfg5LI407o,2609
 mcp_agent/resources/examples/data-analysis/fastagent.config.yaml,sha256=ini94PHyJCfgpjcjHKMMbGuHs6LIj46F1NwY0ll5HVk,1609
 mcp_agent/resources/examples/data-analysis/mount-point/WA_Fn-UseC_-HR-Employee-Attrition.csv,sha256=pcMeOL1_r8m8MziE6xgbBrQbjl5Ijo98yycZn7O-dlk,227977
 mcp_agent/resources/examples/in_dev/agent_build.py,sha256=eetMEdYDbmnRH4CLO7chpQucAar3OE7iVzD_pnMjIGs,2854
+mcp_agent/resources/examples/in_dev/css-LICENSE.txt,sha256=zv0cyruZlRdeDUploPpO54kV1x1fFAc90X7vXVPrUIY,1073
 mcp_agent/resources/examples/in_dev/slides.py,sha256=-SEFeGIg9SLF253NIxmA0NjlanLe8CR1yjDBBp2LXgs,4904
 mcp_agent/resources/examples/internal/agent.py,sha256=JDfb-64gKoEG6ihsyyVWkuY9XNOdC1-P3r9qwG_qN28,497
 mcp_agent/resources/examples/internal/fastagent.config.yaml,sha256=EPJW8vsRfYq57w2U2gPF0rTAxGhkaLgiYXw0mnpXsdM,2060
@@ -115,12 +116,19 @@ mcp_agent/resources/examples/internal/history_transfer.py,sha256=ETyX2wMMvUnMpUh
 mcp_agent/resources/examples/internal/job.py,sha256=ANF3c01gHJ4O4pIxaAtC3rdgYqVObMySaCUBS4dApW4,4102
 mcp_agent/resources/examples/internal/prompt_category.py,sha256=kMvqNX_zu0sV-kTaAR3skc_tsq9t8QSEofciK0m4aJc,551
 mcp_agent/resources/examples/internal/prompt_sizing.py,sha256=bskgxulN57hVkc0V9W0fnjnqSRCK5Tkw9Ggf2MmGIVU,1989
+mcp_agent/resources/examples/internal/simple.txt,sha256=lcWo9h4NJE1OshBhRgg2QBHhHHqcrVj5j1LWdlyYlAk,14
 mcp_agent/resources/examples/internal/sizer.py,sha256=xP1TBJkp4xIdtJnyk2MP4BufThauzULaMmgnt5Y5Iw4,365
 mcp_agent/resources/examples/internal/social.py,sha256=pTKcpHAcvA-vQYgjVfDuU1FivCR004Nq4N2GXd5OMs0,1716
+mcp_agent/resources/examples/mcp/state-transfer/agent_one.py,sha256=HR-Igr8k68HU0tqIpaXujtJxnKSUwwtZqTdZk8QHNgo,455
+mcp_agent/resources/examples/mcp/state-transfer/agent_two.py,sha256=TY9SPzJZFv3TL6VEP3IpdJvTjYup5txF_DjpvEzlmbw,476
+mcp_agent/resources/examples/mcp/state-transfer/fastagent.config.yaml,sha256=yxrBBvE3icol3mFrIQ5FLWPWCci4S5LDHQGXy8Mcbnk,796
+mcp_agent/resources/examples/mcp/state-transfer/fastagent.secrets.yaml.example,sha256=0n3F2S_Z2CeLHZueZqCGy37mxiMDHLplvxUHYiCpD2A,421
 mcp_agent/resources/examples/prompting/__init__.py,sha256=2GSrs9MSDIKo-uDrUI0O311F0UH0RW02ZNdvItJzjfI,50
 mcp_agent/resources/examples/prompting/agent.py,sha256=yuONn6xkQfk6hjanC9j5_zsIK6JtRP7N-tlgVYiKJnE,616
+mcp_agent/resources/examples/prompting/delimited_prompt.txt,sha256=T_RRcJVXbrI6fXUIatQxx-8vALJ64qQqh-2WPeRS1b8,305
 mcp_agent/resources/examples/prompting/fastagent.config.yaml,sha256=UR6LtCpeSIzkHsCrHJW1z-wE7AgmgKozS_IYcfcSAkc,1270
 mcp_agent/resources/examples/prompting/image_server.py,sha256=vRDRGi68BqTWcldZ4-sd8j41M3e5TtWIUSzIROK8uFo,1667
+mcp_agent/resources/examples/prompting/prompt1.txt,sha256=H3Is5WvS9xeB7eP2-4bWF5PfZhZ6B0BICKGdGeKL9WE,64
 mcp_agent/resources/examples/prompting/work_with_image.py,sha256=2MctSPXZsmIyCYvsxsRc1_v_8v0ZKorHH0gWZxLW8Tc,507
 mcp_agent/resources/examples/researcher/fastagent.config.yaml,sha256=bNOnID9OgdSBTUEhdimKB8LjaZLa1B6igmp-nxx8nr4,2271
 mcp_agent/resources/examples/researcher/researcher-eval.py,sha256=CR9m4lyoXijS1whvsBDuk6IA-RmNc6iOYbtloETkITY,1833
@@ -133,9 +141,10 @@ mcp_agent/resources/examples/workflows/human_input.py,sha256=_I6nS6xYo8IHAmvzsUY
 mcp_agent/resources/examples/workflows/orchestrator.py,sha256=rOGilFTliWWnZ3Jx5wZOH6AQMBKwaGqSMI4PR9MKcZw,2507
 mcp_agent/resources/examples/workflows/parallel.py,sha256=n0dFN26QvYd2wjgohcaUBflac2SzXYx-bCyxMSousJE,1884
 mcp_agent/resources/examples/workflows/router.py,sha256=E4x_-c3l4YW9w1i4ARcDtkdeqIdbWEGfsMzwLYpdbVc,1677
+mcp_agent/resources/examples/workflows/short_story.txt,sha256=X3y_1AyhLFN2AKzCKvucJtDgAFIJfnlbsbGZO5bBWu0,1187
 mcp_agent/ui/console_display.py,sha256=TVGDtJ37hc6UG0ei9g7ZPZZfFNeS1MYozt-Mx8HsPCk,9752
-fast_agent_mcp-0.2.9.dist-info/METADATA,sha256=Jr7h2V_0O36zTw-_2XfEK2KXbDeoWR61heYQmPQOSWc,29849
-fast_agent_mcp-0.2.9.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-fast_agent_mcp-0.2.9.dist-info/entry_points.txt,sha256=qPM7vwtN1_KmP3dXehxgiCxUBHtqP7yfenZigztvY-w,226
-fast_agent_mcp-0.2.9.dist-info/licenses/LICENSE,sha256=cN3FxDURL9XuzE5mhK9L2paZo82LTfjwCYVT7e3j0e4,10939
-fast_agent_mcp-0.2.9.dist-info/RECORD,,
+fast_agent_mcp-0.2.11.dist-info/METADATA,sha256=1kdkV2W3MbPI2IkokeFwfA-rEdmkTZUR6C8nfFMmVrk,29940
+fast_agent_mcp-0.2.11.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+fast_agent_mcp-0.2.11.dist-info/entry_points.txt,sha256=bRniFM5zk3Kix5z7scX0gf9VnmGQ2Cz_Q1Gh7Ir4W00,186
+fast_agent_mcp-0.2.11.dist-info/licenses/LICENSE,sha256=cN3FxDURL9XuzE5mhK9L2paZo82LTfjwCYVT7e3j0e4,10939
+fast_agent_mcp-0.2.11.dist-info/RECORD,,

{fast_agent_mcp-0.2.9.dist-info → fast_agent_mcp-0.2.11.dist-info}/entry_points.txt

@@ -1,6 +1,5 @@
 [console_scripts]
 fast-agent = mcp_agent.cli.__main__:app
-fast_agent = mcp_agent.cli.__main__:app
 fastagent = mcp_agent.cli.__main__:app
 prompt-server = mcp_agent.mcp.prompts.__main__:main
 silsila = mcp_agent.cli.__main__:app

mcp_agent/cli/commands/{bootstrap.py → quickstart.py}

@@ -47,6 +47,18 @@ EXAMPLE_TYPES = {
         "mount_point_files": ["WA_Fn-UseC_-HR-Employee-Attrition.csv"],
         "create_subdir": True,
     },
+    "state-transfer": {
+        "description": "Example demonstrating state transfer between multiple agents.\n"
+        "Shows how state can be passed between agent runs to maintain context.\n"
+        "Creates examples in a 'state-transfer' subdirectory.",
+        "files": [
+            "agent_one.py",
+            "agent_two.py",
+            "fastagent.config.yaml",
+            "fastagent.secrets.yaml.example",
+        ],
+        "create_subdir": True,
+    },
 }
 
 
@@ -75,28 +87,54 @@ def copy_example_files(example_type: str, target_dir: Path, force: bool = False)
 
     try:
         # First try to find examples in the package resources
-        source_dir = (
-            files("mcp_agent")
-            .joinpath("resources")
-            .joinpath("examples")
-            .joinpath("workflows" if example_type == "workflow" else f"{example_type}")
-        )
+        if example_type == "state-transfer":
+            # The state-transfer example is in the mcp subdirectory
+            source_dir = (
+                files("mcp_agent")
+                .joinpath("resources")
+                .joinpath("examples")
+                .joinpath("mcp")
+                .joinpath("state-transfer")
+            )
+        else:
+            # Other examples are at the top level of examples
+            source_dir = (
+                files("mcp_agent")
+                .joinpath("resources")
+                .joinpath("examples")
+                .joinpath("workflows" if example_type == "workflow" else f"{example_type}")
+            )
+
+        # Check if we found a valid directory
         if not source_dir.is_dir():
+            console.print(
+                f"[yellow]Resource directory not found: {source_dir}. Falling back to development mode.[/yellow]"
+            )
             # Fall back to the top-level directory for development mode
             package_dir = Path(__file__).parent.parent.parent.parent.parent
+            if example_type == "state-transfer":
+                source_dir = package_dir / "examples" / "mcp" / "state-transfer"
+            else:
+                source_dir = (
+                    package_dir
+                    / "examples"
+                    / ("workflows" if example_type == "workflow" else f"{example_type}")
+                )
+            console.print(f"[blue]Using development directory: {source_dir}[/blue]")
+    except (ImportError, ModuleNotFoundError, ValueError) as e:
+        console.print(
+            f"[yellow]Error accessing resources: {e}. Falling back to development mode.[/yellow]"
+        )
+        # Fall back to the top-level directory if the resource finding fails
+        package_dir = Path(__file__).parent.parent.parent.parent.parent
+        if example_type == "state-transfer":
+            source_dir = package_dir / "examples" / "mcp" / "state-transfer"
+        else:
             source_dir = (
                 package_dir
                 / "examples"
                 / ("workflows" if example_type == "workflow" else f"{example_type}")
             )
-    except (ImportError, ModuleNotFoundError, ValueError):
-        # Fall back to the top-level directory if the resource finding fails
-        package_dir = Path(__file__).parent.parent.parent.parent.parent
-        source_dir = (
-            package_dir
-            / "examples"
-            / ("workflows" if example_type == "workflow" else f"{example_type}")
-        )
 
     if not source_dir.exists():
         console.print(f"[red]Error: Source directory not found: {source_dir}[/red]")
@@ -116,7 +154,14 @@ def copy_example_files(example_type: str, target_dir: Path, force: bool = False)
                 continue
 
             shutil.copy2(source, target)
-            created.append(str(target.relative_to(target_dir.parent)))
+            try:
+                # This can fail in test environments where the target is not relative to target_dir.parent
+                rel_path = str(target.relative_to(target_dir.parent))
+            except ValueError:
+                # Fallback to just the filename
+                rel_path = f"{example_type}/{filename}"
+
+            created.append(rel_path)
             console.print(f"[green]Created[/green] {created[-1]}")
 
         except Exception as e:
@@ -174,15 +219,17 @@ def show_overview() -> None:
     # Show usage instructions in a panel
     usage_text = (
         "[bold]Commands:[/bold]\n"
-        "  fastagent bootstrap workflow DIR      Create workflow examples in DIR\n"
-        "  fastagent bootstrap researcher DIR    Create researcher example in 'researcher' subdirectory\n"
-        "  fastagent bootstrap data-analysis DIR Create data analysis examples in 'data-analysis' subdirectory\n\n"
+        "  fastagent quickstart workflow DIR      Create workflow examples in DIR\n"
+        "  fastagent quickstart researcher DIR    Create researcher example in 'researcher' subdirectory\n"
+        "  fastagent quickstart data-analysis DIR Create data analysis examples in 'data-analysis' subdirectory\n"
+        "  fastagent quickstart state-transfer DIR Create state transfer examples in 'state-transfer' subdirectory\n\n"
         "[bold]Options:[/bold]\n"
         "  --force            Overwrite existing files\n\n"
         "[bold]Examples:[/bold]\n"
-        "  fastagent bootstrap workflow .              Create in current directory\n"
-        "  fastagent bootstrap researcher .            Create in researcher subdirectory\n"
-        "  fastagent bootstrap data-analysis . --force Force overwrite files in data-analysis subdirectory"
+        "  fastagent quickstart workflow .              Create in current directory\n"
+        "  fastagent quickstart researcher .            Create in researcher subdirectory\n"
+        "  fastagent quickstart data-analysis . --force Force overwrite files in data-analysis subdirectory\n"
+        "  fastagent quickstart state-transfer .        Create state transfer examples"
     )
     console.print(Panel(usage_text, title="Usage", border_style="blue"))
 
@@ -241,6 +288,24 @@ def data_analysis(
     _show_completion_message("data-analysis", created)
 
 
+@app.command()
+def state_transfer(
+    directory: Path = typer.Argument(
+        Path("."),
+        help="Directory where state transfer examples will be created (in 'state-transfer' subdirectory)",
+    ),
+    force: bool = typer.Option(False, "--force", "-f", help="Force overwrite existing files"),
+) -> None:
+    """Create state transfer example showing state passing between agents."""
+    target_dir = directory.resolve()
+    if not target_dir.exists():
+        target_dir.mkdir(parents=True)
+        console.print(f"Created directory: {target_dir}")
+
+    created = copy_example_files("state-transfer", target_dir, force)
+    _show_completion_message("state-transfer", created)
+
+
 def _show_completion_message(example_type: str, created: list[str]) -> None:
     """Show completion message and next steps."""
     if created:
@@ -275,6 +340,8 @@ def _show_completion_message(example_type: str, created: list[str]) -> None:
             console.print(
                 "On Windows platforms, please edit the fastagent.config.yaml and adjust the volume mount point."
             )
+        elif example_type == "state-transfer":
+            console.print("Check https://fast-agent.ai for quick start walkthroughs")
     else:
         console.print("\n[yellow]No files were created.[/yellow]")
 

mcp_agent/cli/commands/setup.py

@@ -55,12 +55,18 @@ FASTAGENT_SECRETS_TEMPLATE = """
 # FastAgent Secrets Configuration
 # WARNING: Keep this file secure and never commit to version control
 
-# Alternatively set OPENAI_API_KEY and ANTHROPIC_API_KEY environment variables. Config file takes precedence.
+# Alternatively set OPENAI_API_KEY, ANTHROPIC_API_KEY or other environment variables. 
+# Keys in the configuration file override environment variables.
 
 openai:
     api_key: <your-api-key-here>
 anthropic:
     api_key: <your-api-key-here>
+deepseek:
+    api_key: <your-api-key-here>
+openrouter:
+    api_key: <your-api-key-here>
+
 
 # Example of setting an MCP Server environment variable
 mcp:
@@ -116,15 +122,15 @@ import asyncio
 from mcp_agent.core.fastagent import FastAgent
 
 # Create the application
-fast = FastAgent("FastAgent Example")
+fast = FastAgent("fast-agent example")
 
 
 # Define the agent
-@fast.agent(instruction="You are a helpful AI Agent", servers=["fetch"])
+@fast.agent(instruction="You are a helpful AI Agent")
 async def main():
     # use the --model command line switch or agent arguments to change model
     async with fast.run() as agent:
-        await agent()
+        await agent.interactive()
 
 
 if __name__ == "__main__":

mcp_agent/cli/main.py

@@ -4,7 +4,7 @@ import typer
 from rich.console import Console
 from rich.table import Table
 
-from mcp_agent.cli.commands import bootstrap, setup
+from mcp_agent.cli.commands import quickstart, setup
 from mcp_agent.cli.terminal import Application
 
 app = typer.Typer(
@@ -14,7 +14,8 @@ app = typer.Typer(
 
 # Subcommands
 app.add_typer(setup.app, name="setup", help="Set up a new agent project")
-app.add_typer(bootstrap.app, name="bootstrap", help="Create example applications")
+app.add_typer(quickstart.app, name="bootstrap", help="Create example applications")
+app.add_typer(quickstart.app, name="quickstart", help="Create example applications")
 
 # Shared application context
 application = Application()
@@ -39,7 +40,7 @@ def show_welcome() -> None:
     table.add_column("Description")
 
     table.add_row("setup", "Set up a new agent project with configuration files")
-    table.add_row("bootstrap", "Create example applications (workflow, researcher, etc.)")
+    table.add_row("quickstart", "Create example applications (workflow, researcher, etc.)")
     # table.add_row("config", "Manage agent configuration settings")
 
     console.print(table)
@@ -48,12 +49,12 @@ def show_welcome() -> None:
     console.print("1. Set up a new project:")
     console.print("   fastagent setup")
     console.print("\n2. Create Building Effective Agents  workflow examples:")
-    console.print("   fastagent bootstrap workflow")
+    console.print("   fastagent quickstart workflow")
     console.print("\n3. Explore other examples:")
-    console.print("   fastagent bootstrap")
+    console.print("   fastagent quickstart")
 
     console.print("\nUse --help with any command for more information")
-    console.print("Example: fastagent bootstrap --help")
+    console.print("Example: fastagent quickstart --help")
 
 
 @app.callback(invoke_without_command=True)
@@ -74,6 +75,7 @@ def main(
     # Handle version flag
     if version:
         from importlib.metadata import version as get_version
+
         try:
             app_version = get_version("fast-agent-mcp")
         except:  # noqa: E722

mcp_agent/config.py

@@ -70,6 +70,9 @@ class MCPServerSettings(BaseModel):
     """The arguments for the server command."""
 
     read_timeout_seconds: int | None = None
+    """The timeout in seconds for the session."""
+
+    read_transport_sse_timeout_seconds: int = 300
     """The timeout in seconds for the server connection."""
 
     url: str | None = None

mcp_agent/llm/providers/augmented_llm_generic.py

@@ -40,8 +40,8 @@ class GenericAugmentedLLM(OpenAIAugmentedLLM):
         return api_key or "ollama"
 
     def _base_url(self) -> str:
-        base_url = None
+        base_url = os.getenv("GENERIC_BASE_URL", DEFAULT_OLLAMA_BASE_URL)
         if self.context.config and self.context.config.generic:
             base_url = self.context.config.generic.base_url
 
-        return base_url if base_url else DEFAULT_OLLAMA_BASE_URL
+        return base_url

mcp_agent/llm/providers/augmented_llm_openrouter.py

@@ -4,7 +4,7 @@ from mcp_agent.core.exceptions import ProviderKeyError
 from mcp_agent.core.request_params import RequestParams
 from mcp_agent.llm.providers.augmented_llm_openai import OpenAIAugmentedLLM
 
-OPENROUTER_BASE_URL = "https://openrouter.ai/api/v1"
+DEFAULT_OPENROUTER_BASE_URL = "https://openrouter.ai/api/v1"
 # No single default model for OpenRouter, users must specify full path
 DEFAULT_OPENROUTER_MODEL = None 
 
@@ -63,7 +63,7 @@ class OpenRouterAugmentedLLM(OpenAIAugmentedLLM):
 
     def _base_url(self) -> str:
         """Retrieve the OpenRouter base URL from config or use the default."""
-        base_url = OPENROUTER_BASE_URL # Default
+        base_url = os.getenv("OPENROUTER_BASE_URL", DEFAULT_OPENROUTER_BASE_URL)  # Default
         config = self.context.config
         
         # Check config file for override

mcp_agent/mcp/mcp_connection_manager.py

@@ -271,7 +271,11 @@ class MCPConnectionManager(ContextDependent):
                 logger.debug(f"{server_name}: Creating stdio client with custom error handler")
                 return stdio_client(server_params, errlog=error_handler)
             elif config.transport == "sse":
-                return sse_client(config.url, config.headers)
+                return sse_client(
+                    config.url,
+                    config.headers,
+                    sse_read_timeout=config.read_transport_sse_timeout_seconds,
+                )
             else:
                 raise ValueError(f"Unsupported transport: {config.transport}")
 

mcp_agent/mcp/prompt_serialization.py

@@ -5,9 +5,9 @@ This module provides utilities for converting between different serialization fo
 and PromptMessageMultipart objects. It includes functionality for:
 
 1. JSON Serialization:
-   - Converting PromptMessageMultipart objects to pure JSON format
-   - Parsing JSON into PromptMessageMultipart objects
-   - This is ideal for programmatic use and ensures all data fidelity
+   - Converting PromptMessageMultipart objects to MCP-compatible GetPromptResult JSON format
+   - Parsing GetPromptResult JSON into PromptMessageMultipart objects
+   - This is ideal for programmatic use and ensures full MCP compatibility
 
 2. Delimited Text Format:
    - Converting PromptMessageMultipart objects to delimited text (---USER, ---ASSISTANT)
@@ -19,7 +19,13 @@ and PromptMessageMultipart objects. It includes functionality for:
 import json
 from typing import List
 
-from mcp.types import EmbeddedResource, ImageContent, TextContent, TextResourceContents
+from mcp.types import (
+    EmbeddedResource,
+    GetPromptResult,
+    ImageContent,
+    TextContent,
+    TextResourceContents,
+)
 
 from mcp_agent.mcp.prompt_message_multipart import PromptMessageMultipart
 from mcp_agent.mcp.prompts.prompt_constants import (
@@ -33,51 +39,68 @@ from mcp_agent.mcp.prompts.prompt_constants import (
 # -------------------------------------------------------------------------
 
 
+def multipart_messages_to_get_prompt_result(
+    messages: List[PromptMessageMultipart],
+) -> GetPromptResult:
+    """
+    Convert PromptMessageMultipart objects to a GetPromptResult container.
+
+    Args:
+        messages: List of PromptMessageMultipart objects
+
+    Returns:
+        GetPromptResult object containing flattened messages
+    """
+    # Convert multipart messages to regular PromptMessage objects
+    flat_messages = []
+    for message in messages:
+        flat_messages.extend(message.from_multipart())
+
+    # Create a GetPromptResult with the flattened messages
+    return GetPromptResult(messages=flat_messages)
+
+
 def multipart_messages_to_json(messages: List[PromptMessageMultipart]) -> str:
     """
-    Convert PromptMessageMultipart objects to a pure JSON string.
+    Convert PromptMessageMultipart objects to a pure JSON string in GetPromptResult format.
 
-    This approach preserves all data and structure exactly as is, but is less
-    human-readable for text content.
+    This approach preserves all data and structure exactly as is, compatible with
+    the MCP GetPromptResult type.
 
     Args:
         messages: List of PromptMessageMultipart objects
 
     Returns:
-        JSON string representation of the messages
+        JSON string representation with GetPromptResult container
     """
-    # Convert to dictionaries using model_dump with proper JSON mode
-    # The mode="json" parameter ensures proper handling of AnyUrl objects
-    message_dicts = [
-        message.model_dump(by_alias=True, mode="json", exclude_none=True) for message in messages
-    ]
+    # First convert to GetPromptResult
+    result = multipart_messages_to_get_prompt_result(messages)
+
+    # Convert to dictionary using model_dump with proper JSON mode
+    result_dict = result.model_dump(by_alias=True, mode="json", exclude_none=True)
 
     # Convert to JSON string
-    return json.dumps(message_dicts, indent=2)
+    return json.dumps(result_dict, indent=2)
 
 
 def json_to_multipart_messages(json_str: str) -> List[PromptMessageMultipart]:
     """
-    Parse a JSON string into PromptMessageMultipart objects.
+    Parse a JSON string in GetPromptResult format into PromptMessageMultipart objects.
 
     Args:
-        json_str: JSON string representation of messages
+        json_str: JSON string representation of GetPromptResult
 
     Returns:
         List of PromptMessageMultipart objects
     """
-    # Parse JSON to list of dictionaries
-    message_dicts = json.loads(json_str)
+    # Parse JSON to dictionary
+    result_dict = json.loads(json_str)
 
-    # Convert dictionaries to PromptMessageMultipart objects
-    messages = []
-    for message_dict in message_dicts:
-        # Parse message using Pydantic's model_validate method (Pydantic v2)
-        # For Pydantic v1, this would use parse_obj instead
-        message = PromptMessageMultipart.model_validate(message_dict)
-        messages.append(message)
+    # Parse as GetPromptResult
+    result = GetPromptResult.model_validate(result_dict)
 
-    return messages
+    # Convert to multipart messages
+    return PromptMessageMultipart.to_multipart(result.messages)
 
 
 def save_messages_to_json_file(messages: List[PromptMessageMultipart], file_path: str) -> None:
@@ -113,17 +136,18 @@ def load_messages_from_json_file(file_path: str) -> List[PromptMessageMultipart]
 def save_messages_to_file(messages: List[PromptMessageMultipart], file_path: str) -> None:
     """
     Save PromptMessageMultipart objects to a file, with format determined by file extension.
-    
-    Uses JSON format for .json files and delimited text format for other extensions.
-    
+
+    Uses GetPromptResult JSON format for .json files (fully MCP compatible) and
+    delimited text format for other extensions.
+
     Args:
         messages: List of PromptMessageMultipart objects
         file_path: Path to save the file
     """
     path_str = str(file_path).lower()
-    
+
     if path_str.endswith(".json"):
-        # Use JSON format for .json files (MCP SDK compatible format)
+        # Use GetPromptResult JSON format for .json files (fully MCP compatible)
         save_messages_to_json_file(messages, file_path)
     else:
         # Use delimited text format for other extensions
@@ -133,19 +157,20 @@ def save_messages_to_file(messages: List[PromptMessageMultipart], file_path: str
 def load_messages_from_file(file_path: str) -> List[PromptMessageMultipart]:
     """
     Load PromptMessageMultipart objects from a file, with format determined by file extension.
-    
-    Uses JSON format for .json files and delimited text format for other extensions.
-    
+
+    Uses GetPromptResult JSON format for .json files (fully MCP compatible) and
+    delimited text format for other extensions.
+
     Args:
         file_path: Path to the file
-        
+
     Returns:
         List of PromptMessageMultipart objects
     """
     path_str = str(file_path).lower()
-    
+
     if path_str.endswith(".json"):
-        # Use JSON format for .json files (MCP SDK compatible format)
+        # Use GetPromptResult JSON format for .json files (fully MCP compatible)
         return load_messages_from_json_file(file_path)
     else:
         # Use delimited text format for other extensions

mcp_agent/mcp/prompts/prompt_load.py

@@ -103,29 +103,34 @@ def create_resource_message(
 def load_prompt(file: Path) -> List[PromptMessage]:
     """
     Load a prompt from a file and return as PromptMessage objects.
-    
+
     The loader uses file extension to determine the format:
-    - .json files are loaded as MCP SDK compatible JSON format
+    - .json files are loaded as MCP SDK compatible GetPromptResult JSON format
     - All other files are loaded using the template-based delimited format
-    
+
     Args:
         file: Path to the prompt file
-        
+
     Returns:
         List of PromptMessage objects
     """
     file_str = str(file).lower()
-    
+
     if file_str.endswith(".json"):
-        # JSON format (MCP SDK compatible)
-        from mcp_agent.mcp.prompt_serialization import load_messages_from_json_file
-        
-        # Load multipart messages and convert to flat messages
-        multipart_messages = load_messages_from_json_file(str(file))
-        messages = []
-        for mp in multipart_messages:
-            messages.extend(mp.from_multipart())
-        return messages
+        # Handle JSON format as GetPromptResult
+        import json
+
+        from mcp.types import GetPromptResult
+
+        # Load JSON directly into GetPromptResult
+        with open(file, "r", encoding="utf-8") as f:
+            json_data = json.load(f)
+
+        # Parse as GetPromptResult object
+        result = GetPromptResult.model_validate(json_data)
+
+        # Return the messages directly
+        return result.messages
     else:
         # Template-based format (delimited text)
         template: PromptTemplate = PromptTemplateLoader().load_from_file(file)
@@ -135,23 +140,18 @@ def load_prompt(file: Path) -> List[PromptMessage]:
 def load_prompt_multipart(file: Path) -> List[PromptMessageMultipart]:
     """
     Load a prompt from a file and return as PromptMessageMultipart objects.
-    
+
     The loader uses file extension to determine the format:
-    - .json files are loaded as MCP SDK compatible JSON format
+    - .json files are loaded as MCP SDK compatible GetPromptResult JSON format
     - All other files are loaded using the template-based delimited format
-    
+
     Args:
         file: Path to the prompt file
-        
+
     Returns:
         List of PromptMessageMultipart objects
     """
-    file_str = str(file).lower()
-    
-    if file_str.endswith(".json"):
-        # JSON format (MCP SDK compatible)
-        from mcp_agent.mcp.prompt_serialization import load_messages_from_json_file
-        return load_messages_from_json_file(str(file))
-    else:
-        # Template-based format (delimited text)
-        return PromptMessageMultipart.to_multipart(load_prompt(file))
+    # First load as regular PromptMessage objects
+    messages = load_prompt(file)
+    # Then convert to multipart messages
+    return PromptMessageMultipart.to_multipart(messages)

mcp_agent/mcp/prompts/prompt_server.py

@@ -140,10 +140,59 @@ def get_delimiter_config(
 def register_prompt(file_path: Path, config: Optional[PromptConfig] = None) -> None:
     """Register a prompt file"""
     try:
+        # Check if it's a JSON file for ultra-minimal path
+        file_str = str(file_path).lower()
+        if file_str.endswith(".json"):
+            # Simple JSON handling - just load and register directly
+            from mcp.server.fastmcp.prompts.base import Prompt, PromptArgument
+
+            from mcp_agent.mcp.prompts.prompt_load import load_prompt
+
+            # Create metadata with minimal information
+            metadata = PromptMetadata(
+                name=file_path.stem,
+                description=f"JSON prompt: {file_path.stem}",
+                template_variables=set(),
+                resource_paths=[],  # Skip resource handling
+                file_path=file_path,
+            )
+
+            # Ensure unique name
+            prompt_name = metadata.name
+            if prompt_name in prompt_registry:
+                base_name = prompt_name
+                suffix = 1
+                while prompt_name in prompt_registry:
+                    prompt_name = f"{base_name}_{suffix}"
+                    suffix += 1
+                metadata.name = prompt_name
+
+            prompt_registry[metadata.name] = metadata
+
+            # Create a simple handler that directly loads the JSON file each time
+            async def json_prompt_handler():
+                # Load the messages from the JSON file
+                messages = load_prompt(file_path)
+                # Convert to FastMCP format
+                return convert_to_fastmcp_messages(messages)
+
+            # Register directly with MCP
+            prompt = Prompt(
+                name=metadata.name,
+                description=metadata.description,
+                arguments=[],  # No arguments for JSON prompts
+                fn=json_prompt_handler,
+            )
+            mcp._prompt_manager.add_prompt(prompt)
+
+            logger.info(f"Registered JSON prompt: {metadata.name} ({file_path})")
+            return  # Early return - we're done with JSON files
+
+        # For non-JSON files, continue with the standard approach
         # Get delimiter configuration
         config_values = get_delimiter_config(config, file_path)
 
-        # Use our prompt template loader to analyze the file
+        # Use standard template loader for text files
         loader = PromptTemplateLoader(
             {
                 config_values["user_delimiter"]: "user",

mcp_agent/mcp_server/agent_server.py

@@ -21,7 +21,7 @@ class AgentMCPServer:
         server_description: str | None = None,
     ) -> None:
         self.agent_app = agent_app
-        self.mcp_server = FastMCP(
+        self.mcp_server: FastMCP = FastMCP(
             name=server_name,
             instructions=server_description
             or f"This server provides access to {len(agent_app._agents)} agents",
@@ -95,16 +95,15 @@ class AgentMCPServer:
             try:
                 await self.mcp_server.run_sse_async()
             except (asyncio.CancelledError, KeyboardInterrupt):
-                # Gracefully handle cancellation during shutdown
-                await self.shutdown()
-                pass
+                print("Server Stopped (CTRL+C)")
+                return
         else:  # stdio
             try:
                 await self.mcp_server.run_stdio_async()
             except (asyncio.CancelledError, KeyboardInterrupt):
                 # Gracefully handle cancellation during shutdown
-                await self.shutdown()
-                pass
+                print("Server Stopped (CTRL+C)")
+                return
 
     async def with_bridged_context(self, agent_context, mcp_context, func, *args, **kwargs):
         """
@@ -150,17 +149,4 @@ class AgentMCPServer:
     async def shutdown(self):
         """Gracefully shutdown the MCP server and its resources."""
         # Your MCP server may have additional cleanup code here
-        try:
-            # If your MCP server has a shutdown method, call it
-            if hasattr(self.mcp_server, "shutdown"):
-                await self.mcp_server.shutdown()
-
-            # Clean up any other resources
-            import asyncio
-
-            # Allow any pending tasks to clean up
-            await asyncio.sleep(0.5)
-        except Exception as e:
-            # Just log exceptions during shutdown, don't raise
-            print(f"Error during MCP server shutdown: {e}")
-            pass
+        pass

mcp_agent/mcp_server_registry.py

@@ -152,7 +152,11 @@ class ServerRegistry:
                 raise ValueError(f"URL is required for SSE transport: {server_name}")
 
             # Use sse_client to get the read and write streams
-            async with sse_client(config.url, config.headers) as (read_stream, write_stream):
+            async with sse_client(
+                config.url,
+                config.headers,
+                sse_read_timeout=config.read_transport_sse_timeout_seconds,
+            ) as (read_stream, write_stream):
                 session = client_session_factory(
                     read_stream,
                     write_stream,

mcp_agent/resources/examples/in_dev/css-LICENSE.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2021-2024 Paulo Cunha
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

mcp_agent/resources/examples/internal/simple.txt

@@ -0,0 +1,2 @@
+hello, world
+

mcp_agent/resources/examples/mcp/state-transfer/agent_one.py

@@ -0,0 +1,18 @@
+import asyncio
+
+from mcp_agent.core.fastagent import FastAgent
+
+# Create the application
+fast = FastAgent("fast-agent agent_one (mcp server)")
+
+
+# Define the agent
+@fast.agent(name="agent_one", instruction="You are a helpful AI Agent.")
+async def main():
+    # use the --model command line switch or agent arguments to change model
+    async with fast.run() as agent:
+        await agent.interactive()
+
+
+if __name__ == "__main__":
+    asyncio.run(main())

mcp_agent/resources/examples/mcp/state-transfer/agent_two.py

@@ -0,0 +1,18 @@
+import asyncio
+
+from mcp_agent.core.fastagent import FastAgent
+
+# Create the application
+fast = FastAgent("fast-agent agent_two (mcp host)")
+
+
+# Define the agent
+@fast.agent(name="agent_two", instruction="You are a helpful AI Agent.", servers=["agent_one"])
+async def main():
+    # use the --model command line switch or agent arguments to change model
+    async with fast.run() as agent:
+        await agent.interactive()
+
+
+if __name__ == "__main__":
+    asyncio.run(main())

mcp_agent/resources/examples/mcp/state-transfer/fastagent.config.yaml

@@ -0,0 +1,27 @@
+# Model string takes format:
+#   <provider>.<model_string>.<reasoning_effort?> (e.g. anthropic.claude-3-5-sonnet-20241022 or openai.o3-mini.low)
+#
+# Can be overriden with a command line switch --model=<model>, or within the Agent decorator.
+# Check here for current details: https://fast-agent.ai/models/
+
+# set the default model for fast-agent below:
+default_model: gpt-4o
+
+# Logging and Console Configuration:
+logger:
+  # Switched off to avoid cluttering the console
+  progress_display: false
+
+  # Show chat User/Assistant messages on the console
+  show_chat: true
+  # Show tool calls on the console
+  show_tools: true
+  # Truncate long tool responses on the console
+  truncate_tools: true
+
+# MCP Servers
+mcp:
+  servers:
+    agent_one:
+      transport: sse
+      url: http://localhost:8001/sse

mcp_agent/resources/examples/mcp/state-transfer/fastagent.secrets.yaml.example

@@ -0,0 +1,14 @@
+# FastAgent Secrets Configuration
+# WARNING: Keep this file secure and never commit to version control
+
+# Alternatively set OPENAI_API_KEY, ANTHROPIC_API_KEY or other environment variables.
+# Keys in the configuration file override environment variables.
+
+openai:
+  api_key: <your-api-key-here>
+anthropic:
+  api_key: <your-api-key-here>
+deepseek:
+  api_key: <your-api-key-here>
+openrouter:
+  api_key: <your-api-key-here>

mcp_agent/resources/examples/prompting/delimited_prompt.txt

@@ -0,0 +1,14 @@
+---USER
+I want to learn about {{topic}}.
+
+Can you tell me about it in detail?
+
+---ASSISTANT
+I'd be happy to tell you about {{topic}}!
+
+Here are some key facts about {{topic}}:
+1. It's very interesting
+2. It has a rich history
+3. Many people study it
+
+Would you like me to elaborate on any specific aspect?

mcp_agent/resources/examples/prompting/prompt1.txt

@@ -0,0 +1,6 @@
+Hello, World.
+
+This is {{blah}} foo
+
+This is {{terrible}} etc.
+

mcp_agent/resources/examples/workflows/short_story.txt

@@ -0,0 +1,19 @@
+The Battle of Glimmerwood
+
+In the heart of Glimmerwood, a mystical forest knowed for its radiant trees, a small village thrived. 
+The villagers, who were live peacefully, shared their home with the forest's magical creatures, 
+especially the Glimmerfoxes whose fur shimmer like moonlight.
+
+One fateful evening, the peace was shaterred when the infamous Dark Marauders attack. 
+Lead by the cunning Captain Thorn, the bandits aim to steal the precious Glimmerstones which was believed to grant immortality.
+
+Amidst the choas, a young girl named Elara stood her ground, she rallied the villagers and devised a clever plan.
+Using the forests natural defenses they lured the marauders into a trap. 
+As the bandits aproached the village square, a herd of Glimmerfoxes emerged, blinding them with their dazzling light, 
+the villagers seized the opportunity to captured the invaders.
+
+Elara's bravery was celebrated and she was hailed as the "Guardian of Glimmerwood". 
+The Glimmerstones were secured in a hidden grove protected by an ancient spell.
+
+However, not all was as it seemed. The Glimmerstones true power was never confirm, 
+and whispers of a hidden agenda linger among the villagers.