Update Task MCP Server

POST

/org/:org_id/project/:project_id/task_mcp_server/:task_mcp_server_id

POST

/api/v1/org/:org_id/project/:project_id/task_mcp_server/:task_mcp_server_id

$ curl -X POST https://app.rightbrain.ai/api/v1/org/org_id/project/project_id/task_mcp_server/task_mcp_server_id \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json" \
>      -d '{
>   "description": "Rightbrain documentation search.",
>   "enabled": false
> }'

1 {
2   "name": "docs-search",
3   "server_url": "https://docs.rightbrain.ai/mcp",
4   "id": "019dddec-95cf-f920-e103-a11283fe0819",
5   "canonical_resource": "https://docs.rightbrain.ai/mcp",
6   "transport": "streamable_http",
7   "auth_state": "none",
8   "auth_type": "none",
9   "project_id": "0190a234-9876-5432-10ab-cdef01234567",
10   "created": "2026-07-29T09:15:00.000000Z",
11   "modified": "2026-07-29T09:20:00.000000Z",
12   "description": "Rightbrain documentation search.",
13   "enabled": false,
14   "catalog_server_id": null,
15   "catalog_server_slug": null,
16   "auth_state_reason": null,
17   "auth_strategy": null,
18   "auth_header_name": null
19 }

Update a registered server’s metadata, credentials or enabled state.

server_url and transport cannot be changed — register a new server instead, so existing tool registrations keep pointing at the endpoint they were checked against. Disabling keeps the registration but stops agents using its tools.

The remote server is not contacted, so this records what you send without re-checking it. Pass auth_session_id to attach credentials from a completed authorization flow, or api_key with api_key_strategy and api_key_header_name to replace a stored key; either moves auth_state to connected and clears auth_state_reason.

Update a registered server's metadata, credentials or enabled state. `server_url` and `transport` cannot be changed — register a new server instead, so existing tool registrations keep pointing at the endpoint they were checked against. Disabling keeps the registration but stops agents using its tools. The remote server is not contacted, so this records what you send without re-checking it. Pass `auth_session_id` to attach credentials from a completed authorization flow, or `api_key` with `api_key_strategy` and `api_key_header_name` to replace a stored key; either moves `auth_state` to `connected` and clears `auth_state_reason`.

Authentication

AuthorizationBearer

API key or access token, sent as Authorization: Bearer <token>. The simplest option: create an API key in your dashboard under Settings, then paste it here.

AuthorizationBearer

API key or access token, sent as Authorization: Bearer <token>. The simplest option: create an API key in your dashboard under Settings, then paste it here.

Path parameters

task_mcp_server_idstringRequiredformat: "uuid"

org_idstringRequiredformat: "uuid"

The unique identifier of the organization.

project_idstringRequiredformat: "uuid"

The unique identifier of the project.

Request

This endpoint expects an object.

namestring or nullOptional1-255 characters

descriptionstring or nullOptional

enabledboolean or nullOptional

auth_session_idstring or nullOptional

api_keystring or nullOptionalformat: "password"

api_key_strategyenum or nullOptional

api_key_header_namestring or nullOptional

Response

MCP server updated successfully

namestring1-255 characters

server_urlstringformat: "uri"1-2083 characters

idstringformat: "uuid"

canonical_resourcestringformat: "uri"1-2083 characters

transportenum

auth_stateenum

auth_typeenum

project_idstringformat: "uuid"

createdstring

modifiedstring

descriptionstring or nullOptional

enabledbooleanOptionalDefaults to true

catalog_server_idstring or nullOptionalformat: "uuid"

catalog_server_slugstring or nullOptional

auth_state_reasonenum or nullOptional

auth_strategyenum or nullOptional

auth_header_namestring or nullOptional

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

422

Unprocessable Entity Error

500

Internal Server Error

503

Service Unavailable Error