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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.

This version of mcp-use might be problematic. Click here for more details.

Files changed (175) hide show
  1. {mcp_use-1.3.7 → mcp_use-1.3.9}/.github/release-drafter.yml +2 -2
  2. {mcp_use-1.3.7 → mcp_use-1.3.9}/.github/workflows/tests.yml +23 -3
  3. {mcp_use-1.3.7 → mcp_use-1.3.9}/.github/workflows/update-readme.yml +3 -1
  4. {mcp_use-1.3.7 → mcp_use-1.3.9}/PKG-INFO +80 -57
  5. {mcp_use-1.3.7 → mcp_use-1.3.9}/README.md +78 -55
  6. {mcp_use-1.3.7/docs/guides → mcp_use-1.3.9/docs/advanced}/multi-server-setup.mdx +2 -2
  7. {mcp_use-1.3.7/docs/guides → mcp_use-1.3.9/docs/advanced}/security.mdx +1 -1
  8. {mcp_use-1.3.7/docs/essentials → mcp_use-1.3.9/docs/agent}/agent-configuration.mdx +1 -1
  9. mcp_use-1.3.9/docs/agent/server-manager.mdx +215 -0
  10. {mcp_use-1.3.7/docs/guides → mcp_use-1.3.9/docs/agent}/streaming.mdx +2 -2
  11. mcp_use-1.3.9/docs/agent/structured-output.mdx +61 -0
  12. {mcp_use-1.3.7 → mcp_use-1.3.9}/docs/api-reference/mcpagent.mdx +46 -6
  13. {mcp_use-1.3.7 → mcp_use-1.3.9}/docs/api-reference/mcpclient.mdx +2 -2
  14. {mcp_use-1.3.7/docs/essentials → mcp_use-1.3.9/docs/client}/client-configuration.mdx +13 -106
  15. {mcp_use-1.3.7/docs/essentials → mcp_use-1.3.9/docs/client}/connection-types.mdx +2 -21
  16. mcp_use-1.3.9/docs/client/direct-tool-calls.mdx +235 -0
  17. {mcp_use-1.3.7/docs/essentials → mcp_use-1.3.9/docs/client}/elicitation.mdx +2 -2
  18. mcp_use-1.3.9/docs/client/logging.mdx +61 -0
  19. mcp_use-1.3.9/docs/client/notifications.mdx +111 -0
  20. mcp_use-1.3.9/docs/client/prompts.mdx +266 -0
  21. mcp_use-1.3.9/docs/client/resources.mdx +229 -0
  22. mcp_use-1.3.9/docs/client/sandbox.mdx +81 -0
  23. mcp_use-1.3.9/docs/client/tools.mdx +160 -0
  24. {mcp_use-1.3.7 → mcp_use-1.3.9}/docs/community/showcase.mdx +2 -2
  25. {mcp_use-1.3.7 → mcp_use-1.3.9}/docs/docs.json +37 -17
  26. {mcp_use-1.3.7/docs/essentials → mcp_use-1.3.9/docs/getting-started}/configuration.mdx +7 -7
  27. {mcp_use-1.3.7/docs → mcp_use-1.3.9/docs/getting-started}/index.mdx +14 -14
  28. {mcp_use-1.3.7/docs → mcp_use-1.3.9/docs/getting-started}/installation.mdx +3 -3
  29. {mcp_use-1.3.7/docs → mcp_use-1.3.9/docs/getting-started}/quickstart.mdx +3 -3
  30. {mcp_use-1.3.7 → mcp_use-1.3.9}/docs/troubleshooting/performance.mdx +2 -2
  31. {mcp_use-1.3.7 → mcp_use-1.3.9}/examples/airbnb_use.py +10 -15
  32. mcp_use-1.3.9/examples/direct_tool_call.py +59 -0
  33. {mcp_use-1.3.7 → mcp_use-1.3.9}/examples/stream_example.py +5 -2
  34. mcp_use-1.3.9/examples/structured_output.py +78 -0
  35. {mcp_use-1.3.7 → mcp_use-1.3.9}/mcp_use/__init__.py +0 -1
  36. {mcp_use-1.3.7 → mcp_use-1.3.9}/mcp_use/adapters/base.py +3 -3
  37. {mcp_use-1.3.7 → mcp_use-1.3.9}/mcp_use/adapters/langchain_adapter.py +5 -4
  38. {mcp_use-1.3.7 → mcp_use-1.3.9}/mcp_use/agents/__init__.py +2 -2
  39. {mcp_use-1.3.7 → mcp_use-1.3.9}/mcp_use/agents/mcpagent.py +257 -31
  40. mcp_use-1.3.9/mcp_use/agents/prompts/templates.py +41 -0
  41. mcp_use-1.3.9/mcp_use/agents/remote.py +296 -0
  42. {mcp_use-1.3.7 → mcp_use-1.3.9}/mcp_use/client.py +20 -3
  43. {mcp_use-1.3.7 → mcp_use-1.3.9}/mcp_use/config.py +12 -8
  44. {mcp_use-1.3.7 → mcp_use-1.3.9}/mcp_use/connectors/base.py +100 -15
  45. {mcp_use-1.3.7 → mcp_use-1.3.9}/mcp_use/connectors/http.py +13 -2
  46. {mcp_use-1.3.7 → mcp_use-1.3.9}/mcp_use/connectors/sandbox.py +12 -6
  47. {mcp_use-1.3.7 → mcp_use-1.3.9}/mcp_use/connectors/stdio.py +11 -2
  48. mcp_use-1.3.9/mcp_use/errors/__init__.py +1 -0
  49. mcp_use-1.3.9/mcp_use/errors/error_formatting.py +29 -0
  50. {mcp_use-1.3.7 → mcp_use-1.3.9}/mcp_use/managers/__init__.py +3 -5
  51. {mcp_use-1.3.7 → mcp_use-1.3.9}/mcp_use/managers/server_manager.py +46 -13
  52. {mcp_use-1.3.7 → mcp_use-1.3.9}/mcp_use/managers/tools/__init__.py +2 -4
  53. {mcp_use-1.3.7 → mcp_use-1.3.9}/mcp_use/managers/tools/connect_server.py +2 -1
  54. {mcp_use-1.3.7 → mcp_use-1.3.9}/mcp_use/managers/tools/disconnect_server.py +2 -1
  55. {mcp_use-1.3.7 → mcp_use-1.3.9}/mcp_use/managers/tools/list_servers_tool.py +2 -0
  56. {mcp_use-1.3.7 → mcp_use-1.3.9}/mcp_use/session.py +70 -0
  57. {mcp_use-1.3.7 → mcp_use-1.3.9}/mcp_use/telemetry/telemetry.py +1 -4
  58. {mcp_use-1.3.7 → mcp_use-1.3.9}/pyproject.toml +2 -2
  59. mcp_use-1.3.9/static/logo-gh.jpg +0 -0
  60. {mcp_use-1.3.7/tests/integration/transports/customStreaming → mcp_use-1.3.9/tests/integration/others}/test_custom_streaming_integration.py +10 -10
  61. mcp_use-1.3.9/tests/integration/primitives/test_discovery.py +70 -0
  62. {mcp_use-1.3.7 → mcp_use-1.3.9}/tests/integration/primitives/test_elicitation.py +1 -1
  63. mcp_use-1.3.9/tests/integration/primitives/test_logging.py +21 -0
  64. mcp_use-1.3.9/tests/integration/primitives/test_notifications.py +22 -0
  65. {mcp_use-1.3.7 → mcp_use-1.3.9}/tests/integration/primitives/test_prompts.py +1 -1
  66. {mcp_use-1.3.7 → mcp_use-1.3.9}/tests/integration/primitives/test_resources.py +3 -3
  67. {mcp_use-1.3.7 → mcp_use-1.3.9}/tests/integration/primitives/test_sampling.py +2 -2
  68. {mcp_use-1.3.7 → mcp_use-1.3.9}/tests/integration/primitives/test_tools.py +3 -8
  69. {mcp_use-1.3.7 → mcp_use-1.3.9}/tests/integration/servers_for_testing/primitive_server.py +71 -0
  70. mcp_use-1.3.7/tests/integration/transports/sse/test_sse_integration.py → mcp_use-1.3.9/tests/integration/transports/test_sse.py +3 -3
  71. mcp_use-1.3.7/tests/integration/transports/stdio/test_stdio_integration.py → mcp_use-1.3.9/tests/integration/transports/test_stdio.py +3 -3
  72. mcp_use-1.3.7/tests/integration/transports/streamableHttp/test_streamable_http_integration.py → mcp_use-1.3.9/tests/integration/transports/test_streamable_http.py +3 -3
  73. {mcp_use-1.3.7 → mcp_use-1.3.9}/tests/unit/test_client.py +62 -0
  74. {mcp_use-1.3.7 → mcp_use-1.3.9}/tests/unit/test_http_connector.py +2 -0
  75. {mcp_use-1.3.7 → mcp_use-1.3.9}/tests/unit/test_sandbox_connector.py +2 -0
  76. {mcp_use-1.3.7 → mcp_use-1.3.9}/tests/unit/test_stdio_connector.py +2 -0
  77. mcp_use-1.3.7/docs/essentials/server-manager.mdx +0 -343
  78. mcp_use-1.3.7/mcp_use/agents/prompts/templates.py +0 -43
  79. mcp_use-1.3.7/mcp_use/managers/tools/use_tool.py +0 -154
  80. mcp_use-1.3.7/tests/integration/transports/customStreaming/__init__.py +0 -1
  81. {mcp_use-1.3.7 → mcp_use-1.3.9}/.env.example +0 -0
  82. {mcp_use-1.3.7 → mcp_use-1.3.9}/.github/ISSUE_TEMPLATE/bug_report.md +0 -0
  83. {mcp_use-1.3.7 → mcp_use-1.3.9}/.github/pull_request_template.md +0 -0
  84. {mcp_use-1.3.7 → mcp_use-1.3.9}/.github/workflows/changelog.yml +0 -0
  85. {mcp_use-1.3.7 → mcp_use-1.3.9}/.github/workflows/publish.yml +0 -0
  86. {mcp_use-1.3.7 → mcp_use-1.3.9}/.github/workflows/release-drafter.yml +0 -0
  87. {mcp_use-1.3.7 → mcp_use-1.3.9}/.github/workflows/stale.yml +0 -0
  88. {mcp_use-1.3.7 → mcp_use-1.3.9}/.gitignore +0 -0
  89. {mcp_use-1.3.7 → mcp_use-1.3.9}/.pre-commit-config.yaml +0 -0
  90. {mcp_use-1.3.7 → mcp_use-1.3.9}/CHANGELOG.md +0 -0
  91. {mcp_use-1.3.7 → mcp_use-1.3.9}/CLAUDE.md +0 -0
  92. {mcp_use-1.3.7 → mcp_use-1.3.9}/CODE_OF_CONDUCT.md +0 -0
  93. {mcp_use-1.3.7 → mcp_use-1.3.9}/CONTRIBUTING.md +0 -0
  94. {mcp_use-1.3.7 → mcp_use-1.3.9}/LICENSE +0 -0
  95. {mcp_use-1.3.7 → mcp_use-1.3.9}/docs/README.md +0 -0
  96. {mcp_use-1.3.7/docs/guides → mcp_use-1.3.9/docs/advanced}/building-custom-agents.mdx +0 -0
  97. {mcp_use-1.3.7/docs/guides → mcp_use-1.3.9/docs/advanced}/logging.mdx +0 -0
  98. {mcp_use-1.3.7/docs/essentials → mcp_use-1.3.9/docs/agent}/llm-integration.mdx +0 -0
  99. {mcp_use-1.3.7 → mcp_use-1.3.9}/docs/api-reference/adapters.mdx +0 -0
  100. {mcp_use-1.3.7 → mcp_use-1.3.9}/docs/api-reference/introduction.mdx +0 -0
  101. {mcp_use-1.3.7 → mcp_use-1.3.9}/docs/changelog.mdx +0 -0
  102. {mcp_use-1.3.7/docs/essentials → mcp_use-1.3.9/docs/client}/sampling.mdx +0 -0
  103. {mcp_use-1.3.7 → mcp_use-1.3.9}/docs/development/observability.mdx +0 -0
  104. {mcp_use-1.3.7 → mcp_use-1.3.9}/docs/development/telemetry.mdx +0 -0
  105. {mcp_use-1.3.7 → mcp_use-1.3.9}/docs/development.mdx +0 -0
  106. {mcp_use-1.3.7 → mcp_use-1.3.9}/docs/favicon.svg +0 -0
  107. {mcp_use-1.3.7 → mcp_use-1.3.9}/docs/fonts.css +0 -0
  108. {mcp_use-1.3.7 → mcp_use-1.3.9}/docs/images/01.png +0 -0
  109. {mcp_use-1.3.7 → mcp_use-1.3.9}/docs/images/02.png +0 -0
  110. {mcp_use-1.3.7 → mcp_use-1.3.9}/docs/images/configuration-dark.png +0 -0
  111. {mcp_use-1.3.7 → mcp_use-1.3.9}/docs/images/configuration-light.png +0 -0
  112. {mcp_use-1.3.7 → mcp_use-1.3.9}/docs/images/examples-dark.png +0 -0
  113. {mcp_use-1.3.7 → mcp_use-1.3.9}/docs/images/examples-light.png +0 -0
  114. {mcp_use-1.3.7 → mcp_use-1.3.9}/docs/images/hero-dark.png +0 -0
  115. {mcp_use-1.3.7 → mcp_use-1.3.9}/docs/images/hero-light.png +0 -0
  116. {mcp_use-1.3.7 → mcp_use-1.3.9}/docs/images/installation-dark.png +0 -0
  117. {mcp_use-1.3.7 → mcp_use-1.3.9}/docs/images/installation-light.png +0 -0
  118. {mcp_use-1.3.7 → mcp_use-1.3.9}/docs/images/quickstart-dark.png +0 -0
  119. {mcp_use-1.3.7 → mcp_use-1.3.9}/docs/images/quickstart-light.png +0 -0
  120. {mcp_use-1.3.7 → mcp_use-1.3.9}/docs/logo/dark.svg +0 -0
  121. {mcp_use-1.3.7 → mcp_use-1.3.9}/docs/logo/light.svg +0 -0
  122. {mcp_use-1.3.7 → mcp_use-1.3.9}/docs/logo/react.svg +0 -0
  123. {mcp_use-1.3.7 → mcp_use-1.3.9}/docs/snippets/snippet-intro.mdx +0 -0
  124. {mcp_use-1.3.7 → mcp_use-1.3.9}/docs/snippets/youtube-embed.mdx +0 -0
  125. {mcp_use-1.3.7 → mcp_use-1.3.9}/docs/troubleshooting/common-issues.mdx +0 -0
  126. {mcp_use-1.3.7 → mcp_use-1.3.9}/docs/troubleshooting/connection-errors.mdx +0 -0
  127. {mcp_use-1.3.7 → mcp_use-1.3.9}/examples/airbnb_mcp.json +0 -0
  128. {mcp_use-1.3.7 → mcp_use-1.3.9}/examples/blender_use.py +0 -0
  129. {mcp_use-1.3.7 → mcp_use-1.3.9}/examples/browser_use.py +0 -0
  130. {mcp_use-1.3.7 → mcp_use-1.3.9}/examples/chat_example.py +0 -0
  131. {mcp_use-1.3.7 → mcp_use-1.3.9}/examples/filesystem_use.py +0 -0
  132. {mcp_use-1.3.7 → mcp_use-1.3.9}/examples/http_example.py +0 -0
  133. {mcp_use-1.3.7 → mcp_use-1.3.9}/examples/mcp_everything.py +0 -0
  134. {mcp_use-1.3.7 → mcp_use-1.3.9}/examples/multi_server_example.py +0 -0
  135. {mcp_use-1.3.7 → mcp_use-1.3.9}/examples/sandbox_everything.py +0 -0
  136. {mcp_use-1.3.7 → mcp_use-1.3.9}/mcp_use/adapters/__init__.py +0 -0
  137. {mcp_use-1.3.7 → mcp_use-1.3.9}/mcp_use/agents/base.py +0 -0
  138. {mcp_use-1.3.7 → mcp_use-1.3.9}/mcp_use/agents/prompts/system_prompt_builder.py +0 -0
  139. {mcp_use-1.3.7 → mcp_use-1.3.9}/mcp_use/connectors/__init__.py +0 -0
  140. {mcp_use-1.3.7 → mcp_use-1.3.9}/mcp_use/connectors/utils.py +0 -0
  141. {mcp_use-1.3.7 → mcp_use-1.3.9}/mcp_use/connectors/websocket.py +0 -0
  142. {mcp_use-1.3.7 → mcp_use-1.3.9}/mcp_use/logging.py +0 -0
  143. {mcp_use-1.3.7 → mcp_use-1.3.9}/mcp_use/managers/tools/base_tool.py +0 -0
  144. {mcp_use-1.3.7 → mcp_use-1.3.9}/mcp_use/managers/tools/get_active_server.py +0 -0
  145. {mcp_use-1.3.7 → mcp_use-1.3.9}/mcp_use/managers/tools/search_tools.py +0 -0
  146. {mcp_use-1.3.7 → mcp_use-1.3.9}/mcp_use/observability/__init__.py +0 -0
  147. {mcp_use-1.3.7 → mcp_use-1.3.9}/mcp_use/observability/laminar.py +0 -0
  148. {mcp_use-1.3.7 → mcp_use-1.3.9}/mcp_use/observability/langfuse.py +0 -0
  149. {mcp_use-1.3.7 → mcp_use-1.3.9}/mcp_use/task_managers/__init__.py +0 -0
  150. {mcp_use-1.3.7 → mcp_use-1.3.9}/mcp_use/task_managers/base.py +0 -0
  151. {mcp_use-1.3.7 → mcp_use-1.3.9}/mcp_use/task_managers/sse.py +0 -0
  152. {mcp_use-1.3.7 → mcp_use-1.3.9}/mcp_use/task_managers/stdio.py +0 -0
  153. {mcp_use-1.3.7 → mcp_use-1.3.9}/mcp_use/task_managers/streamable_http.py +0 -0
  154. {mcp_use-1.3.7 → mcp_use-1.3.9}/mcp_use/task_managers/websocket.py +0 -0
  155. {mcp_use-1.3.7 → mcp_use-1.3.9}/mcp_use/telemetry/__init__.py +0 -0
  156. {mcp_use-1.3.7 → mcp_use-1.3.9}/mcp_use/telemetry/events.py +0 -0
  157. {mcp_use-1.3.7 → mcp_use-1.3.9}/mcp_use/telemetry/utils.py +0 -0
  158. {mcp_use-1.3.7 → mcp_use-1.3.9}/mcp_use/types/sandbox.py +0 -0
  159. {mcp_use-1.3.7 → mcp_use-1.3.9}/mcp_use/utils.py +0 -0
  160. {mcp_use-1.3.7 → mcp_use-1.3.9}/pytest.ini +0 -0
  161. {mcp_use-1.3.7 → mcp_use-1.3.9}/ruff.toml +0 -0
  162. {mcp_use-1.3.7 → mcp_use-1.3.9}/static/logo_black.svg +0 -0
  163. {mcp_use-1.3.7 → mcp_use-1.3.9}/static/logo_white.svg +0 -0
  164. {mcp_use-1.3.7 → mcp_use-1.3.9}/tests/conftest.py +0 -0
  165. {mcp_use-1.3.7 → mcp_use-1.3.9}/tests/integration/__init__.py +0 -0
  166. {mcp_use-1.3.7 → mcp_use-1.3.9}/tests/integration/conftest.py +0 -0
  167. {mcp_use-1.3.7 → mcp_use-1.3.9}/tests/integration/servers_for_testing/__init__.py +0 -0
  168. {mcp_use-1.3.7 → mcp_use-1.3.9}/tests/integration/servers_for_testing/custom_streaming_server.py +0 -0
  169. {mcp_use-1.3.7 → mcp_use-1.3.9}/tests/integration/servers_for_testing/simple_server.py +0 -0
  170. {mcp_use-1.3.7 → mcp_use-1.3.9}/tests/integration/servers_for_testing/timeout_test_server.py +0 -0
  171. {mcp_use-1.3.7 → mcp_use-1.3.9}/tests/unit/test_config.py +0 -0
  172. {mcp_use-1.3.7 → mcp_use-1.3.9}/tests/unit/test_logging.py +0 -0
  173. {mcp_use-1.3.7 → mcp_use-1.3.9}/tests/unit/test_search_tools_issue_138.py +0 -0
  174. {mcp_use-1.3.7 → mcp_use-1.3.9}/tests/unit/test_session.py +0 -0
  175. {mcp_use-1.3.7 → mcp_use-1.3.9}/tests/unit/test_websocket_connection_manager.py +0 -0
{mcp_use-1.3.7 → mcp_use-1.3.9}/.github/release-drafter.yml RENAMED
@@ -1,5 +1,5 @@
1
- name-template: 'Release v$RESOLVED_VERSION 🌈'
2
- tag-template: 'Releasev$RESOLVED_VERSION'
1
+ name-template: '$RESOLVED_VERSION 🌈'
2
+ tag-template: '$RESOLVED_VERSION'
3
3
  categories:
