mcp-use 1.3.7__tar.gz → 1.3.8__tar.gz

{mcp_use-1.3.7 → mcp_use-1.3.8}/.github/workflows/tests.yml

@@ -53,7 +53,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        transport: [stdio, sse, streamableHttp]
+        transport: [stdio, sse, streamable_http]
     steps:
       - uses: actions/checkout@v3
       - name: Set up Python 3.11
@@ -68,7 +68,7 @@ jobs:
           uv pip install --system .[dev,anthropic,openai,search,e2b]
       - name: Run integration tests for ${{ matrix.transport }} transport
         run: |
-          pytest tests/integration/transports/${{ matrix.transport }}
+          pytest tests/integration/transports/test_${{ matrix.transport }}.py
 
   primitive-tests:
     needs: lint
@@ -93,3 +93,23 @@ jobs:
       - name: Run integration tests for ${{ matrix.primitive }} primitive
         run: |
           pytest tests/integration/primitives/test_${{ matrix.primitive }}.py
+
+  integration-tests:
+    needs: lint
+    name: "Integration"
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+      - name: Set up Python 3.11
+        uses: actions/setup-python@v4
+        with:
+          python-version: "3.11"
+      - name: Install uv
+        run: |
+          pip install uv
+      - name: Install dependencies
+        run: |
+          uv pip install --system .[dev,anthropic,openai,search,e2b]
+      - name: Run other integration tests
+        run: |
+          pytest tests/integration/others/

{mcp_use-1.3.7 → mcp_use-1.3.8}/.github/workflows/update-readme.yml

@@ -7,7 +7,9 @@ on:
   schedule:
     - cron: "0 0 * * 0" # Every sunday at midnight
 
-permissions: read-all
+permissions:
+  contents: write
+  pull-requests: write
 
 concurrency:
   group: ${{ github.ref }}-${{ github.workflow }}

