runloop_api_client 1.5.0__tar.gz → 1.7.0__tar.gz

runloop_api_client-1.7.0/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "1.7.0"
+}

{runloop_api_client-1.5.0 → runloop_api_client-1.7.0}/CHANGELOG.md

@@ -1,5 +1,34 @@
 # Changelog
 
+## 1.7.0 (2026-02-05)
+
+Full Changelog: [v1.5.1...v1.7.0](https://github.com/runloopai/api-client-python/compare/v1.5.1...v1.7.0)
+
+### Features
+
+* add api to query devbox usage ([#7296](https://github.com/runloopai/api-client-python/issues/7296)) ([ab903f5](https://github.com/runloopai/api-client-python/commit/ab903f557ecc8be15c8d150068a82dfaaac23f4e))
+* adding MCP Config routes ([#7331](https://github.com/runloopai/api-client-python/issues/7331)) ([79d05c0](https://github.com/runloopai/api-client-python/commit/79d05c00f9bb85a458cc300c5b065b6249a16a88))
+* **devbox:** add mcp configuration to devbox create ([#7341](https://github.com/runloopai/api-client-python/issues/7341)) ([0b81e31](https://github.com/runloopai/api-client-python/commit/0b81e3151e3df41f667923cac4e714ba6d7ca3bc))
+* **devbox:** adding gateway config ([#736](https://github.com/runloopai/api-client-python/issues/736)) ([9f4b49d](https://github.com/runloopai/api-client-python/commit/9f4b49daa13dd3aac5a8ee26a262fd7b5b705ff1))
+
+
+### Bug Fixes
+
+* **sdk:** fixed pagination for scorer, scenario and network policy list methods ([#731](https://github.com/runloopai/api-client-python/issues/731)) ([d55fceb](https://github.com/runloopai/api-client-python/commit/d55fceb7d42877cd0ac69a934ef300815f371342))
+
+
+### Chores
+
+* Mark legacy tunnel methods deprecated ([#737](https://github.com/runloopai/api-client-python/issues/737)) ([764b445](https://github.com/runloopai/api-client-python/commit/764b445018ec50db3105c0dd8ea58b02e4690e12))
+
+## 1.5.1 (2026-01-30)
+
+Full Changelog: [v1.5.0...v1.5.1](https://github.com/runloopai/api-client-python/compare/v1.5.0...v1.5.1)
+
+### Chores
+
+* **devbox:** rename tunnel auth enum ([#7239](https://github.com/runloopai/api-client-python/issues/7239)) ([7a9b7a4](https://github.com/runloopai/api-client-python/commit/7a9b7a449ce648ad4f220af83b35f800727ea28d))
+
 ## 1.5.0 (2026-01-30)
 
 Full Changelog: [v1.4.0...v1.5.0](https://github.com/runloopai/api-client-python/compare/v1.4.0...v1.5.0)

{runloop_api_client-1.5.0 → runloop_api_client-1.7.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: runloop_api_client
-Version: 1.5.0
+Version: 1.7.0
 Summary: The official Python library for the runloop API
 Project-URL: Homepage, https://github.com/runloopai/api-client-python
 Project-URL: Repository, https://github.com/runloopai/api-client-python

{runloop_api_client-1.5.0 → runloop_api_client-1.7.0}/api.md

@@ -126,6 +126,7 @@ from runloop_api_client.types import (
     DevboxExecutionDetailView,
     DevboxKillExecutionRequest,
     DevboxListView,
+    DevboxResourceUsageView,
     DevboxSendStdInRequest,
     DevboxSendStdInResult,
     DevboxSnapshotListView,
@@ -158,6 +159,7 @@ Methods:
 - <code title="post /v1/devboxes/{id}/read_file_contents">client.devboxes.<a href="./src/runloop_api_client/resources/devboxes/devboxes.py">read_file_contents</a>(id, \*\*<a href="src/runloop_api_client/types/devbox_read_file_contents_params.py">params</a>) -> str</code>
 - <code title="post /v1/devboxes/{id}/remove_tunnel">client.devboxes.<a href="./src/runloop_api_client/resources/devboxes/devboxes.py">remove_tunnel</a>(id, \*\*<a href="src/runloop_api_client/types/devbox_remove_tunnel_params.py">params</a>) -> object</code>
 - <code title="post /v1/devboxes/{id}/resume">client.devboxes.<a href="./src/runloop_api_client/resources/devboxes/devboxes.py">resume</a>(id) -> <a href="./src/runloop_api_client/types/devbox_view.py">DevboxView</a></code>
+- <code title="get /v1/devboxes/{id}/usage">client.devboxes.<a href="./src/runloop_api_client/resources/devboxes/devboxes.py">retrieve_resource_usage</a>(id) -> <a href="./src/runloop_api_client/types/devbox_resource_usage_view.py">DevboxResourceUsageView</a></code>
 - <code title="post /v1/devboxes/{id}/shutdown">client.devboxes.<a href="./src/runloop_api_client/resources/devboxes/devboxes.py">shutdown</a>(id) -> <a href="./src/runloop_api_client/types/devbox_view.py">DevboxView</a></code>
 - <code title="post /v1/devboxes/{id}/snapshot_disk">client.devboxes.<a href="./src/runloop_api_client/resources/devboxes/devboxes.py">snapshot_disk</a>(id, \*\*<a href="src/runloop_api_client/types/devbox_snapshot_disk_params.py">params</a>) -> <a href="./src/runloop_api_client/types/devbox_snapshot_view.py">DevboxSnapshotView</a></code>
 - <code title="post /v1/devboxes/{id}/snapshot_disk_async">client.devboxes.<a href="./src/runloop_api_client/resources/devboxes/devboxes.py">snapshot_disk_async</a>(id, \*\*<a href="src/runloop_api_client/types/devbox_snapshot_disk_async_params.py">params</a>) -> <a href="./src/runloop_api_client/types/devbox_snapshot_view.py">DevboxSnapshotView</a></code>
@@ -299,7 +301,6 @@ from runloop_api_client.types.scenarios import (
     ScorerRetrieveResponse,
     ScorerUpdateResponse,
     ScorerListResponse,
-    ScorerValidateResponse,
 )
 ```
 
@@ -309,7 +310,6 @@ Methods:
 - <code title="get /v1/scenarios/scorers/{id}">client.scenarios.scorers.<a href="./src/runloop_api_client/resources/scenarios/scorers.py">retrieve</a>(id) -> <a href="./src/runloop_api_client/types/scenarios/scorer_retrieve_response.py">ScorerRetrieveResponse</a></code>
 - <code title="post /v1/scenarios/scorers/{id}">client.scenarios.scorers.<a href="./src/runloop_api_client/resources/scenarios/scorers.py">update</a>(id, \*\*<a href="src/runloop_api_client/types/scenarios/scorer_update_params.py">params</a>) -> <a href="./src/runloop_api_client/types/scenarios/scorer_update_response.py">ScorerUpdateResponse</a></code>
 - <code title="get /v1/scenarios/scorers">client.scenarios.scorers.<a href="./src/runloop_api_client/resources/scenarios/scorers.py">list</a>(\*\*<a href="src/runloop_api_client/types/scenarios/scorer_list_params.py">params</a>) -> <a href="./src/runloop_api_client/types/scenarios/scorer_list_response.py">SyncScenarioScorersCursorIDPage[ScorerListResponse]</a></code>
-- <code title="post /v1/scenarios/scorers/{id}/validate">client.scenarios.scorers.<a href="./src/runloop_api_client/resources/scenarios/scorers.py">validate</a>(id, \*\*<a href="src/runloop_api_client/types/scenarios/scorer_validate_params.py">params</a>) -> <a href="./src/runloop_api_client/types/scenarios/scorer_validate_response.py">ScorerValidateResponse</a></code>
 
 # Objects
 
@@ -420,3 +420,24 @@ Methods:
 - <code title="post /v1/gateway-configs/{id}">client.gateway_configs.<a href="./src/runloop_api_client/resources/gateway_configs.py">update</a>(id, \*\*<a href="src/runloop_api_client/types/gateway_config_update_params.py">params</a>) -> <a href="./src/runloop_api_client/types/gateway_config_view.py">GatewayConfigView</a></code>
 - <code title="get /v1/gateway-configs">client.gateway_configs.<a href="./src/runloop_api_client/resources/gateway_configs.py">list</a>(\*\*<a href="src/runloop_api_client/types/gateway_config_list_params.py">params</a>) -> <a href="./src/runloop_api_client/types/gateway_config_view.py">SyncGatewayConfigsCursorIDPage[GatewayConfigView]</a></code>
 - <code title="post /v1/gateway-configs/{id}/delete">client.gateway_configs.<a href="./src/runloop_api_client/resources/gateway_configs.py">delete</a>(id) -> <a href="./src/runloop_api_client/types/gateway_config_view.py">GatewayConfigView</a></code>
+
+# McpConfigs
+
+Types:
+
+```python
+from runloop_api_client.types import (
+    McpConfigCreateParameters,
+    McpConfigListView,
+    McpConfigUpdateParameters,
+    McpConfigView,
+)
+```
+
+Methods:
+
+- <code title="post /v1/mcp-configs">client.mcp_configs.<a href="./src/runloop_api_client/resources/mcp_configs.py">create</a>(\*\*<a href="src/runloop_api_client/types/mcp_config_create_params.py">params</a>) -> <a href="./src/runloop_api_client/types/mcp_config_view.py">McpConfigView</a></code>
+- <code title="get /v1/mcp-configs/{id}">client.mcp_configs.<a href="./src/runloop_api_client/resources/mcp_configs.py">retrieve</a>(id) -> <a href="./src/runloop_api_client/types/mcp_config_view.py">McpConfigView</a></code>
+- <code title="post /v1/mcp-configs/{id}">client.mcp_configs.<a href="./src/runloop_api_client/resources/mcp_configs.py">update</a>(id, \*\*<a href="src/runloop_api_client/types/mcp_config_update_params.py">params</a>) -> <a href="./src/runloop_api_client/types/mcp_config_view.py">McpConfigView</a></code>
+- <code title="get /v1/mcp-configs">client.mcp_configs.<a href="./src/runloop_api_client/resources/mcp_configs.py">list</a>(\*\*<a href="src/runloop_api_client/types/mcp_config_list_params.py">params</a>) -> <a href="./src/runloop_api_client/types/mcp_config_view.py">SyncMcpConfigsCursorIDPage[McpConfigView]</a></code>
+- <code title="post /v1/mcp-configs/{id}/delete">client.mcp_configs.<a href="./src/runloop_api_client/resources/mcp_configs.py">delete</a>(id) -> <a href="./src/runloop_api_client/types/mcp_config_view.py">McpConfigView</a></code>

{runloop_api_client-1.5.0 → runloop_api_client-1.7.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "runloop_api_client"
-version = "1.5.0"
+version = "1.7.0"
 description = "The official Python library for the runloop API"
 dynamic = ["readme"]
 license = "MIT"

{runloop_api_client-1.5.0 → runloop_api_client-1.7.0}/src/runloop_api_client/_client.py

@@ -39,6 +39,7 @@ if TYPE_CHECKING:
         scenarios,
         benchmarks,
         blueprints,
+        mcp_configs,
         repositories,
         benchmark_jobs,
         benchmark_runs,
@@ -50,6 +51,7 @@ if TYPE_CHECKING:
     from .resources.secrets import SecretsResource, AsyncSecretsResource
     from .resources.benchmarks import BenchmarksResource, AsyncBenchmarksResource
     from .resources.blueprints import BlueprintsResource, AsyncBlueprintsResource
+    from .resources.mcp_configs import McpConfigsResource, AsyncMcpConfigsResource
     from .resources.repositories import RepositoriesResource, AsyncRepositoriesResource
     from .resources.benchmark_jobs import BenchmarkJobsResource, AsyncBenchmarkJobsResource
     from .resources.benchmark_runs import BenchmarkRunsResource, AsyncBenchmarkRunsResource
@@ -190,6 +192,12 @@ class Runloop(SyncAPIClient):
 
         return GatewayConfigsResource(self)
 
+    @cached_property
+    def mcp_configs(self) -> McpConfigsResource:
+        from .resources.mcp_configs import McpConfigsResource
+
+        return McpConfigsResource(self)
+
     @cached_property
     def with_raw_response(self) -> RunloopWithRawResponse:
         return RunloopWithRawResponse(self)
@@ -432,6 +440,12 @@ class AsyncRunloop(AsyncAPIClient):
 
         return AsyncGatewayConfigsResource(self)
 
+    @cached_property
+    def mcp_configs(self) -> AsyncMcpConfigsResource:
+        from .resources.mcp_configs import AsyncMcpConfigsResource
+
+        return AsyncMcpConfigsResource(self)
+
     @cached_property
     def with_raw_response(self) -> AsyncRunloopWithRawResponse:
         return AsyncRunloopWithRawResponse(self)
@@ -623,6 +637,12 @@ class RunloopWithRawResponse:
 
         return GatewayConfigsResourceWithRawResponse(self._client.gateway_configs)
 
+    @cached_property
+    def mcp_configs(self) -> mcp_configs.McpConfigsResourceWithRawResponse:
+        from .resources.mcp_configs import McpConfigsResourceWithRawResponse
+
+        return McpConfigsResourceWithRawResponse(self._client.mcp_configs)
+
 
 class AsyncRunloopWithRawResponse:
     _client: AsyncRunloop
@@ -702,6 +722,12 @@ class AsyncRunloopWithRawResponse:
 
         return AsyncGatewayConfigsResourceWithRawResponse(self._client.gateway_configs)
 
+    @cached_property
+    def mcp_configs(self) -> mcp_configs.AsyncMcpConfigsResourceWithRawResponse:
+        from .resources.mcp_configs import AsyncMcpConfigsResourceWithRawResponse
+
+        return AsyncMcpConfigsResourceWithRawResponse(self._client.mcp_configs)
+
 
 class RunloopWithStreamedResponse:
     _client: Runloop
@@ -781,6 +807,12 @@ class RunloopWithStreamedResponse:
 
         return GatewayConfigsResourceWithStreamingResponse(self._client.gateway_configs)
 
+    @cached_property
+    def mcp_configs(self) -> mcp_configs.McpConfigsResourceWithStreamingResponse:
+        from .resources.mcp_configs import McpConfigsResourceWithStreamingResponse
+
+        return McpConfigsResourceWithStreamingResponse(self._client.mcp_configs)
+
 
 class AsyncRunloopWithStreamedResponse:
     _client: AsyncRunloop
@@ -860,6 +892,12 @@ class AsyncRunloopWithStreamedResponse:
 
         return AsyncGatewayConfigsResourceWithStreamingResponse(self._client.gateway_configs)
 
+    @cached_property
+    def mcp_configs(self) -> mcp_configs.AsyncMcpConfigsResourceWithStreamingResponse:
+        from .resources.mcp_configs import AsyncMcpConfigsResourceWithStreamingResponse
+
+        return AsyncMcpConfigsResourceWithStreamingResponse(self._client.mcp_configs)
+
 
 Client = Runloop
 

{runloop_api_client-1.5.0 → runloop_api_client-1.7.0}/src/runloop_api_client/_version.py

@@ -1,4 +1,4 @@
 # File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 __title__ = "runloop_api_client"
-__version__ = "1.5.0"  # x-release-please-version
+__version__ = "1.7.0"  # x-release-please-version

{runloop_api_client-1.5.0 → runloop_api_client-1.7.0}/src/runloop_api_client/pagination.py

@@ -32,6 +32,8 @@ __all__ = [
     "AsyncNetworkPoliciesCursorIDPage",
     "SyncGatewayConfigsCursorIDPage",
     "AsyncGatewayConfigsCursorIDPage",
+    "SyncMcpConfigsCursorIDPage",
+    "AsyncMcpConfigsCursorIDPage",
 ]
 
 _T = TypeVar("_T")
@@ -102,6 +104,11 @@ class GatewayConfigsCursorIDPageItem(Protocol):
     id: str
 
 
+@runtime_checkable
+class McpConfigsCursorIDPageItem(Protocol):
+    id: str
+
+
 class SyncBlueprintsCursorIDPage(BaseSyncPage[_T], BasePage[_T], Generic[_T]):
     blueprints: List[_T]
     has_more: Optional[bool] = None
@@ -984,3 +991,71 @@ class AsyncGatewayConfigsCursorIDPage(BaseAsyncPage[_T], BasePage[_T], Generic[_
             return None
 
         return PageInfo(params={"starting_after": item.id})
+
+
+class SyncMcpConfigsCursorIDPage(BaseSyncPage[_T], BasePage[_T], Generic[_T]):
+    mcp_configs: List[_T]
+    has_more: Optional[bool] = None
+    total_count: Optional[int] = None
+
+    @override
+    def _get_page_items(self) -> List[_T]:
+        mcp_configs = self.mcp_configs
+        if not mcp_configs:
+            return []
+        return mcp_configs
+
+    @override
+    def has_next_page(self) -> bool:
+        has_more = self.has_more
+        if has_more is not None and has_more is False:
+            return False
+
+        return super().has_next_page()
+
+    @override
+    def next_page_info(self) -> Optional[PageInfo]:
+        mcp_configs = self.mcp_configs
+        if not mcp_configs:
+            return None
+
+        item = cast(Any, mcp_configs[-1])
+        if not isinstance(item, McpConfigsCursorIDPageItem) or item.id is None:  # pyright: ignore[reportUnnecessaryComparison]
+            # TODO emit warning log
+            return None
+
+        return PageInfo(params={"starting_after": item.id})
+
+
+class AsyncMcpConfigsCursorIDPage(BaseAsyncPage[_T], BasePage[_T], Generic[_T]):
+    mcp_configs: List[_T]
+    has_more: Optional[bool] = None
+    total_count: Optional[int] = None
+
+    @override
+    def _get_page_items(self) -> List[_T]:
+        mcp_configs = self.mcp_configs
+        if not mcp_configs:
+            return []
+        return mcp_configs
+
+    @override
+    def has_next_page(self) -> bool:
+        has_more = self.has_more
+        if has_more is not None and has_more is False:
+            return False
+
+        return super().has_next_page()
+
+    @override
+    def next_page_info(self) -> Optional[PageInfo]:
+        mcp_configs = self.mcp_configs
+        if not mcp_configs:
+            return None
+
+        item = cast(Any, mcp_configs[-1])
+        if not isinstance(item, McpConfigsCursorIDPageItem) or item.id is None:  # pyright: ignore[reportUnnecessaryComparison]
+            # TODO emit warning log
+            return None
+
+        return PageInfo(params={"starting_after": item.id})

{runloop_api_client-1.5.0 → runloop_api_client-1.7.0}/src/runloop_api_client/resources/__init__.py

@@ -56,6 +56,14 @@ from .blueprints import (
     BlueprintsResourceWithStreamingResponse,
     AsyncBlueprintsResourceWithStreamingResponse,
 )
+from .mcp_configs import (
+    McpConfigsResource,
+    AsyncMcpConfigsResource,
+    McpConfigsResourceWithRawResponse,
+    AsyncMcpConfigsResourceWithRawResponse,
+    McpConfigsResourceWithStreamingResponse,
+    AsyncMcpConfigsResourceWithStreamingResponse,
+)
 from .repositories import (
     RepositoriesResource,
     AsyncRepositoriesResource,
@@ -170,4 +178,10 @@ __all__ = [
     "AsyncGatewayConfigsResourceWithRawResponse",
     "GatewayConfigsResourceWithStreamingResponse",
     "AsyncGatewayConfigsResourceWithStreamingResponse",
+    "McpConfigsResource",
+    "AsyncMcpConfigsResource",
+    "McpConfigsResourceWithRawResponse",
+    "AsyncMcpConfigsResourceWithRawResponse",
+    "McpConfigsResourceWithStreamingResponse",
+    "AsyncMcpConfigsResourceWithStreamingResponse",
 ]

{runloop_api_client-1.5.0 → runloop_api_client-1.7.0}/src/runloop_api_client/resources/devboxes/devboxes.py

@@ -105,6 +105,7 @@ from ...types.devbox_tunnel_view import DevboxTunnelView
 from ...types.shared_params.mount import Mount
 from ...types.devbox_snapshot_view import DevboxSnapshotView
 from ...types.shared.launch_parameters import LaunchParameters as SharedLaunchParameters
+from ...types.devbox_resource_usage_view import DevboxResourceUsageView
 from ...types.devbox_execution_detail_view import DevboxExecutionDetailView
 from ...types.devbox_create_ssh_key_response import DevboxCreateSSHKeyResponse
 from ...types.shared_params.launch_parameters import LaunchParameters
@@ -189,6 +190,7 @@ class DevboxesResource(SyncAPIResource):
         file_mounts: Optional[Dict[str, str]] | Omit = omit,
         gateways: Optional[Dict[str, devbox_create_params.Gateways]] | Omit = omit,
         launch_parameters: Optional[LaunchParameters] | Omit = omit,
+        mcp: Optional[Iterable[devbox_create_params.Mcp]] | Omit = omit,
         metadata: Optional[Dict[str, str]] | Omit = omit,
         mounts: Optional[Iterable[Mount]] | Omit = omit,
         name: Optional[str] | Omit = omit,
@@ -239,6 +241,11 @@ class DevboxesResource(SyncAPIResource):
 
           launch_parameters: Parameters to configure the resources and launch time behavior of the Devbox.
 
+          mcp: [Beta] (Optional) MCP specifications for MCP server access. Each spec links an
+              MCP config to a secret. The devbox will receive environment variables
+              (RL_MCP_URL, RL_MCP_TOKEN) for accessing MCP servers through the MCP hub.
+              Example: [{'mcp_config': 'github-readonly', 'secret': 'MY_GITHUB_TOKEN'}]
+
           metadata: User defined metadata to attach to the devbox for organization.
 
           mounts: A list of mounts to be included in the Devbox.
@@ -281,6 +288,7 @@ class DevboxesResource(SyncAPIResource):
                     "file_mounts": file_mounts,
                     "gateways": gateways,
                     "launch_parameters": launch_parameters,
+                    "mcp": mcp,
                     "metadata": metadata,
                     "mounts": mounts,
                     "name": name,
@@ -498,6 +506,7 @@ class DevboxesResource(SyncAPIResource):
         file_mounts: Optional[Dict[str, str]] | Omit = omit,
         gateways: Optional[Dict[str, devbox_create_params.Gateways]] | Omit = omit,
         launch_parameters: Optional[LaunchParameters] | Omit = omit,
+        mcp: Optional[Iterable[devbox_create_params.Mcp]] | Omit = omit,
         metadata: Optional[Dict[str, str]] | Omit = omit,
         mounts: Optional[Iterable[Mount]] | Omit = omit,
         name: Optional[str] | Omit = omit,
@@ -539,6 +548,7 @@ class DevboxesResource(SyncAPIResource):
             file_mounts=file_mounts,
             gateways=gateways,
             launch_parameters=launch_parameters,
+            mcp=mcp,
             metadata=metadata,
             mounts=mounts,
             name=name,
@@ -652,7 +662,9 @@ class DevboxesResource(SyncAPIResource):
             cast_to=DevboxCreateSSHKeyResponse,
         )
 
-    @typing_extensions.deprecated("deprecated")
+    @typing_extensions.deprecated(
+        "create_tunnel is deprecated; use enable_tunnel or configure a tunnel at devbox creation."
+    )
     def create_tunnel(
         self,
         id: str,
@@ -666,7 +678,7 @@ class DevboxesResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
         idempotency_key: str | None = None,
     ) -> DevboxTunnelView:
-        """[Deprecated] Use POST /v1/devboxes/{id}/enable_tunnel instead.
+        """[Deprecated] Use enable_tunnel or configure a tunnel at devbox creation instead.
 
         This endpoint
         creates a legacy tunnel. The new enable_tunnel endpoint provides improved tunnel
@@ -1270,7 +1282,9 @@ class DevboxesResource(SyncAPIResource):
             cast_to=str,
         )
 
-    @typing_extensions.deprecated("deprecated")
+    @typing_extensions.deprecated(
+        "remove_tunnel is deprecated; V2 tunnels cannot be removed and close on devbox shutdown."
+    )
     def remove_tunnel(
         self,
         id: str,
@@ -1284,7 +1298,7 @@ class DevboxesResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
         idempotency_key: str | None = None,
     ) -> object:
-        """[Deprecated] Tunnels remain active until devbox is shutdown.
+        """[Deprecated] V2 tunnels cannot be removed and close on devbox shutdown.
 
         This endpoint
         removes a legacy tunnel.
@@ -1360,6 +1374,43 @@ class DevboxesResource(SyncAPIResource):
             cast_to=DevboxView,
         )
 
+    def retrieve_resource_usage(
+        self,
+        id: str,
+        *,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> DevboxResourceUsageView:
+        """Get resource usage metrics for a specific Devbox.
+
+        Returns CPU, memory, and disk
+        consumption calculated from the Devbox's lifecycle, excluding any suspended
+        periods for CPU and memory. Disk usage includes the full elapsed time since
+        storage is consumed even when suspended.
+
+        Args:
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not id:
+            raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
+        return self._get(
+            f"/v1/devboxes/{id}/usage",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=DevboxResourceUsageView,
+        )
+
     def shutdown(
         self,
         id: str,
@@ -1801,6 +1852,7 @@ class AsyncDevboxesResource(AsyncAPIResource):
         file_mounts: Optional[Dict[str, str]] | Omit = omit,
         gateways: Optional[Dict[str, devbox_create_params.Gateways]] | Omit = omit,
         launch_parameters: Optional[LaunchParameters] | Omit = omit,
+        mcp: Optional[Iterable[devbox_create_params.Mcp]] | Omit = omit,
         metadata: Optional[Dict[str, str]] | Omit = omit,
         mounts: Optional[Iterable[Mount]] | Omit = omit,
         name: Optional[str] | Omit = omit,
@@ -1851,6 +1903,11 @@ class AsyncDevboxesResource(AsyncAPIResource):
 
           launch_parameters: Parameters to configure the resources and launch time behavior of the Devbox.
 
+          mcp: [Beta] (Optional) MCP specifications for MCP server access. Each spec links an
+              MCP config to a secret. The devbox will receive environment variables
+              (RL_MCP_URL, RL_MCP_TOKEN) for accessing MCP servers through the MCP hub.
+              Example: [{'mcp_config': 'github-readonly', 'secret': 'MY_GITHUB_TOKEN'}]
+
           metadata: User defined metadata to attach to the devbox for organization.
 
           mounts: A list of mounts to be included in the Devbox.
@@ -1893,6 +1950,7 @@ class AsyncDevboxesResource(AsyncAPIResource):
                     "file_mounts": file_mounts,
                     "gateways": gateways,
                     "launch_parameters": launch_parameters,
+                    "mcp": mcp,
                     "metadata": metadata,
                     "mounts": mounts,
                     "name": name,
@@ -1957,6 +2015,7 @@ class AsyncDevboxesResource(AsyncAPIResource):
         file_mounts: Optional[Dict[str, str]] | Omit = omit,
         gateways: Optional[Dict[str, devbox_create_params.Gateways]] | Omit = omit,
         launch_parameters: Optional[LaunchParameters] | Omit = omit,
+        mcp: Optional[Iterable[devbox_create_params.Mcp]] | Omit = omit,
         metadata: Optional[Dict[str, str]] | Omit = omit,
         mounts: Optional[Iterable[Mount]] | Omit = omit,
         name: Optional[str] | Omit = omit,
@@ -1999,6 +2058,7 @@ class AsyncDevboxesResource(AsyncAPIResource):
             file_mounts=file_mounts,
             gateways=gateways,
             launch_parameters=launch_parameters,
+            mcp=mcp,
             metadata=metadata,
             mounts=mounts,
             name=name,
@@ -2261,7 +2321,9 @@ class AsyncDevboxesResource(AsyncAPIResource):
             cast_to=DevboxCreateSSHKeyResponse,
         )
 
-    @typing_extensions.deprecated("deprecated")
+    @typing_extensions.deprecated(
+        "create_tunnel is deprecated; use enable_tunnel or configure a tunnel at devbox creation."
+    )
     async def create_tunnel(
         self,
         id: str,
@@ -2275,7 +2337,7 @@ class AsyncDevboxesResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
         idempotency_key: str | None = None,
     ) -> DevboxTunnelView:
-        """[Deprecated] Use POST /v1/devboxes/{id}/enable_tunnel instead.
+        """[Deprecated] Use enable_tunnel or configure a tunnel at devbox creation instead.
 
         This endpoint
         creates a legacy tunnel. The new enable_tunnel endpoint provides improved tunnel
@@ -2882,7 +2944,9 @@ class AsyncDevboxesResource(AsyncAPIResource):
             cast_to=str,
         )
 
-    @typing_extensions.deprecated("deprecated")
+    @typing_extensions.deprecated(
+        "remove_tunnel is deprecated; V2 tunnels cannot be removed and close on devbox shutdown."
+    )
     async def remove_tunnel(
         self,
         id: str,
@@ -2896,7 +2960,7 @@ class AsyncDevboxesResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = not_given,
         idempotency_key: str | None = None,
     ) -> object:
-        """[Deprecated] Tunnels remain active until devbox is shutdown.
+        """[Deprecated] V2 tunnels cannot be removed and close on devbox shutdown.
 
         This endpoint
         removes a legacy tunnel.
@@ -2972,6 +3036,43 @@ class AsyncDevboxesResource(AsyncAPIResource):
             cast_to=DevboxView,
         )
 
+    async def retrieve_resource_usage(
+        self,
+        id: str,
+        *,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> DevboxResourceUsageView:
+        """Get resource usage metrics for a specific Devbox.
+
+        Returns CPU, memory, and disk
+        consumption calculated from the Devbox's lifecycle, excluding any suspended
+        periods for CPU and memory. Disk usage includes the full elapsed time since
+        storage is consumed even when suspended.
+
+        Args:
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if not id:
+            raise ValueError(f"Expected a non-empty value for `id` but received {id!r}")
+        return await self._get(
+            f"/v1/devboxes/{id}/usage",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=DevboxResourceUsageView,
+        )
+
     async def shutdown(
         self,
         id: str,
@@ -3426,6 +3527,9 @@ class DevboxesResourceWithRawResponse:
         self.resume = to_raw_response_wrapper(
             devboxes.resume,
         )
+        self.retrieve_resource_usage = to_raw_response_wrapper(
+            devboxes.retrieve_resource_usage,
+        )
         self.shutdown = to_raw_response_wrapper(
             devboxes.shutdown,
         )
@@ -3531,6 +3635,9 @@ class AsyncDevboxesResourceWithRawResponse:
         self.resume = async_to_raw_response_wrapper(
             devboxes.resume,
         )
+        self.retrieve_resource_usage = async_to_raw_response_wrapper(
+            devboxes.retrieve_resource_usage,
+        )
         self.shutdown = async_to_raw_response_wrapper(
             devboxes.shutdown,
         )
@@ -3636,6 +3743,9 @@ class DevboxesResourceWithStreamingResponse:
         self.resume = to_streamed_response_wrapper(
             devboxes.resume,
         )
+        self.retrieve_resource_usage = to_streamed_response_wrapper(
+            devboxes.retrieve_resource_usage,
+        )
         self.shutdown = to_streamed_response_wrapper(
             devboxes.shutdown,
         )
@@ -3741,6 +3851,9 @@ class AsyncDevboxesResourceWithStreamingResponse:
         self.resume = async_to_streamed_response_wrapper(
             devboxes.resume,
         )
+        self.retrieve_resource_usage = async_to_streamed_response_wrapper(
+            devboxes.retrieve_resource_usage,
+        )
         self.shutdown = async_to_streamed_response_wrapper(
             devboxes.shutdown,
         )