Discover MCP Server Tools

POST

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

POST

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

$ curl -X POST https://app.rightbrain.ai/api/v1/org/org_id/project/project_id/task_mcp_server/discover \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json" \
>      -d '{
>   "server_url": "https://docs.rightbrain.ai/mcp"
> }'

1 {
2   "server_url": "https://docs.rightbrain.ai/mcp",
3   "canonical_resource": "https://docs.rightbrain.ai/mcp",
4   "tools": [
5     {
6       "name": "searchDocs",
7       "description": "Search the documentation at https://docs.rightbrain.ai. Returns relevant doc passages with source URLs.",
8       "input_schema": {
9         "$schema": "http://json-schema.org/draft-07/schema#",
10         "additionalProperties": false,
11         "properties": {
12           "query": {
13             "description": "The search query to run against the docs",
14             "type": "string"
15           }
16         },
17         "required": [
18           "query"
19         ],
20         "type": "object"
21       }
22     }
23   ],
24   "transport": "streamable_http"
25 }

Ask a remote MCP server what tools it exposes, without registering anything. Call this before registering tools so the names come from the server rather than a guess. Accepts the same authentication fields as registration, so a server behind an API key can be inspected before it is stored.

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.

server_urlstringRequiredformat: "uri"1-2083 characters

auth_session_idstring or nullOptional

api_keystring or nullOptionalformat: "password"

api_key_strategyenum or nullOptional

api_key_header_namestring or nullOptional

Response

The tools the server exposes

server_urlstringformat: "uri"1-2083 characters

canonical_resourcestringformat: "uri"1-2083 characters

toolslist of objects

transportenum

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

422

Unprocessable Entity Error

500

Internal Server Error