feat(devbox): add mcp configuration to devbox create (#7341)

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 116
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/runloop-ai%2Frunloop-eb90951855ef91c431a7b07ea6a42c1c470c1a0c905e19e4926b48e8039bf4cb.yml
-openapi_spec_hash: e98232f95d6fd27f1200e354cee0059a
+configured_endpoints: 117
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/runloop-ai%2Frunloop-15b7fd06098d8cb3639efb3b401a03d7d97a8ab4960b08077aa871f0cacb33d3.yml
+openapi_spec_hash: 93ab2fe88f9e57d8f262ad6d1179190e
 config_hash: eb28692edd68a6ae95cf92af931c9976

api.md

@@ -263,12 +263,14 @@ Methods:
 
 Types:
 
+- <code><a href="./src/resources/scenarios/scorers.ts">ScorerCreateResponse</a></code>
 - <code><a href="./src/resources/scenarios/scorers.ts">ScorerRetrieveResponse</a></code>
 - <code><a href="./src/resources/scenarios/scorers.ts">ScorerUpdateResponse</a></code>
 - <code><a href="./src/resources/scenarios/scorers.ts">ScorerListResponse</a></code>
 
 Methods:
 
+- <code title="post /v1/scenarios/scorers">client.scenarios.scorers.<a href="./src/resources/scenarios/scorers.ts">create</a>({ ...params }) -> ScorerCreateResponse</code>
 - <code title="get /v1/scenarios/scorers/{id}">client.scenarios.scorers.<a href="./src/resources/scenarios/scorers.ts">retrieve</a>(id) -> ScorerRetrieveResponse</code>
 - <code title="post /v1/scenarios/scorers/{id}">client.scenarios.scorers.<a href="./src/resources/scenarios/scorers.ts">update</a>(id, { ...params }) -> ScorerUpdateResponse</code>
 - <code title="get /v1/scenarios/scorers">client.scenarios.scorers.<a href="./src/resources/scenarios/scorers.ts">list</a>({ ...params }) -> ScorerListResponsesScenarioScorersCursorIDPage</code>

src/resources/devboxes/devboxes.ts

@@ -1104,6 +1104,14 @@ export interface DevboxCreateParams {
    */
   launch_parameters?: Shared.LaunchParameters | null;
 
+  /**
+   * [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'}]
+   */
+  mcp?: Array<DevboxCreateParams.Mcp> | null;
+
   /**
    * User defined metadata to attach to the devbox for organization.
    */
@@ -1164,6 +1172,24 @@ export namespace DevboxCreateParams {
     secret: string;
   }
 
+  /**
+   * [Beta] McpSpec links an MCP configuration to a secret for MCP server access in a
+   * devbox. The MCP hub will proxy requests to upstream MCP servers using the
+   * specified credential, with tool-level access control based on the MCP config's
+   * allowed_tools.
+   */
+  export interface Mcp {
+    /**
+     * The MCP config to use. Can be an MCP config ID (mcp_xxx) or name.
+     */
+    mcp_config: string;
+
+    /**
+     * The secret containing the MCP server credential. Can be a secret ID or name.
+     */
+    secret: string;
+  }
+
   /**
    * (Optional) Configuration for creating a V2 tunnel at Devbox launch time. When
    * specified, a tunnel will be automatically provisioned and the tunnel details

src/resources/mcp-configs.ts

@@ -184,11 +184,6 @@ export interface McpConfigView {
    */
   name: string;
 
-  /**
-   * The account ID that owns this config.
-   */
-  account_id?: string | null;
-
   /**
    * Optional description for this MCP configuration.
    */

src/resources/scenarios/index.ts

@@ -28,9 +28,11 @@ export {
 export {
   ScorerListResponsesScenarioScorersCursorIDPage,
   Scorers,
+  type ScorerCreateResponse,
   type ScorerRetrieveResponse,
   type ScorerUpdateResponse,
   type ScorerListResponse,
+  type ScorerCreateParams,
   type ScorerUpdateParams,
   type ScorerListParams,
 } from './scorers';

src/resources/scenarios/scenarios.ts

@@ -8,6 +8,8 @@ import * as RunsAPI from './runs';
 import { RunListParams, Runs } from './runs';
 import * as ScorersAPI from './scorers';
 import {
+  ScorerCreateParams,
+  ScorerCreateResponse,
   ScorerListParams,
   ScorerListResponse,
   ScorerListResponsesScenarioScorersCursorIDPage,
@@ -874,10 +876,12 @@ export declare namespace Scenarios {
 
   export {
     Scorers as Scorers,
+    type ScorerCreateResponse as ScorerCreateResponse,
     type ScorerRetrieveResponse as ScorerRetrieveResponse,
     type ScorerUpdateResponse as ScorerUpdateResponse,
     type ScorerListResponse as ScorerListResponse,
     ScorerListResponsesScenarioScorersCursorIDPage as ScorerListResponsesScenarioScorersCursorIDPage,
+    type ScorerCreateParams as ScorerCreateParams,
     type ScorerUpdateParams as ScorerUpdateParams,
     type ScorerListParams as ScorerListParams,
   };

src/resources/scenarios/scorers.ts

@@ -6,6 +6,13 @@ import * as Core from '../../core';
 import { ScenarioScorersCursorIDPage, type ScenarioScorersCursorIDPageParams } from '../../pagination';
 
 export class Scorers extends APIResource {
+  /**
+   * Create a custom scenario scorer.
+   */
+  create(body: ScorerCreateParams, options?: Core.RequestOptions): Core.APIPromise<ScorerCreateResponse> {
+    return this._client.post('/v1/scenarios/scorers', { body, ...options });
+  }
+
   /**
    * Retrieve Scenario Scorer.
    */
@@ -50,6 +57,26 @@ export class Scorers extends APIResource {
 
 export class ScorerListResponsesScenarioScorersCursorIDPage extends ScenarioScorersCursorIDPage<ScorerListResponse> {}
 
+/**
+ * A ScenarioScorerView represents a custom scoring function for a Scenario.
+ */
+export interface ScorerCreateResponse {
+  /**
+   * ID for the scenario scorer.
+   */
+  id: string;
+
+  /**
+   * Bash script that takes in $RL_SCORER_CONTEXT as env variable and runs scoring.
+   */
+  bash_script: string;
+
+  /**
+   * Name of the type of scenario scorer.
+   */
+  type: string;
+}
+
 /**
  * A ScenarioScorerView represents a custom scoring function for a Scenario.
  */
@@ -110,6 +137,19 @@ export interface ScorerListResponse {
   type: string;
 }
 
+export interface ScorerCreateParams {
+  /**
+   * Bash script for the custom scorer taking context as a json object
+   * $RL_SCORER_CONTEXT.
+   */
+  bash_script: string;
+
+  /**
+   * Name of the type of custom scorer.
+   */
+  type: string;
+}
+
 export interface ScorerUpdateParams {
   /**
    * Bash script for the custom scorer taking context as a json object
@@ -129,10 +169,12 @@ Scorers.ScorerListResponsesScenarioScorersCursorIDPage = ScorerListResponsesScen
 
 export declare namespace Scorers {
   export {
+    type ScorerCreateResponse as ScorerCreateResponse,
     type ScorerRetrieveResponse as ScorerRetrieveResponse,
     type ScorerUpdateResponse as ScorerUpdateResponse,
     type ScorerListResponse as ScorerListResponse,
     ScorerListResponsesScenarioScorersCursorIDPage as ScorerListResponsesScenarioScorersCursorIDPage,
+    type ScorerCreateParams as ScorerCreateParams,
     type ScorerUpdateParams as ScorerUpdateParams,
     type ScorerListParams as ScorerListParams,
   };

tests/api-resources/devboxes/devboxes.test.ts

@@ -61,6 +61,7 @@ describe('resource devboxes', () => {
             resource_size_request: 'X_SMALL',
             user_parameters: { uid: 0, username: 'username' },
           },
+          mcp: [{ mcp_config: 'mcp_config', secret: 'secret' }],
           metadata: { foo: 'string' },
           mounts: [
             {

tests/api-resources/scenarios/scorers.test.ts

@@ -9,6 +9,21 @@ const client = new Runloop({
 });
 
 describe('resource scorers', () => {
+  test('create: only required params', async () => {
+    const responsePromise = client.scenarios.scorers.create({ bash_script: 'bash_script', type: 'type' });
+    const rawResponse = await responsePromise.asResponse();
+    expect(rawResponse).toBeInstanceOf(Response);
+    const response = await responsePromise;
+    expect(response).not.toBeInstanceOf(Response);
+    const dataAndResponse = await responsePromise.withResponse();
+    expect(dataAndResponse.data).toBe(response);
+    expect(dataAndResponse.response).toBe(rawResponse);
+  });
+
+  test('create: required and optional params', async () => {
+    const response = await client.scenarios.scorers.create({ bash_script: 'bash_script', type: 'type' });
+  });
+
   test('retrieve', async () => {
     const responsePromise = client.scenarios.scorers.retrieve('id');
     const rawResponse = await responsePromise.asResponse();