Update Task MCP Tool

POST

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

POST

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

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

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": false,
9   "created": "2026-07-29T09:16:00.000000Z",
10   "modified": "2026-07-29T09:21:00.000000Z",
11   "description": "Searches the Rightbrain documentation by keyword.",
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 }

Update a registered tool’s label, description or enabled state.

tool_name cannot be changed — register a different tool instead. Disabling keeps the registration but hides the tool from agents.

The remote server is not contacted, so the fields copied from it at registration — tool_description, tool_input_schema, safe_tool_name — come back unchanged. The stored tool_input_schema is re-checked, though, so a tool whose remote schema is no longer one Rightbrain can model answers 400 with an Unsupported MCP tool input schema message even when the fields you sent are fine; re-register the tool to pick the schema up again.

Update a registered tool's label, description or enabled state. `tool_name` cannot be changed — register a different tool instead. Disabling keeps the registration but hides the tool from agents. The remote server is not contacted, so the fields copied from it at registration — `tool_description`, `tool_input_schema`, `safe_tool_name` — come back unchanged. The stored `tool_input_schema` is re-checked, though, so a tool whose remote schema is no longer one Rightbrain can model answers 400 with an `Unsupported MCP tool input schema` message even when the fields you sent are fine; re-register the tool to pick the schema up again.

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_tool_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

Response

MCP tool updated successfully

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