4
4
  - title: '🚀 Features'
5
5
  labels:
{mcp_use-1.3.7 → mcp_use-1.3.9}/.github/workflows/tests.yml RENAMED
@@ -53,7 +53,7 @@ jobs:
53
53
  strategy:
54
54
  fail-fast: false
55
55
  matrix:
56
- transport: [stdio, sse, streamableHttp]
56
+ transport: [stdio, sse, streamable_http]
57
57
  steps:
58
58
  - uses: actions/checkout@v3
59
59
  - name: Set up Python 3.11
@@ -68,7 +68,7 @@ jobs:
68
68
  uv pip install --system .[dev,anthropic,openai,search,e2b]
69
69
  - name: Run integration tests for ${{ matrix.transport }} transport
70
70
  run: |
71
- pytest tests/integration/transports/${{ matrix.transport }}
71
+ pytest tests/integration/transports/test_${{ matrix.transport }}.py
72
72
 
73
73
  primitive-tests:
74
74
  needs: lint
@@ -77,7 +77,7 @@ jobs:
77
77
  strategy:
78
78
  fail-fast: false
79
79
  matrix:
80
- primitive: [sampling, tools, resources, prompts, elicitation]
80
+ primitive: [sampling, tools, resources, prompts, elicitation, notifications]
81
81
  steps:
