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

mcp_use-1.3.8/.github/workflows/publish.yml

@@ -0,0 +1,81 @@
+name: Release
+
+on:
+  release:
+    types: [published]
+
+# Required for PyPI trusted publishing
+permissions:
+  id-token: write
+  contents: read
+
+jobs:
+  check-version-and-publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+        with:
+          fetch-depth: 0
+
+      - name: Set up Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: "3.11"
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install build twine wheel tomli
+
+      - name: Verify version match
+        id: check-version
+        run: |
+          # Extract current version from pyproject.toml
+          PYPROJECT_VERSION=$(python -c "
+          import tomli
+          with open('pyproject.toml', 'rb') as f:
+              data = tomli.load(f)
+          print(data['project']['version'])
+          ")
+
+          # Get release tag version (remove 'v' prefix if present)
+          RELEASE_VERSION="${{ github.event.release.tag_name }}"
+          RELEASE_VERSION=${RELEASE_VERSION#v}
+
+          echo "PyProject version: $PYPROJECT_VERSION"
+          echo "Release version: $RELEASE_VERSION"
+
+          if [ "$PYPROJECT_VERSION" = "$RELEASE_VERSION" ]; then
+            echo "✅ Versions match! Proceeding with PyPI publish"
+            echo "should_publish=true" >> $GITHUB_OUTPUT
+            echo "version=$PYPROJECT_VERSION" >> $GITHUB_OUTPUT
+          else
+            echo "❌ Version mismatch! PyProject: $PYPROJECT_VERSION, Release: $RELEASE_VERSION"
+            echo "should_publish=false" >> $GITHUB_OUTPUT
+            exit 1
+          fi
+
+      - name: Build package
+        if: steps.check-version.outputs.should_publish == 'true'
+        run: |
+          python -m build
+
+      - name: Check if already published to PyPI
+        if: steps.check-version.outputs.should_publish == 'true'
+        id: check-pypi
+        run: |
+          # Check if this version exists on PyPI
+          VERSION="${{ steps.check-version.outputs.version }}"
+          if pip index versions mcp-use | grep -q "Available versions: .*$VERSION"; then
+            echo "Version $VERSION already exists on PyPI"
+            echo "publish_needed=false" >> $GITHUB_OUTPUT
+          else
+            echo "Version $VERSION not found on PyPI, will publish"
+            echo "publish_needed=true" >> $GITHUB_OUTPUT
+          fi
+
+      - name: Publish to PyPI
+        if: steps.check-pypi.outputs.publish_needed == 'true'
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          password: ${{ secrets.PYPI_API_TOKEN }}

mcp_use-1.3.8/.github/workflows/tests.yml

@@ -0,0 +1,115 @@
+name: Tests
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  lint:
+    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 dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install ruff
+      - name: Lint with ruff
+        run: |
+          ruff check .
+      - name: Format check with ruff
+        run: |
+          ruff format --check .
+
+  unit-tests:
+    needs: lint
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.11", "3.12"]
+    steps:
+      - uses: actions/checkout@v3
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v4
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install .[dev,anthropic,openai,search,e2b]
+      - name: Test with pytest
+        run: |
+          pytest tests/unit
+
+  transport-tests:
+    needs: lint
+    name: "transport/${{ matrix.transport }}"
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        transport: [stdio, sse, streamable_http]
+    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 integration tests for ${{ matrix.transport }} transport
+        run: |
+          pytest tests/integration/transports/test_${{ matrix.transport }}.py
+
+  primitive-tests:
+    needs: lint
+    name: "primitive/${{ matrix.primitive }}"
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        primitive: [sampling, tools, resources, prompts, elicitation]
+    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 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.6 → 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.6 → mcp_use-1.3.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mcp-use
-Version: 1.3.6
+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
@@ -28,7 +28,7 @@ Requires-Dist: langchain-anthropic; extra == 'anthropic'
 Provides-Extra: dev
 Requires-Dist: black>=23.9.0; extra == 'dev'
 Requires-Dist: fastapi; extra == 'dev'
-Requires-Dist: fastmcp==2.8.0; extra == 'dev'
+Requires-Dist: fastmcp==2.10.5; extra == 'dev'
 Requires-Dist: isort>=5.12.0; extra == 'dev'
 Requires-Dist: mypy>=1.5.0; extra == 'dev'
 Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
@@ -84,12 +84,16 @@ 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
+- For the TypeScript version, visit [mcp-use-ts](https://github.com/mcp-use/mcp-use-ts)
 
-💬 Get started quickly - chat with your servers on our <b>hosted version</b>! [Try mcp-use chat (beta)](https://chat.mcp-use.com).
+| Supports  | |
+| :--- | :--- |
+| **Primitives** | [![Tools](https://img.shields.io/github/actions/workflow/status/pietrozullo/mcp-use/tests.yml?job=primitive-tools&label=Tools&style=flat)](https://github.com/pietrozullo/mcp-use/actions/workflows/tests.yml) [![Resources](https://img.shields.io/github/actions/workflow/status/pietrozullo/mcp-use/tests.yml?job=primitive-resources&label=Resources&style=flat)](https://github.com/pietrozullo/mcp-use/actions/workflows/tests.yml) [![Prompts](https://img.shields.io/github/actions/workflow/status/pietrozullo/mcp-use/tests.yml?job=primitive-prompts&label=Prompts&style=flat)](https://github.com/pietrozullo/mcp-use/actions/workflows/tests.yml) [![Sampling](https://img.shields.io/github/actions/workflow/status/pietrozullo/mcp-use/tests.yml?job=primitive-sampling&label=Sampling&style=flat)](https://github.com/pietrozullo/mcp-use/actions/workflows/tests.yml) [![Elicitation](https://img.shields.io/github/actions/workflow/status/pietrozullo/mcp-use/tests.yml?job=primitive-elicitation&label=Elicitation&style=flat)](https://github.com/pietrozullo/mcp-use/actions/workflows/tests.yml) |
+| **Transports** | [![Stdio](https://img.shields.io/github/actions/workflow/status/pietrozullo/mcp-use/tests.yml?job=transport-stdio&label=Stdio&style=flat)](https://github.com/pietrozullo/mcp-use/actions/workflows/tests.yml) [![SSE](https://img.shields.io/github/actions/workflow/status/pietrozullo/mcp-use/tests.yml?job=transport-sse&label=SSE&style=flat)](https://github.com/pietrozullo/mcp-use/actions/workflows/tests.yml) [![Streamable HTTP](https://img.shields.io/github/actions/workflow/status/pietrozullo/mcp-use/tests.yml?job=transport-streamableHttp&label=Streamable%20HTTP&style=flat)](https://github.com/pietrozullo/mcp-use/actions/workflows/tests.yml) |
 
-# Features
+## Features
 
 <table>
   <tr>
@@ -807,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.6 → mcp_use-1.3.8}/README.md

@@ -39,12 +39,16 @@
 
 💡 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
+- For the TypeScript version, visit [mcp-use-ts](https://github.com/mcp-use/mcp-use-ts)
 
-💬 Get started quickly - chat with your servers on our <b>hosted version</b>! [Try mcp-use chat (beta)](https://chat.mcp-use.com).
+| Supports  | |
+| :--- | :--- |
+| **Primitives** | [![Tools](https://img.shields.io/github/actions/workflow/status/pietrozullo/mcp-use/tests.yml?job=primitive-tools&label=Tools&style=flat)](https://github.com/pietrozullo/mcp-use/actions/workflows/tests.yml) [![Resources](https://img.shields.io/github/actions/workflow/status/pietrozullo/mcp-use/tests.yml?job=primitive-resources&label=Resources&style=flat)](https://github.com/pietrozullo/mcp-use/actions/workflows/tests.yml) [![Prompts](https://img.shields.io/github/actions/workflow/status/pietrozullo/mcp-use/tests.yml?job=primitive-prompts&label=Prompts&style=flat)](https://github.com/pietrozullo/mcp-use/actions/workflows/tests.yml) [![Sampling](https://img.shields.io/github/actions/workflow/status/pietrozullo/mcp-use/tests.yml?job=primitive-sampling&label=Sampling&style=flat)](https://github.com/pietrozullo/mcp-use/actions/workflows/tests.yml) [![Elicitation](https://img.shields.io/github/actions/workflow/status/pietrozullo/mcp-use/tests.yml?job=primitive-elicitation&label=Elicitation&style=flat)](https://github.com/pietrozullo/mcp-use/actions/workflows/tests.yml) |
+| **Transports** | [![Stdio](https://img.shields.io/github/actions/workflow/status/pietrozullo/mcp-use/tests.yml?job=transport-stdio&label=Stdio&style=flat)](https://github.com/pietrozullo/mcp-use/actions/workflows/tests.yml) [![SSE](https://img.shields.io/github/actions/workflow/status/pietrozullo/mcp-use/tests.yml?job=transport-sse&label=SSE&style=flat)](https://github.com/pietrozullo/mcp-use/actions/workflows/tests.yml) [![Streamable HTTP](https://img.shields.io/github/actions/workflow/status/pietrozullo/mcp-use/tests.yml?job=transport-streamableHttp&label=Streamable%20HTTP&style=flat)](https://github.com/pietrozullo/mcp-use/actions/workflows/tests.yml) |
 
-# Features
+## Features
 
 <table>
   <tr>
@@ -762,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.6/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.6/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.6/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! 🚀