OpenMCP

Run the install command pointing at an OpenAPI spec URL or file path. openmcp will prompt you for any required API keys, write an openmcp.json config file, and register the server with your AI client.

npx -y openmcp install https://api.weather.gov/openapi.json --client claude

The install command creates an openmcp.json file in your current directory. Open it to review the detected tools, configure auth headers or query parameters, and optionally restrict which tools are exposed using the 'tools' allowlist.

Edit openmcp.json to add authentication headers or query parameters. You can also reference environment variables by leaving the value empty — openmcp will read from the environment at runtime.

{
  "configs": {
    "my-api": {
      "MY_API_KEY": ""
    }
  },
  "servers": {
    "my-api": {
      "type": "openapi",
      "openapi": "https://api.example.com/openapi.json",
      "serverUrl": "https://api.example.com",
      "headers": {
        "Authorization": "Bearer {{MY_API_KEY}}"
      },
      "tools": []
    }
  }
}

To merge multiple servers into one, add additional entries to the 'servers' object in openmcp.json. You can mix OpenAPI servers and existing stdio MCP servers in a single config.

If you want to start the server without re-running the install command, use the run command pointing at your openmcp.json file. This is also useful for testing changes to your configuration.

npx -y openmcp run --config ./openmcp.json