Create Task MCP Server

POST

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

POST

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

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

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 }

transport is streamable_http or sse. Supplying it registers the server without ever contacting it; omit it and Rightbrain probes the server to detect the transport, which is the only part of registration that needs the server to be reachable. Either way the tools are not read here — register them against the server afterwards, which does contact it.

Authentication is optional: supply api_key with api_key_strategy and api_key_header_name for a key-based server, or complete the OAuth flow above and pass auth_session_id. Credentials are stored, never returned.

Register a remote MCP server in this project. `transport` is `streamable_http` or `sse`. Supplying it registers the server without ever contacting it; omit it and Rightbrain probes the server to detect the transport, which is the only part of registration that needs the server to be reachable. Either way the tools are not read here — register them against the server afterwards, which does contact it. Authentication is optional: supply `api_key` with `api_key_strategy` and `api_key_header_name` for a key-based server, or complete the OAuth flow above and pass `auth_session_id`. Credentials are stored, never returned.

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

org_idstringRequiredformat: "uuid"

The unique identifier of the organization.

project_idstringRequiredformat: "uuid"

The unique identifier of the project.

Request

This endpoint expects an object.

namestringRequired1-255 characters

server_urlstringRequiredformat: "uri"1-2083 characters

descriptionstring or nullOptional

enabledbooleanOptionalDefaults to true

auth_session_idstring or nullOptional

api_keystring or nullOptionalformat: "password"

api_key_strategyenum or nullOptional

api_key_header_namestring or nullOptional

transportenum or nullOptional

Response

The registered 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

409

Conflict Error

422

Unprocessable Entity Error

500

Internal Server Error

503

Service Unavailable Error