List Task MCP Tools

GET

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

GET

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

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

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

List the MCP tools registered in this project, newest first. Filter to one server to see what it currently exposes to your agents.

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.

Query parameters

task_mcp_server_idstring or nullOptionalformat: "uuid"

Return only tools registered against this Task MCP server id. Omit to list the tools from every server in the project.

page_limitintegerOptionalDefaults to 100

Maximum number of tools to return.

cursorstring or nullOptionalformat: "uuid"

Pagination cursor. Pass pagination.next_cursor from the previous page, which is the id of its last tool.

Response

Successfully retrieved MCP tools

resultslist of objects

The list of items returned for the current page.

paginationobject or nullOptional

Contains pagination information for the result set.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

422

Unprocessable Entity Error

500

Internal Server Error