Update a custom MCP server

POST 
/api/v1/mcp-servers/update

Replaces the mutable server configuration and increments its version. Read the saved record, edit the intended fields and submit the complete desired server: omitting enabled disables it, and omitted optional fields are cleared. The top-level serverId selects the record; an update cannot rename it. There is no revision precondition, so concurrent stale updates can overwrite one another.

A saved update does not confirm that every subsequent call has switched to the new configuration, and it does not cancel in-flight calls. Use get to inspect the saved record and test-connection to check a connection using it. The same validation as create applies; an unknown server returns 404.

The following access conditions are preserved as declared intent and are not implemented by generated code: Authorized scoped domain action.

Use this in a guide: Answer questions about a website using your own Firecrawl account

Request

Responses

200

Server updated; the stored record is echoed back

Replace an existing server configuration; preserve the intended authentication and enabled settings.

Section ID: DOC-IN-tools-connections-servers-api-updateCustomMcpServer#example-mcp-servers-updateCustomMcpServer-request

Request example

{
  "serverId": "product-tools",
  "server": {
    "serverId": "product-tools",
    "displayName": "Product tools",
    "endpoint": "https://mcp.example.com/mcp",
    "authType": "CUSTOM_MCP_SERVER_AUTH_TYPE_NONE",
    "enabled": true
  }
}

Illustrative response shape; omitted default fields and actual outcomes depend on the operation.

Section ID: DOC-IN-tools-connections-servers-api-updateCustomMcpServer#example-mcp-servers-updateCustomMcpServer-response

Response example

{
  "server": {
    "serverId": "example-id",
    "displayName": "example",
    "description": "example",
    "endpoint": "https://example.com/callback",
    "authType": "CUSTOM_MCP_SERVER_AUTH_TYPE_NONE",
    "enabled": true,
    "requestTimeout": "1s",
    "version": "1",
    "createdBy": "example",
    "createdAt": "2026-09-16T12:00:00Z",
    "updatedAt": "2026-09-16T12:00:00Z"
  }
}

Document ID: DOC-IN-tools-connections-servers-api-updateCustomMcpServer. Section identities and revisions.

Section	Stable reference
Update a custom MCP server	DOC-IN-tools-connections-servers-api-updateCustomMcpServer#overview
Request	DOC-IN-tools-connections-servers-api-updateCustomMcpServer#request
Responses	DOC-IN-tools-connections-servers-api-updateCustomMcpServer#responses