82
82
  - uses: actions/checkout@v3
83
83
  - name: Set up Python 3.11
@@ -93,3 +93,23 @@ jobs:
93
93
  - name: Run integration tests for ${{ matrix.primitive }} primitive
94
94
  run: |
95
95
  pytest tests/integration/primitives/test_${{ matrix.primitive }}.py
96
+
97
+ integration-tests:
98
+ needs: lint
99
+ name: "Integration"
100
+ runs-on: ubuntu-latest
101
+ steps:
102
+ - uses: actions/checkout@v3
103
+ - name: Set up Python 3.11
104
+ uses: actions/setup-python@v4
105
+ with:
106
+ python-version: "3.11"
107
+ - name: Install uv
108
+ run: |
109
+ pip install uv
110
+ - name: Install dependencies
111
+ run: |
112
+ uv pip install --system .[dev,anthropic,openai,search,e2b]
113
+ - name: Run other integration tests
114
+ run: |
115
+ pytest tests/integration/others/
{mcp_use-1.3.7 → mcp_use-1.3.9}/.github/workflows/update-readme.yml RENAMED
@@ -7,7 +7,9 @@ on:
7
7
  schedule:
8
8
  - cron: "0 0 * * 0" # Every sunday at midnight
9
9
 
10
- permissions: read-all
10
+ permissions:
11
+ contents: write
12
+ pull-requests: write
11
13
 
