Create Task MCP Tool

POST

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

POST

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

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

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

tool_name must be a tool the remote server actually exposes — call discoverMcpServerTools first to list them. The API contacts the server while handling this request, so an unreachable server or an unknown tool answers 400 rather than creating anything.

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

tool_namestringRequired1-255 characters

task_mcp_server_idstringRequiredformat: "uuid"

descriptionstring or nullOptional

enabledbooleanOptionalDefaults to true

Response

MCP tool registered

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