Create Task MCP Tools in Bulk

POST

/org/:org_id/project/:project_id/task_mcp_tool/bulk

POST

/api/v1/org/:org_id/project/:project_id/task_mcp_tool/bulk

$ curl -X POST https://app.rightbrain.ai/api/v1/org/org_id/project/project_id/task_mcp_tool/bulk \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json" \
>      -d '{
>   "task_mcp_server_id": "019dddec-95cf-f920-e103-a11283fe0819",
>   "tools": [
>     {
>       "name": "Search Docs",
>       "tool_name": "searchDocs"
>     }
>   ]
> }'

1 [
2   {
3     "id": "019dddec-b1c7-7e08-9a6d-2f3410db55e1",
4     "task_mcp_server_id": "019dddec-95cf-f920-e103-a11283fe0819",
5     "name": "Search Docs",
6     "tool_name": "searchDocs",
7     "safe_tool_name": "searchDocs",
8     "tool_timeout_seconds": 30,
9     "enabled": true,
10     "created": "2026-07-29T09:16:00.000000Z",
11     "modified": "2026-07-29T09:16:00.000000Z",
12     "description": null,
13     "tool_description": "Search the documentation at https://docs.rightbrain.ai. Returns relevant doc passages with source URLs.",
14     "tool_input_schema": {
15       "$schema": "http://json-schema.org/draft-07/schema#",
16       "additionalProperties": false,
17       "properties": {
18         "query": {
19           "description": "The search query to run against the docs",
20           "type": "string"
21         }
22       },
23       "required": [
24         "query"
25       ],
26       "type": "object"
27     }
28   }
29 ]

Every tool_name must exist on the remote server and must not already be registered for it. A repeat answers 400 naming the offending tool, so read the currently registered tools first if you are re-running this.

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 organization ID

project_idstringRequiredformat: "uuid"

The project ID

Request

This endpoint expects an object.

task_mcp_server_idstringRequiredformat: "uuid"

toolslist of objectsRequired

Response

MCP tools registered in request order

idstringformat: "uuid"

task_mcp_server_idstringformat: "uuid"

namestring

tool_namestring

safe_tool_namestring

tool_timeout_secondsinteger

enabledboolean

createdstring

modifiedstring

descriptionstring or nullOptional

tool_descriptionstring or nullOptional

tool_input_schemamap from strings to any 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