Refresh Task MCP Server

POST

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

POST

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

$ curl -X POST https://app.rightbrain.ai/api/v1/org/org_id/project/project_id/task_mcp_server/task_mcp_server_id/refresh \
>      -H "Authorization: Bearer <token>"

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:15:00.000000Z",
12   "description": "Rightbrain documentation search.",
13   "enabled": true,
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 }

Re-probe the server and update the registration’s transport and authorization state.

Use this after the remote server changes, or after its credentials expire: the registration is checked when it is created, not continuously.

It answers 200 either way. A server that cannot be reached, or that rejects the stored credentials, is reported by moving auth_state to reauth_required and setting auth_state_reason to server_unreachable or credentials_rejected — not by an error status. Read those two fields rather than the status code. Existing tool registrations are left alone; this does not remove a tool the server has stopped exposing.

Re-probe the server and update the registration's transport and authorization state. Use this after the remote server changes, or after its credentials expire: the registration is checked when it is created, not continuously. It answers 200 either way. A server that cannot be reached, or that rejects the stored credentials, is reported by moving `auth_state` to `reauth_required` and setting `auth_state_reason` to `server_unreachable` or `credentials_rejected` — not by an error status. Read those two fields rather than the status code. Existing tool registrations are left alone; this does not remove a tool the server has stopped exposing.

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.

Response

The refreshed MCP server

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