12
14
  concurrency:
13
15
  group: ${{ github.ref }}-${{ github.workflow }}
{mcp_use-1.3.7 → mcp_use-1.3.9}/PKG-INFO RENAMED
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: mcp-use
3
- Version: 1.3.7
3
+ Version: 1.3.9
4
4
  Summary: MCP Library for LLMs
5
5
  Author-email: Pietro Zullo <pietro.zullo@gmail.com>
6
6
  License: MIT
@@ -17,7 +17,7 @@ Requires-Python: >=3.11
17
17
  Requires-Dist: aiohttp>=3.9.0
18
18
  Requires-Dist: jsonschema-pydantic>=0.1.0
19
19
  Requires-Dist: langchain>=0.1.0
20
- Requires-Dist: mcp>=1.9.3
20
+ Requires-Dist: mcp>=1.10.0
21
21
  Requires-Dist: posthog>=4.8.0
22
22
  Requires-Dist: pydantic>=2.0.0
23
23
  Requires-Dist: python-dotenv>=1.0.0
@@ -46,25 +46,30 @@ Description-Content-Type: text/markdown
46
46
  <div align="center">
47
47
  <div align="center" style="margin: 0 auto; max-width: 80%;">
48
48
  <picture>
49
- <source media="(prefers-color-scheme: dark)" srcset="static/logo_white.svg">
50
- <source media="(prefers-color-scheme: light)" srcset="static/logo_black.svg">
51
- <img alt="mcp use logo" src="./static/logo-white.svg" width="80%" style="margin: 20px auto;">
49
+ <source media="(prefers-color-scheme: dark)" srcset="static/logo-gh.jpg">
50
+ <source media="(prefers-color-scheme: light)" srcset="static/logo-gh.jpg">
51
+ <img alt="mcp use logo" src="./static/logo-gh.jpg" width="80%" style="margin: 20px auto;">
52
52
  </picture>