{mcp_use-1.3.7 → mcp_use-1.3.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mcp-use
-Version: 1.3.7
+Version: 1.3.8
 Summary: MCP Library for LLMs
 Author-email: Pietro Zullo <pietro.zullo@gmail.com>
 License: MIT
@@ -17,7 +17,7 @@ Requires-Python: >=3.11
 Requires-Dist: aiohttp>=3.9.0
 Requires-Dist: jsonschema-pydantic>=0.1.0
 Requires-Dist: langchain>=0.1.0
-Requires-Dist: mcp>=1.9.3
+Requires-Dist: mcp>=1.10.0
 Requires-Dist: posthog>=4.8.0
 Requires-Dist: pydantic>=2.0.0
 Requires-Dist: python-dotenv>=1.0.0
@@ -84,10 +84,9 @@ Description-Content-Type: text/markdown
 
 💡 Let developers easily connect any LLM to tools like web browsing, file operations, and more.
 
-- Visit the [mcp-use.com website](https://mcp-use.com/) to know how to build and deploy MCP agents.
+- If you want to get started quickly check out [mcp-use.com website](https://mcp-use.com/) to build and deploy agents with your favorite MCP servers.
 - Visit the [mcp-use docs](https://docs.mcp-use.com/) to get started with mcp-use library
-
-💬 Get started quickly - chat with your servers on our <b>hosted version</b>! [Try mcp-use chat (beta)](https://chat.mcp-use.com).
+- For the TypeScript version, visit [mcp-use-ts](https://github.com/mcp-use/mcp-use-ts)
 
 | Supports  | |
 | :--- | :--- |
@@ -812,45 +811,45 @@ Thanks to all our amazing contributors!
     <th width="400">Repository</th>
     <th>Stars</th>
   </tr>
+  <tr>
+    <td><img src="https://avatars.githubusercontent.com/u/38653995?s=40&v=4" width="20" height="20" style="vertical-align: middle; margin-right: 8px;"> <a href="https://github.com/patchy631/ai-engineering-hub"><strong>patchy631/ai-engineering-hub</strong></a></td>
+    <td>⭐ 15189</td>
+  </tr>
   <tr>
     <td><img src="https://avatars.githubusercontent.com/u/170207473?s=40&v=4" width="20" height="20" style="vertical-align: middle; margin-right: 8px;"> <a href="https://github.com/tavily-ai/meeting-prep-agent"><strong>tavily-ai/meeting-prep-agent</strong></a></td>
-    <td>⭐ 112</td>
+    <td>⭐ 129</td>
+  </tr>
+  <tr>
+    <td><img src="https://avatars.githubusercontent.com/u/187057607?s=40&v=4" width="20" height="20" style="vertical-align: middle; margin-right: 8px;"> <a href="https://github.com/hud-evals/hud-sdk"><strong>hud-evals/hud-sdk</strong></a></td>
+    <td>⭐ 75</td>
   </tr>
   <tr>
     <td><img src="https://avatars.githubusercontent.com/u/20041231?s=40&v=4" width="20" height="20" style="vertical-align: middle; margin-right: 8px;"> <a href="https://github.com/krishnaik06/MCP-CRASH-Course"><strong>krishnaik06/MCP-CRASH-Course</strong></a></td>
-    <td>⭐ 37</td>
+    <td>⭐ 58</td>
+  </tr>
+  <tr>
+    <td><img src="https://avatars.githubusercontent.com/u/54944174?s=40&v=4" width="20" height="20" style="vertical-align: middle; margin-right: 8px;"> <a href="https://github.com/larksuite/lark-samples"><strong>larksuite/lark-samples</strong></a></td>
+    <td>⭐ 31</td>
   </tr>
   <tr>
     <td><img src="https://avatars.githubusercontent.com/u/892404?s=40&v=4" width="20" height="20" style="vertical-align: middle; margin-right: 8px;"> <a href="https://github.com/truemagic-coder/solana-agent-app"><strong>truemagic-coder/solana-agent-app</strong></a></td>
-    <td>⭐ 29</td>
+    <td>⭐ 30</td>
   </tr>
   <tr>
     <td><img src="https://avatars.githubusercontent.com/u/8344498?s=40&v=4" width="20" height="20" style="vertical-align: middle; margin-right: 8px;"> <a href="https://github.com/schogini/techietalksai"><strong>schogini/techietalksai</strong></a></td>
-    <td>⭐ 21</td>
+    <td>⭐ 24</td>
   </tr>
   <tr>
     <td><img src="https://avatars.githubusercontent.com/u/201161342?s=40&v=4" width="20" height="20" style="vertical-align: middle; margin-right: 8px;"> <a href="https://github.com/autometa-dev/whatsapp-mcp-voice-agent"><strong>autometa-dev/whatsapp-mcp-voice-agent</strong></a></td>
-    <td>⭐ 18</td>
+    <td>⭐ 22</td>
   </tr>
   <tr>
     <td><img src="https://avatars.githubusercontent.com/u/100749943?s=40&v=4" width="20" height="20" style="vertical-align: middle; margin-right: 8px;"> <a href="https://github.com/Deniscartin/mcp-cli"><strong>Deniscartin/mcp-cli</strong></a></td>
-    <td>⭐ 17</td>
-  </tr>
-  <tr>
-    <td><img src="https://avatars.githubusercontent.com/u/6764390?s=40&v=4" width="20" height="20" style="vertical-align: middle; margin-right: 8px;"> <a href="https://github.com/elastic/genai-workshops"><strong>elastic/genai-workshops</strong></a></td>
-    <td>⭐ 9</td>
+    <td>⭐ 18</td>
   </tr>
   <tr>
     <td><img src="https://avatars.githubusercontent.com/u/6688805?s=40&v=4" width="20" height="20" style="vertical-align: middle; margin-right: 8px;"> <a href="https://github.com/innovaccer/Healthcare-MCP"><strong>innovaccer/Healthcare-MCP</strong></a></td>
-    <td>⭐ 6</td>
-  </tr>
-  <tr>
-    <td><img src="https://avatars.githubusercontent.com/u/205593730?s=40&v=4" width="20" height="20" style="vertical-align: middle; margin-right: 8px;"> <a href="https://github.com/Qingyon-AI/Revornix"><strong>Qingyon-AI/Revornix</strong></a></td>
-    <td>⭐ 5</td>
-  </tr>
-  <tr>
-    <td><img src="https://avatars.githubusercontent.com/u/68845761?s=40&v=4" width="20" height="20" style="vertical-align: middle; margin-right: 8px;"> <a href="https://github.com/entbappy/MCP-Tutorials"><strong>entbappy/MCP-Tutorials</strong></a></td>
-    <td>⭐ 5</td>
+    <td>⭐ 15</td>
   </tr>
 </table>
 

{mcp_use-1.3.7 → mcp_use-1.3.8}/README.md

@@ -39,10 +39,9 @@
 
 💡 Let developers easily connect any LLM to tools like web browsing, file operations, and more.
 
-- Visit the [mcp-use.com website](https://mcp-use.com/) to know how to build and deploy MCP agents.
+- If you want to get started quickly check out [mcp-use.com website](https://mcp-use.com/) to build and deploy agents with your favorite MCP servers.
 - Visit the [mcp-use docs](https://docs.mcp-use.com/) to get started with mcp-use library
-
-💬 Get started quickly - chat with your servers on our <b>hosted version</b>! [Try mcp-use chat (beta)](https://chat.mcp-use.com).
+- For the TypeScript version, visit [mcp-use-ts](https://github.com/mcp-use/mcp-use-ts)
 
 | Supports  | |
 | :--- | :--- |
@@ -767,45 +766,45 @@ Thanks to all our amazing contributors!
     <th width="400">Repository</th>
     <th>Stars</th>
   </tr>
+  <tr>
+    <td><img src="https://avatars.githubusercontent.com/u/38653995?s=40&v=4" width="20" height="20" style="vertical-align: middle; margin-right: 8px;"> <a href="https://github.com/patchy631/ai-engineering-hub"><strong>patchy631/ai-engineering-hub</strong></a></td>
+    <td>⭐ 15189</td>
+  </tr>
   <tr>
     <td><img src="https://avatars.githubusercontent.com/u/170207473?s=40&v=4" width="20" height="20" style="vertical-align: middle; margin-right: 8px;"> <a href="https://github.com/tavily-ai/meeting-prep-agent"><strong>tavily-ai/meeting-prep-agent</strong></a></td>
-    <td>⭐ 112</td>
+    <td>⭐ 129</td>
+  </tr>
+  <tr>
+    <td><img src="https://avatars.githubusercontent.com/u/187057607?s=40&v=4" width="20" height="20" style="vertical-align: middle; margin-right: 8px;"> <a href="https://github.com/hud-evals/hud-sdk"><strong>hud-evals/hud-sdk</strong></a></td>
+    <td>⭐ 75</td>
   </tr>
   <tr>
     <td><img src="https://avatars.githubusercontent.com/u/20041231?s=40&v=4" width="20" height="20" style="vertical-align: middle; margin-right: 8px;"> <a href="https://github.com/krishnaik06/MCP-CRASH-Course"><strong>krishnaik06/MCP-CRASH-Course</strong></a></td>
-    <td>⭐ 37</td>
+    <td>⭐ 58</td>
+  </tr>
+  <tr>
+    <td><img src="https://avatars.githubusercontent.com/u/54944174?s=40&v=4" width="20" height="20" style="vertical-align: middle; margin-right: 8px;"> <a href="https://github.com/larksuite/lark-samples"><strong>larksuite/lark-samples</strong></a></td>
+    <td>⭐ 31</td>
   </tr>
   <tr>
     <td><img src="https://avatars.githubusercontent.com/u/892404?s=40&v=4" width="20" height="20" style="vertical-align: middle; margin-right: 8px;"> <a href="https://github.com/truemagic-coder/solana-agent-app"><strong>truemagic-coder/solana-agent-app</strong></a></td>
-    <td>⭐ 29</td>
+    <td>⭐ 30</td>
   </tr>
   <tr>
     <td><img src="https://avatars.githubusercontent.com/u/8344498?s=40&v=4" width="20" height="20" style="vertical-align: middle; margin-right: 8px;"> <a href="https://github.com/schogini/techietalksai"><strong>schogini/techietalksai</strong></a></td>
-    <td>⭐ 21</td>
+    <td>⭐ 24</td>
   </tr>
   <tr>
     <td><img src="https://avatars.githubusercontent.com/u/201161342?s=40&v=4" width="20" height="20" style="vertical-align: middle; margin-right: 8px;"> <a href="https://github.com/autometa-dev/whatsapp-mcp-voice-agent"><strong>autometa-dev/whatsapp-mcp-voice-agent</strong></a></td>
-    <td>⭐ 18</td>
+    <td>⭐ 22</td>
   </tr>
   <tr>
     <td><img src="https://avatars.githubusercontent.com/u/100749943?s=40&v=4" width="20" height="20" style="vertical-align: middle; margin-right: 8px;"> <a href="https://github.com/Deniscartin/mcp-cli"><strong>Deniscartin/mcp-cli</strong></a></td>
-    <td>⭐ 17</td>
-  </tr>
-  <tr>
-    <td><img src="https://avatars.githubusercontent.com/u/6764390?s=40&v=4" width="20" height="20" style="vertical-align: middle; margin-right: 8px;"> <a href="https://github.com/elastic/genai-workshops"><strong>elastic/genai-workshops</strong></a></td>
-    <td>⭐ 9</td>
+    <td>⭐ 18</td>
   </tr>
   <tr>
     <td><img src="https://avatars.githubusercontent.com/u/6688805?s=40&v=4" width="20" height="20" style="vertical-align: middle; margin-right: 8px;"> <a href="https://github.com/innovaccer/Healthcare-MCP"><strong>innovaccer/Healthcare-MCP</strong></a></td>
-    <td>⭐ 6</td>
-  </tr>
-  <tr>
-    <td><img src="https://avatars.githubusercontent.com/u/205593730?s=40&v=4" width="20" height="20" style="vertical-align: middle; margin-right: 8px;"> <a href="https://github.com/Qingyon-AI/Revornix"><strong>Qingyon-AI/Revornix</strong></a></td>
-    <td>⭐ 5</td>
-  </tr>
-  <tr>
-    <td><img src="https://avatars.githubusercontent.com/u/68845761?s=40&v=4" width="20" height="20" style="vertical-align: middle; margin-right: 8px;"> <a href="https://github.com/entbappy/MCP-Tutorials"><strong>entbappy/MCP-Tutorials</strong></a></td>
-    <td>⭐ 5</td>
+    <td>⭐ 15</td>
   </tr>
 </table>
 

{mcp_use-1.3.7/docs/guides → mcp_use-1.3.8/docs/advanced}/multi-server-setup.mdx

@@ -439,10 +439,10 @@ agent = MCPAgent(
 ## Next Steps
 
 <CardGroup cols={3}>
-  <Card title="Server Manager" icon="server" href="/essentials/server-manager">
+  <Card title="Server Manager" icon="server" href="/agent/server-manager">
     Learn more about dynamic server selection and management
   </Card>
-  <Card title="Security Guide" icon="shield" href="/guides/security">
+  <Card title="Security Guide" icon="shield" href="/advanced/security">
     Best practices for secure multi-server configurations
   </Card>
   <Card title="Performance" icon="zap" href="/troubleshooting/performance">

{mcp_use-1.3.7/docs/guides → mcp_use-1.3.8/docs/advanced}/security.mdx

@@ -580,7 +580,7 @@ def secure_command_args(command: str, args: List[str]) -> List[str]:
 ## Next Steps
 
 <CardGroup cols={3}>
-  <Card title="Configuration Guide" icon="gear" href="/essentials/configuration">
+  <Card title="Configuration Guide" icon="gear" href="/getting-started/configuration">
     Learn secure configuration practices for MCP servers
   </Card>
   <Card title="Deployment Guide" icon="rocket" href="/development">

{mcp_use-1.3.7/docs/essentials → mcp_use-1.3.8/docs/agent}/agent-configuration.mdx

@@ -7,7 +7,7 @@ icon: "brain"
 # Agent Configuration
 
 <Info>
-This guide covers MCPAgent configuration options for customizing agent behavior and LLM integration. For client configuration, see the [Client Configuration](/essentials/client-configuration) guide.
+This guide covers MCPAgent configuration options for customizing agent behavior and LLM integration. For client configuration, see the [Client Configuration](/client/client-configuration) guide.
 </Info>
 
 ## API Keys

mcp_use-1.3.8/docs/agent/server-manager.mdx

@@ -0,0 +1,215 @@
+---
+title: 'Server Manager'
+description: 'Intelligent management of multiple MCP servers and dynamic tool discovery'
+icon: 'server-cog'
+---
+
+# Server Manager: Dynamic Multi-Server Intelligence
+
+The Server Manager is the brain behind intelligent MCP server orchestration. It transforms your agent from a static tool user into a dynamic, adaptive assistant that can discover, connect to, and intelligently utilize tools from multiple MCP servers on-demand.
+
+## 🎯 What Makes It Special
+
+Instead of overwhelming your agent with hundreds of tools from all servers at once, the Server Manager:
+
+- **Dynamically loads tools** only when needed, with full schemas
+- **Intelligently discovers** the right server for each task
+- **Automatically updates** available tools as connections change
+- **Provides semantic search** across all server tools
+- **Manages connection lifecycle** efficiently
+
+## 🏗️ Architecture Overview
+
+```mermaid
+graph TB
+    Agent[MCPAgent] --> SM[ServerManager]
+    SM --> S1[Web Server]
+    SM --> S2[File Server]
+    SM --> S3[Database Server]
+
+    SM --> Tools[Dynamic Tools]
+```
+
+## 🔄 Dynamic Tool Loading Process
+
+```mermaid
+sequenceDiagram
+    Agent->>ServerManager: Connect to server
+    ServerManager->>Server: Get tools
+    Server->>ServerManager: Return tools
+    ServerManager->>Agent: Tools now available
+    Agent->>Server: Use tools directly
+```
+
+## 🚀 Getting Started
+
+Enable the Server Manager in your agent:
+
+```python
+from mcp_use import MCPClient, MCPAgent
+from langchain_openai import ChatOpenAI
+
+# Create client with multiple servers
+client = MCPClient.from_dict({
+    "mcpServers": {
+        "playwright": {
+            "command": "npx",
+            "args": ["@playwright/mcp@latest"]
+        },
+        "filesystem": {
+            "command": "uvx",
+            "args": ["mcp-server-filesystem", "/tmp"]
+        }
+    }
+})
+
+# 🎯 Enable Server Manager
+agent = MCPAgent(
+    llm=ChatOpenAI(model="gpt-4"),
+    client=client,
+    use_server_manager=True  # ✨ This is the magic switch!
+)
+```
+
+## 🔍 Tool Discovery Flow
+
+
+
+
+## 🛠️ Management Tools Deep Dive
+
+### Core Server Management
+
+| Tool | Purpose | Example |
+|------|---------|---------|
+| `list_mcp_servers` | Discovery of available servers and their tools | "What servers do I have access to?" |
+| `connect_to_mcp_server` | Activate a server and load its tools | "Connect to the filesystem server" |
+| `get_active_mcp_server` | Check current connection status | "Which server am I currently using?" |
+| `disconnect_from_mcp_server` | Deactivate server and remove its tools | "Disconnect from current server" |
+| `search_mcp_tools` | Semantic search across all server tools | "Find tools for image processing" |
+
+### Smart Tool Search Example
+
+```python
+# Agent automatically discovers and uses the right tools
+result = await agent.run("""
+I need to:
+1. Find tools for web scraping
+2. Connect to the right server
+3. Scrape data from https://example.com
+4. Save it to a file
+
+Start by searching for relevant tools.
+""")
+```
+
+**Agent Process:**
+```mermaid
+graph LR
+    Search[Search Tools] --> Connect[Connect Server]
+    Connect --> Use[Use Tools]
+```
+
+## 🎭 Real-World Use Cases
+
+### 1. Multi-Server Data Pipeline
+
+```python
+result = await agent.run("""
+Create a data pipeline that:
+1. Scrapes product data from an e-commerce site
+2. Processes and cleans the data
+3. Saves it to a CSV file
+4. Loads it into a SQLite database
+
+Figure out which servers and tools you need.
+""")
+```
+
+**Server Flow:**
+```
+playwright → filesystem → database
+    ↓            ↓          ↓
+ scraping → save CSV → load data
+```
+
+### 2. Content Creation Workflow
+
+```python
+result = await agent.run("""
+I want to:
+1. Search for trending topics online
+2. Generate an image based on the topic
+3. Write a blog post about it
+4. Save everything to files
+
+What tools do I need for this?
+""")
+```
+
+## 🚀 Performance Benefits
+
+The Server Manager provides focused tool access:
+
+- **Without Server Manager**: All 100+ tools from all servers loaded at once, overwhelming the model
+- **With Server Manager**: Only 5-15 relevant tools from the active server, providing clear focus
+
+##  Core Features
+
+The Server Manager provides these powerful capabilities:
+
+- **🔗 Dynamic Tool Addition**: Server tools automatically added with full schemas
+- **⚡ Real-time Updates**: Tool list updates immediately when connecting/disconnecting
+- **🧹 Clean Architecture**: Direct tool access with proper schemas
+- **🎯 Model Understanding**: Tools come with native schemas and validation
+- **📊 Smart Logging**: Detailed insights into tool changes and server status
+
+## 🏁 Complete Example
+
+```python
+import asyncio
+from mcp_use import MCPClient, MCPAgent
+from langchain_openai import ChatOpenAI
+
+async def demo_server_manager():
+    # Multi-server configuration
+    client = MCPClient.from_dict({
+        "mcpServers": {
+            "web": {"command": "npx", "args": ["@playwright/mcp@latest"]},
+            "files": {"command": "uvx", "args": ["mcp-server-filesystem", "/tmp"]},
+            "database": {"command": "uvx", "args": ["mcp-server-sqlite"]}
+        }
+    })
+
+    # Agent with Server Manager
+    agent = MCPAgent(
+        llm=ChatOpenAI(model="gpt-4"),
+        client=client,
+        use_server_manager=True,
+        verbose=True  # See the magic happen!
+    )
+
+    # Complex multi-server task
+    result = await agent.run("""
+    I need to build a complete data collection system:
+
+    1. First, show me what servers and tools are available
+    2. Scrape product information from https://example-store.com
+    3. Clean and structure the data
+    4. Save it as both JSON and CSV files
+    5. Load the data into a SQLite database
+    6. Generate a summary report
+
+    Guide me through each step and show me how you discover and use the right tools.
+    """)
+
+    print("🎉 Task completed!")
+    print(result)
+
+    await agent.close()
+
+if __name__ == "__main__":
+    asyncio.run(demo_server_manager())
+```
+
+The Server Manager transforms your MCP agent from a static tool user into an intelligent, adaptive assistant that can dynamically discover and utilize the perfect tools for any task! 🚀

{mcp_use-1.3.7/docs/guides → mcp_use-1.3.8/docs/agent}/streaming.mdx

@@ -284,10 +284,10 @@ if __name__ == "__main__":
 ## Next Steps
 
 <CardGroup cols={3}>
-  <Card title="Agent Configuration" icon="gear" href="/essentials/configuration">
+  <Card title="Agent Configuration" icon="gear" href="/agent/agent-configuration">
     Learn more about configuring agents for optimal streaming performance
   </Card>
-  <Card title="Multi-Server Setup" icon="server" href="/guides/multi-server-setup">
+  <Card title="Multi-Server Setup" icon="server" href="/advanced/multi-server-setup">
     Stream output from agents using multiple MCP servers
   </Card>
   <Card title="Performance Optimization" icon="zap" href="/troubleshooting/performance">

mcp_use-1.3.8/docs/agent/structured-output.mdx

@@ -0,0 +1,61 @@
+---
+title: "Agent Structured Output"
+description: "Get strongly-typed Pydantic models with intelligent retry logic"
+icon: "shapes"
+---
+
+# Agent Structured Output
+
+The MCPAgent supports structured output, allowing you to get strongly-typed Pydantic models instead of plain text responses. The agent becomes **schema-aware** and will intelligently retry to gather missing information until all required fields can be populated.
+
+## How it Works
+
+When you provide an `output_schema` parameter, the agent:
+
+1. **Understands requirements** - The agent knows exactly what information it needs to collect
+2. **Attempts structured output** - At completion points, tries to format the result into your schema
+3. **Intelligently retries** - If required fields are missing, continues execution to gather the missing data
+4. **Validates completeness** - Only finishes when all required fields can be populated
+
+## Basic Example
+
+```python
+import asyncio
+from pydantic import BaseModel, Field
+from langchain_openai import ChatOpenAI
+from mcp_use import MCPAgent, MCPClient
+
+class WeatherInfo(BaseModel):
+    """Weather information for a location"""
+    city: str = Field(description="City name")
+    temperature: float = Field(description="Temperature in Celsius")
+    condition: str = Field(description="Weather condition")
+    humidity: int = Field(description="Humidity percentage")
+
+async def main():
+    # Setup client and agent
+    client = MCPClient(config={"mcpServers": {...}})
+    llm = ChatOpenAI(model="gpt-4o")
+    agent = MCPAgent(llm=llm, client=client)
+
+    # Get structured output
+    weather: WeatherInfo = await agent.run(
+        "Get the current weather in San Francisco",
+        output_schema=WeatherInfo
+    )
+
+    print(f"Temperature in {weather.city}: {weather.temperature}°C")
+    print(f"Condition: {weather.condition}")
+    print(f"Humidity: {weather.humidity}%")
+
+asyncio.run(main())
+```
+
+## Key Benefits
+
+- **Type Safety**: Get Pydantic models with full IDE support and validation
+- **Intelligent Gathering**: Agent knows what information is required and won't stop until it has everything
+- **Automatic Retry**: Missing fields trigger continued execution automatically
+- **Field Validation**: Built-in validation for required fields, data types, and constraints
+
+The agent will continue working until all required fields in your schema can be populated, ensuring you always get complete, structured data.

{mcp_use-1.3.7 → mcp_use-1.3.8}/docs/api-reference/mcpclient.mdx

@@ -488,5 +488,5 @@ async def multi_server_example():
 ## See Also
 
 - [MCPAgent API Reference](/api-reference/mcpagent) - High-level agent interface
-- [Configuration Guide](/essentials/configuration) - Detailed configuration options
-- [Connection Types](/essentials/connection-types) - Understanding different server types
+- [Configuration Guide](/getting-started/configuration) - Detailed configuration options
+- [Connection Types](/client/connection-types) - Understanding different server types

{mcp_use-1.3.7/docs/essentials → mcp_use-1.3.8/docs/client}/client-configuration.mdx

@@ -7,7 +7,7 @@ icon: "server"
 # Client Configuration
 
 <Info>
-This guide covers MCPClient configuration options for connecting to MCP servers. For agent configuration, see the [Agent Configuration](/essentials/agent-configuration) guide.
+This guide covers MCPClient configuration options for connecting to MCP servers. For agent configuration, see the [Agent Configuration](/agent/agent-configuration) guide.
 </Info>
 
 

{mcp_use-1.3.7 → mcp_use-1.3.8}/docs/community/showcase.mdx

@@ -191,6 +191,6 @@ We review submissions regularly and feature projects that provide value to the m
 
 ## Further Reading
 
-- [Building Custom Agents](/guides/building-custom-agents) - Comprehensive guide to creating custom agents with mcp-use
-- [Multi-Server Setup](/guides/multi-server-setup) - Learn how to orchestrate multiple MCP servers
+- [Building Custom Agents](/advanced/building-custom-agents) - Comprehensive guide to creating custom agents with mcp-use
+- [Multi-Server Setup](/advanced/multi-server-setup) - Learn how to orchestrate multiple MCP servers
 - [Examples Repository](https://github.com/mcp-use/mcp-use/tree/main/examples) - Official collection of usage examples

{mcp_use-1.3.7 → mcp_use-1.3.8}/docs/docs.json

@@ -42,23 +42,23 @@
           {
             "group": "Getting Started",
             "pages": [
-              "index",
-              "quickstart",
-              "installation"
+              "getting-started/index",
+              "getting-started/quickstart",
+              "getting-started/installation",
+              "getting-started/configuration"
             ]
           },
           {
             "group": "Client Configuration",
             "pages": [
-              "essentials/configuration",
-              "essentials/client-configuration",
+              "client/client-configuration",
               {
                 "group": "Client Features",
                 "icon": "list-plus",
                 "pages": [
-                  "essentials/connection-types",
-                  "essentials/sampling",
-                  "essentials/elicitation"
+                  "client/connection-types",
+                  "client/sampling",
+                  "client/elicitation"
                 ]
               }
             ]
@@ -66,19 +66,20 @@
           {
             "group": "Agent Configuration",
             "pages": [
-              "essentials/agent-configuration",
-              "essentials/server-manager",
-              "essentials/llm-integration",
-              "guides/streaming"
+              "agent/agent-configuration",
+              "agent/llm-integration",
+              "agent/server-manager",
+              "agent/streaming",
+              "agent/structured-output"
             ]
           },
           {
             "group": "Advanced Usage",
             "pages": [
-              "guides/building-custom-agents",
-              "guides/logging",
-              "guides/multi-server-setup",
-              "guides/security"
+              "advanced/building-custom-agents",
+              "advanced/logging",
+              "advanced/multi-server-setup",
+              "advanced/security"
             ]
           },
           {