Runloop · Schema

Runloop Mcp Config

An McpConfig defines a configuration for connecting to an upstream MCP (Model Context Protocol) server. It specifies the target endpoint and which tools are allowed.

AIAI AgentsCoding AgentsSandboxesDevboxesCode ExecutionEvaluationBenchmarksSWE-BenchMCPSnapshotsmicroVMEnterpriseSOC 2

Properties

Name	Type	Description
id	string	The unique identifier of the McpConfig.
name	string	The human-readable name of the McpConfig. Unique per account.
endpoint	string	The target MCP server endpoint URL (e.g., 'https://mcp.example.com').
allowed_tools	array	Glob patterns specifying which tools are allowed from this MCP server (e.g., ['github.search_', 'github.get_'] or ['*'] for all tools).
description	string	Optional description for this MCP configuration.
create_time_ms	integer	Creation time of the McpConfig (Unix timestamp in milliseconds).

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/runloop-ai/main/json-schema/runloop-mcp-config-schema.json",
  "title": "Runloop Mcp Config",
  "description": "An McpConfig defines a configuration for connecting to an upstream MCP (Model Context Protocol) server. It specifies the target endpoint and which tools are allowed.",
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "id": {
      "type": "string",
      "description": "The unique identifier of the McpConfig."
    },
    "name": {
      "type": "string",
      "description": "The human-readable name of the McpConfig. Unique per account."
    },
    "endpoint": {
      "type": "string",
      "description": "The target MCP server endpoint URL (e.g., 'https://mcp.example.com')."
    },
    "allowed_tools": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Glob patterns specifying which tools are allowed from this MCP server (e.g., ['github.search_*', 'github.get_*'] or ['*'] for all tools)."
    },
    "description": {
      "type": "string",
      "nullable": true,
      "description": "Optional description for this MCP configuration."
    },
    "create_time_ms": {
      "type": "integer",
      "format": "int64",
      "description": "Creation time of the McpConfig (Unix timestamp in milliseconds)."
    }
  },
  "required": [
    "id",
    "name",
    "endpoint",
    "allowed_tools",
    "create_time_ms"
  ],
  "$defs": {}
}