diff --git a/examples/mcp/multi_mcp_guide/agent_mcp.py b/examples/mcp/multi_mcp_guide/agent_mcp.py
index 1740f1ee..a9b9579e 100644
--- a/examples/mcp/multi_mcp_guide/agent_mcp.py
+++ b/examples/mcp/multi_mcp_guide/agent_mcp.py
@@ -3,24 +3,27 @@ from swarms.prompts.finance_agent_sys_prompt import (
     FINANCIAL_AGENT_SYS_PROMPT,
 )
 
-# Initialize the agent
+# Initialize the financial analysis agent with a system prompt and configuration.
 agent = Agent(
-    agent_name="Financial-Analysis-Agent",
-    agent_description="Personal finance advisor agent",
-    system_prompt=FINANCIAL_AGENT_SYS_PROMPT,
-    max_loops=1,
+    agent_name="Financial-Analysis-Agent",  # Name of the agent
+    agent_description="Personal finance advisor agent",  # Description of the agent's role
+    system_prompt=FINANCIAL_AGENT_SYS_PROMPT,  # System prompt for financial tasks
+    max_loops=1, 
     mcp_urls=[
-        "http://0.0.0.0:8001/mcp",
-        "http://0.0.0.0:8000/mcp",
+        "http://0.0.0.0:8001/mcp",  # URL for the OKX crypto price MCP server
+        "http://0.0.0.0:8000/mcp",  # URL for the agent creation MCP server
     ],
     model_name="gpt-4o-mini",
     output_type="all",
 )
 
-# Create a markdown file with initial content
+# Run the agent with a specific instruction to use the create_agent tool.
+# The agent is asked to create a new agent specialized for accounting rules in crypto.
 out = agent.run(
+    # Example alternative prompt:
     # "Use the get_okx_crypto_price to get the price of solana  just put the name of the coin",
-    "Use the create_agent tool that is specialized in creating agents"
+    "Use the create_agent tool that is specialized in creating agents and create an agent speecialized for accounting rules in crypto"
 )
 
+# Print the output from the agent's run method.
 print(out)
diff --git a/examples/agent_judge_examples/example1_basic_evaluation.py b/examples/reasoning_agents/agent_judge_examples/example1_basic_evaluation.py
similarity index 100%
rename from examples/agent_judge_examples/example1_basic_evaluation.py
rename to examples/reasoning_agents/agent_judge_examples/example1_basic_evaluation.py
diff --git a/examples/agent_judge_examples/example2_technical_evaluation.py b/examples/reasoning_agents/agent_judge_examples/example2_technical_evaluation.py
similarity index 100%
rename from examples/agent_judge_examples/example2_technical_evaluation.py
rename to examples/reasoning_agents/agent_judge_examples/example2_technical_evaluation.py
diff --git a/examples/agent_judge_examples/example3_creative_evaluation.py b/examples/reasoning_agents/agent_judge_examples/example3_creative_evaluation.py
similarity index 100%
rename from examples/agent_judge_examples/example3_creative_evaluation.py
rename to examples/reasoning_agents/agent_judge_examples/example3_creative_evaluation.py
diff --git a/examples/api_examples/agent_overview.py b/examples/swarms_api_examples/agent_overview.py
similarity index 100%
rename from examples/api_examples/agent_overview.py
rename to examples/swarms_api_examples/agent_overview.py
diff --git a/examples/api_examples/batch_example.py b/examples/swarms_api_examples/batch_example.py
similarity index 100%
rename from examples/api_examples/batch_example.py
rename to examples/swarms_api_examples/batch_example.py
diff --git a/examples/api_examples/client_example.py b/examples/swarms_api_examples/client_example.py
similarity index 100%
rename from examples/api_examples/client_example.py
rename to examples/swarms_api_examples/client_example.py
diff --git a/examples/api_examples/hospital_team.py b/examples/swarms_api_examples/hospital_team.py
similarity index 100%
rename from examples/api_examples/hospital_team.py
rename to examples/swarms_api_examples/hospital_team.py
diff --git a/examples/api_examples/icd_ten_analysis.py b/examples/swarms_api_examples/icd_ten_analysis.py
similarity index 100%
rename from examples/api_examples/icd_ten_analysis.py
rename to examples/swarms_api_examples/icd_ten_analysis.py
diff --git a/examples/api_examples/legal_team.py b/examples/swarms_api_examples/legal_team.py
similarity index 100%
rename from examples/api_examples/legal_team.py
rename to examples/swarms_api_examples/legal_team.py
diff --git a/examples/api_examples/rate_limits.py b/examples/swarms_api_examples/rate_limits.py
similarity index 100%
rename from examples/api_examples/rate_limits.py
rename to examples/swarms_api_examples/rate_limits.py