53
53
  </div>
54
54
 
55
55
  <br>
56
56
 
57
- # Connect any LLM to any MCP server
57
+ # Create MCP Clients and Agents
58
58
 
59
+ <p align="center">
60
+ <a href="https://www.producthunt.com/products/mcp-use?embed=true&utm_source=badge-featured&utm_medium=badge&utm_source=badge-mcp&#0045;use" target="_blank"><img src="https://api.producthunt.com/widgets/embed-image/v1/featured.svg?post_id=1002629&theme=neutral&t=1754609432704" alt="mcp&#0045;use - Open&#0032;source&#0032;SDK&#0032;and&#0032;infra&#0032;for&#0032;MCP&#0032;servers&#0032;&#0038;&#0032;agents | Product Hunt" style="width: 150px; height: 32px;" width="150" height="32" /></a>
61
+ </p>
59
62
  <p align="center">
60
63
  <a href="https://github.com/pietrozullo/mcp-use/stargazers" alt="GitHub stars">
61
64
  <img src="https://img.shields.io/github/stars/pietrozullo/mcp-use?style=social" /></a>
65
+ <a href="https://pypi.org/project/mcp_use/" alt="PyPI Downloads">
66
+ <img src="https://static.pepy.tech/badge/mcp-use" /></a>
62
67
  <a href="https://pypi.org/project/mcp_use/" alt="PyPI Version">
63
68
  <img src="https://img.shields.io/pypi/v/mcp_use.svg"/></a>
69
+ <a href="https://github.com/mcp-use/mcp-use-ts" alt="TypeScript">
70
+ <img src="https://img.shields.io/badge/TypeScript-mcp--use-3178C6?logo=typescript&logoColor=white" /></a>
64
71
  <a href="https://github.com/pietrozullo/mcp-use/blob/main/LICENSE" alt="License">
65
72
  <img src="https://img.shields.io/github/license/pietrozullo/mcp-use" /></a>
66
- <a href="https://pypi.org/project/mcp_use/" alt="PyPI Downloads">
67
- <img src="https://static.pepy.tech/badge/mcp-use" /></a>
68
73
  <a href="https://docs.mcp-use.com" alt="Documentation">
