mcp.json

The mcp.json file configures the target MCP servers that MCPX will launch and manage dynamically. MCPX reads this file at startup to determine which MCP servers to load within its process. By default, It is located in the config file created during set up, and is populated as you connect more servers in the Control Plane.

You can configure multiple MCP servers in a single file, such as Time or Memory, so MCPX can orchestrate them seamlessly.

Parameters

Parameter	Required	Description
mcpServers	true	A top-level object containing named MCP server entries.
name	true	The unique identifier or display name for the MCP server. This helps distinguish it in the MCPX UI.
command	true	Specifies the CLI or executable to start the MCP server (e.g., uvx, npx).
args	true	An array of strings passed as arguments to the command.
env	false	A map of environment variables scoped to that MCP server process.
icon	false	A visual emoji label used to help identify the server in the UI.

Example

mcp.json

{
  "mcpServers": {
    "memory": {
      "args": [
        "-y",
        "@modelcontextprotocol/server-memory"
      ],
      "command": "npx",
      "env": {
        "MEMORY_FILE_PATH": "/path/to/custom/memory.json"
      },
      "icon": "📝"
    },
    "time": {
      "args": [
        "mcp_server_time",
        "--local-timezone=America/New_York"
      ],
      "command": "uvx",
      "env": {},
      "icon": "⏰"
    }
  }
}