mcp-configs

[Beta] Create an McpConfig.

Changed on

[Beta] Create a new McpConfig to connect to an upstream MCP (Model Context Protocol) server. The config specifies the target endpoint and which tools are allowed.

post/v1/mcp-configs

Request

  • Base URL: https://api.runloop.ai
  • URL: https://api.runloop.ai/v1/mcp-configs
  • Auth: HTTP bearer

Request body

namestring required

The human-readable name for the McpConfig. Must be unique within your account. The first segment before '-' is used as the service name for tool routing (e.g., 'github-readonly' uses 'github' as the service name).

endpointstring required

The target MCP server endpoint URL (e.g., 'https://mcp.example.com').

allowed_toolsstring[] required

Glob patterns specifying which tools are allowed from this MCP server. Examples: [''] for all tools, ['github.search_', 'github.get_*'] for specific patterns.

descriptionstring nullable

Optional description for this MCP configuration.

Response

McpConfig created successfully.

idstring required

The unique identifier of the McpConfig.

namestring required

The human-readable name of the McpConfig. Unique per account.

endpointstring required

The target MCP server endpoint URL (e.g., 'https://mcp.example.com').

allowed_toolsstring[] required

Glob patterns specifying which tools are allowed from this MCP server (e.g., ['github.search_', 'github.get_'] or ['*'] for all tools).

descriptionstring nullable

Optional description for this MCP configuration.

create_time_msinteger required

Creation time of the McpConfig (Unix timestamp in milliseconds).

Changes

  • e9dc776053e4Revision changes
    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the optional property to the response with the status

    • info

      added the required property to the response with the status

  • d3ddb452754cRevision changes
    • breaking

      the request property became not nullable