69
74
  <img src="https://img.shields.io/badge/docs-mcp--use.com-blue" /></a>
70
75
  <a href="https://mcp-use.com" alt="Website">
@@ -84,15 +89,14 @@ Description-Content-Type: text/markdown
84
89
 
85
90
  💡 Let developers easily connect any LLM to tools like web browsing, file operations, and more.
86
91
 
87
- - Visit the [mcp-use.com website](https://mcp-use.com/) to know how to build and deploy MCP agents.
92
+ - 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.
88
93
  - Visit the [mcp-use docs](https://docs.mcp-use.com/) to get started with mcp-use library
94
+ - For the TypeScript version, visit [mcp-use-ts](https://github.com/mcp-use/mcp-use-ts)
89
95
 
90
- 💬 Get started quickly - chat with your servers on our <b>hosted version</b>! [Try mcp-use chat (beta)](https://chat.mcp-use.com).
91
-
92
- | Supports | |
93
- | :--- | :--- |
96
+ | Supports | |
97
+ | :------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
94
98
  | **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) |
95
- | **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) |
99
+ | **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) |
96
100
 
97
101
  ## Features
98
102
 
@@ -418,29 +422,7 @@ if __name__ == "__main__":
418
422
  asyncio.run(run_blender_example())
419
423
  ```
420
424
 
421
- # Configuration File Support
422
-
423
- MCP-Use supports initialization from configuration files, making it easy to manage and switch between different MCP server setups:
424
-
425
- ```python
426
- import asyncio
427
- from mcp_use import create_session_from_config
428
-
429
- async def main():
430
- # Create an MCP session from a config file
431
- session = create_session_from_config("mcp-config.json")
432
-
433
- # Initialize the session
434
- await session.initialize()
435
-
436
- # Use the session...
437
-
438
- # Disconnect when done
439
- await session.disconnect()
440
-
441
- if __name__ == "__main__":
442
- asyncio.run(main())
443
- ```
425
+ # Configuration Support
444
426
 
445
427
  ## HTTP Connection Example
446
428
 
@@ -696,6 +678,47 @@ The `SandboxOptions` type provides configuration for the sandbox environment:
696
678
  - **Consistent environment**: Ensure consistent behavior across different systems
697
679
  - **Resource efficiency**: Offload resource-intensive tasks to cloud infrastructure
698
680
 
681
+ # Direct Tool Calls (Without LLM)
682
+
683
+ You can call MCP server tools directly without an LLM when you need programmatic control:
684
+
685
+ ```python
686
+ import asyncio
687
+ from mcp_use import MCPClient
688
+
689
+ async def call_tool_example():
690
+ config = {
691
+ "mcpServers": {
692
+ "everything": {
693
+ "command": "npx",
694
+ "args": ["-y", "@modelcontextprotocol/server-everything"],
695
+ }
696
+ }
697
+ }
698
+
699
+ client = MCPClient.from_dict(config)
700
+
701
+ try:
702
+ await client.create_all_sessions()
703
+ session = client.get_session("everything")
704
+
705
+ # Call tool directly
706
+ result = await session.call_tool(
707
+ name="add",
708
+ arguments={"a": 1, "b": 2}
709
+ )
710
+
711
+ print(f"Result: {result.content[0].text}") # Output: 3
712
+
713
+ finally:
714
+ await client.close_all_sessions()
715
+
716
+ if __name__ == "__main__":
717
+ asyncio.run(call_tool_example())
718
+ ```
719
+
720
+ See the complete example: [examples/direct_tool_call.py](examples/direct_tool_call.py)
721
+
699
722
  # Build a Custom Agent:
700
723
 
701
724
  You can also build your own custom agent using the LangChain adapter:
@@ -813,44 +836,44 @@ Thanks to all our amazing contributors!
813
836
  <th>Stars</th>
814
837
  </tr>
815
838
  <tr>
816
- <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>
817
- <td>⭐ 112</td>
839
+ <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>
840
+ <td>⭐ 15920</td>
818
841
  </tr>
819
842
  <tr>
820
- <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>
821
- <td>⭐ 37</td>
843
+ <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>
844
+ <td>⭐ 129</td>
822
845
  </tr>
823
846
  <tr>
824
- <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>
825
- <td>⭐ 29</td>
847
+ <td><img src="https://avatars.githubusercontent.com/u/164294848?s=40&v=4" width="20" height="20" style="vertical-align: middle; margin-right: 8px;"> <a href="https://github.com/buildfastwithai/gen-ai-experiments"><strong>buildfastwithai/gen-ai-experiments</strong></a></td>
848
+ <td>⭐ 93</td>
826
849
  </tr>
827
850
  <tr>
828
- <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>
829
- <td>⭐ 21</td>
851
+ <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-python"><strong>hud-evals/hud-python</strong></a></td>
852
+ <td>⭐ 76</td>
830
853
  </tr>
831
854
  <tr>
832
- <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>
833
- <td>⭐ 18</td>
855
+ <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>
856
+ <td>⭐ 61</td>
834
857
  </tr>
835
858
  <tr>
836
- <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>
837
- <td>⭐ 17</td>
859
+ <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>
860
+ <td>⭐ 35</td>
838
861
  </tr>
839
862
  <tr>
840
- <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>
841
- <td>⭐ 9</td>
863
+ <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>
864
+ <td>⭐ 30</td>
842
865
  </tr>
843
866
  <tr>
844
- <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>
845
- <td>⭐ 6</td>
867
+ <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>
868
+ <td>⭐ 24</td>
846
869
  </tr>
847
870
  <tr>
848
- <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>
849
- <td>⭐ 5</td>
871
+ <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>
872
+ <td>⭐ 22</td>
850
873
  </tr>
851
874
  <tr>
852
- <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>
853
- <td>⭐ 5</td>
875
+ <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>
876
+ <td>⭐ 19</td>
854
877
  </tr>
855
878
  </table>
856
879
 
{mcp_use-1.3.7 → mcp_use-1.3.9}/README.md RENAMED
@@ -1,25 +1,30 @@
1
1
  <div align="center">
2
2
  <div align="center" style="margin: 0 auto; max-width: 80%;">
3
3
  <picture>
4
- <source media="(prefers-color-scheme: dark)" srcset="static/logo_white.svg">
5
- <source media="(prefers-color-scheme: light)" srcset="static/logo_black.svg">
6
- <img alt="mcp use logo" src="./static/logo-white.svg" width="80%" style="margin: 20px auto;">
4
+ <source media="(prefers-color-scheme: dark)" srcset="static/logo-gh.jpg">
5
+ <source media="(prefers-color-scheme: light)" srcset="static/logo-gh.jpg">
6
+ <img alt="mcp use logo" src="./static/logo-gh.jpg" width="80%" style="margin: 20px auto;">
7
7
  </picture>
8
8
  </div>
9
9
 
10
10
  <br>
11
11
 
12
- # Connect any LLM to any MCP server
12
+ # Create MCP Clients and Agents
13
13
 
14
+ <p align="center">
15
+ <a href="https://www.producthunt.com/products/mcp-use?embed=true&utm_source=badge-featured&utm_medium=badge&utm_source=badge-mcp&#0045;use" target="_blank"><img src="https://api.producthunt.com/widgets/embed-image/v1/featured.svg?post_id=1002629&theme=neutral&t=1754609432704" alt="mcp&#0045;use - Open&#0032;source&#0032;SDK&#0032;and&#0032;infra&#0032;for&#0032;MCP&#0032;servers&#0032;&#0038;&#0032;agents | Product Hunt" style="width: 150px; height: 32px;" width="150" height="32" /></a>
16
+ </p>
14
17
  <p align="center">
15
18
  <a href="https://github.com/pietrozullo/mcp-use/stargazers" alt="GitHub stars">
16
19
  <img src="https://img.shields.io/github/stars/pietrozullo/mcp-use?style=social" /></a>
20
+ <a href="https://pypi.org/project/mcp_use/" alt="PyPI Downloads">
21
+ <img src="https://static.pepy.tech/badge/mcp-use" /></a>
17
22
  <a href="https://pypi.org/project/mcp_use/" alt="PyPI Version">
18
23
  <img src="https://img.shields.io/pypi/v/mcp_use.svg"/></a>
24
+ <a href="https://github.com/mcp-use/mcp-use-ts" alt="TypeScript">
25
+ <img src="https://img.shields.io/badge/TypeScript-mcp--use-3178C6?logo=typescript&logoColor=white" /></a>
19
26
  <a href="https://github.com/pietrozullo/mcp-use/blob/main/LICENSE" alt="License">
20
27
  <img src="https://img.shields.io/github/license/pietrozullo/mcp-use" /></a>
21
- <a href="https://pypi.org/project/mcp_use/" alt="PyPI Downloads">
22
- <img src="https://static.pepy.tech/badge/mcp-use" /></a>
23
28
  <a href="https://docs.mcp-use.com" alt="Documentation">
24
29
  <img src="https://img.shields.io/badge/docs-mcp--use.com-blue" /></a>
25
30
  <a href="https://mcp-use.com" alt="Website">
@@ -39,15 +44,14 @@
39
44
 
40
45
  💡 Let developers easily connect any LLM to tools like web browsing, file operations, and more.
41
46
 
42
- - Visit the [mcp-use.com website](https://mcp-use.com/) to know how to build and deploy MCP agents.
47
+ - 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.
43
48
  - Visit the [mcp-use docs](https://docs.mcp-use.com/) to get started with mcp-use library
49
+ - For the TypeScript version, visit [mcp-use-ts](https://github.com/mcp-use/mcp-use-ts)
44
50
 
45
- 💬 Get started quickly - chat with your servers on our <b>hosted version</b>! [Try mcp-use chat (beta)](https://chat.mcp-use.com).
46
-
47
- | Supports | |
48
- | :--- | :--- |
51
+ | Supports | |
52
+ | :------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
49
53
  | **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) |
50
- | **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) |
54
+ | **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) |
51
55
 
52
56
  ## Features
53
57
 
@@ -373,29 +377,7 @@ if __name__ == "__main__":
373
377
  asyncio.run(run_blender_example())
374
378
  ```
375
379
 
376
- # Configuration File Support
377
-
378
- MCP-Use supports initialization from configuration files, making it easy to manage and switch between different MCP server setups:
379
-
380
- ```python
381
- import asyncio
382
- from mcp_use import create_session_from_config
383
-
384
- async def main():
385
- # Create an MCP session from a config file
386
- session = create_session_from_config("mcp-config.json")
387
-
388
- # Initialize the session
389
- await session.initialize()
390
-
391
- # Use the session...
392
-
393
- # Disconnect when done
394
- await session.disconnect()
395
-
396
- if __name__ == "__main__":
397
- asyncio.run(main())
398
- ```
380
+ # Configuration Support
399
381
 
400
382
  ## HTTP Connection Example
401
383
 
@@ -651,6 +633,47 @@ The `SandboxOptions` type provides configuration for the sandbox environment:
651
633
  - **Consistent environment**: Ensure consistent behavior across different systems
652
634
  - **Resource efficiency**: Offload resource-intensive tasks to cloud infrastructure
653
635
 
636
+ # Direct Tool Calls (Without LLM)
637
+
638
+ You can call MCP server tools directly without an LLM when you need programmatic control:
639
+
640
+ ```python
641
+ import asyncio
642
+ from mcp_use import MCPClient
643
+
644
+ async def call_tool_example():
645
+ config = {
646
+ "mcpServers": {
647
+ "everything": {
648
+ "command": "npx",
649
+ "args": ["-y", "@modelcontextprotocol/server-everything"],
650
+ }
651
+ }
652
+ }
653
+
654
+ client = MCPClient.from_dict(config)
655
+
656
+ try:
657
+ await client.create_all_sessions()
658
+ session = client.get_session("everything")
659
+
660
+ # Call tool directly
661
+ result = await session.call_tool(
662
+ name="add",
663
+ arguments={"a": 1, "b": 2}
664
+ )
665
+
666
+ print(f"Result: {result.content[0].text}") # Output: 3
667
+
668
+ finally:
669
+ await client.close_all_sessions()
670
+
671
+ if __name__ == "__main__":
672
+ asyncio.run(call_tool_example())
673
+ ```
674
+
675
+ See the complete example: [examples/direct_tool_call.py](examples/direct_tool_call.py)
676
+
654
677
  # Build a Custom Agent:
655
678
 
656
679
  You can also build your own custom agent using the LangChain adapter:
@@ -768,44 +791,44 @@ Thanks to all our amazing contributors!
768
791
  <th>Stars</th>
769
792
  </tr>
770
793
  <tr>
771
- <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>
772
- <td>⭐ 112</td>
794
+ <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>
795
+ <td>⭐ 15920</td>
773
796
  </tr>
774
797
  <tr>
775
- <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>
776
- <td>⭐ 37</td>
798
+ <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>
799
+ <td>⭐ 129</td>
777
800
  </tr>
778
801
  <tr>
779
- <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>
780
- <td>⭐ 29</td>
802
+ <td><img src="https://avatars.githubusercontent.com/u/164294848?s=40&v=4" width="20" height="20" style="vertical-align: middle; margin-right: 8px;"> <a href="https://github.com/buildfastwithai/gen-ai-experiments"><strong>buildfastwithai/gen-ai-experiments</strong></a></td>
803
+ <td>⭐ 93</td>
781
804
  </tr>
782
805
  <tr>
783
- <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>
784
- <td>⭐ 21</td>
806
+ <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-python"><strong>hud-evals/hud-python</strong></a></td>
807
+ <td>⭐ 76</td>
785
808
  </tr>
786
809
  <tr>
787
- <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>
788
- <td>⭐ 18</td>
810
+ <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>
811
+ <td>⭐ 61</td>
789
812
  </tr>
790
813
  <tr>
791
- <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>
792
- <td>⭐ 17</td>
814
+ <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>
815
+ <td>⭐ 35</td>
793
816
  </tr>
794
817
  <tr>
795
- <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>
796
- <td>⭐ 9</td>
818
+ <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>
819
+ <td>⭐ 30</td>
797
820
  </tr>
798
821
  <tr>
799
- <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>
800
- <td>⭐ 6</td>
822
+ <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>
823
+ <td>⭐ 24</td>
801
824
  </tr>
802
825
  <tr>
803
- <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>
804
- <td>⭐ 5</td>
826
+ <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>
827
+ <td>⭐ 22</td>
805
828
  </tr>
806
829
  <tr>
807
- <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>
808
- <td>⭐ 5</td>
830
+ <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>
831
+ <td>⭐ 19</td>
809
832
  </tr>
810
833
  </table>
811
834
 
{mcp_use-1.3.7/docs/guides → mcp_use-1.3.9/docs/advanced}/multi-server-setup.mdx RENAMED
@@ -439,10 +439,10 @@ agent = MCPAgent(
439
439
  ## Next Steps
440
440
 
441
441
  <CardGroup cols={3}>
442
- <Card title="Server Manager" icon="server" href="/essentials/server-manager">
442
+ <Card title="Server Manager" icon="server" href="/agent/server-manager">
443
443
  Learn more about dynamic server selection and management
444
444
  </Card>
445
- <Card title="Security Guide" icon="shield" href="/guides/security">
445
+ <Card title="Security Guide" icon="shield" href="/advanced/security">
446
446
  Best practices for secure multi-server configurations
447
447
  </Card>
448
448
  <Card title="Performance" icon="zap" href="/troubleshooting/performance">
{mcp_use-1.3.7/docs/guides → mcp_use-1.3.9/docs/advanced}/security.mdx RENAMED
@@ -580,7 +580,7 @@ def secure_command_args(command: str, args: List[str]) -> List[str]:
580
580
  ## Next Steps
581
581
 
582
582
  <CardGroup cols={3}>
583
- <Card title="Configuration Guide" icon="gear" href="/essentials/configuration">
583
+ <Card title="Configuration Guide" icon="gear" href="/getting-started/configuration">
584
584
  Learn secure configuration practices for MCP servers
585
585
  </Card>
586
586
  <Card title="Deployment Guide" icon="rocket" href="/development">
{mcp_use-1.3.7/docs/essentials → mcp_use-1.3.9/docs/agent}/agent-configuration.mdx RENAMED
@@ -7,7 +7,7 @@ icon: "brain"
7
7
  # Agent Configuration
8
8
 
9
9
  <Info>
10
- This guide covers MCPAgent configuration options for customizing agent behavior and LLM integration. For client configuration, see the [Client Configuration](/essentials/client-configuration) guide.
10
+ This guide covers MCPAgent configuration options for customizing agent behavior and LLM integration. For client configuration, see the [Client Configuration](/client/client-configuration) guide.
11
11
  </Info>
12
12
 
13
13
  ## API Keys