Create MCP Server

POST 
/v1/mcp-servers

Create a new MCP server with enhanced authentication and validation.

⚠️ BETA FEATURES: The following fields are in beta and may change in future releases:

• configuration.healthCheck - Health check configuration structure
• validationMode: async - Async validation behavior and scheduling

Stable Features (backward compatible):

• Core server properties: name, url, description
• Authentication: auth (OIDC, API Key)
• visibility, validationMode: skip|immediate

Status Codes:

• 201: Server created successfully
• 400: Invalid input (validation errors, bad auth config)
• 403: Forbidden (attempting to create public server)
• 409: Conflict (duplicate name or URL in environment)
• 500: Internal server error

Request

Responses

201

MCP server created successfully

400

Validation Error

403

Forbidden - Not authorized to create public servers

409

Conflict - Server with this ID, name or URL already exists in your environment

500

Internal Server Error - Unexpected server failure