Create MCP Server

POST

/org/:org_id/project/:project_id/mcp_server

POST

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

$ curl -X POST https://app.rightbrain.ai/api/v1/org/org_id/project/project_id/mcp_server \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json" \
>      -d '{
>   "name": "acme-analytics-postgres",
>   "url": "https://analytics-mcp.acme-logistics.com",
>   "description": "Read-only MCP access to the analytics warehouse for reporting queries."
> }'

1 {
2   "name": "acme-company-wiki",
3   "url": "https://wiki-mcp.acme-logistics.com",
4   "id": "0198c1e4-4d6e-7c13-a05f-6b7c8d9e0f10",
5   "short_id": "c1e44d6e",
6   "project_id": "0190a234-9876-5432-10ab-cdef01234567",
7   "syncd": false,
8   "created": "2026-07-01T11:00:00Z",
9   "modified": "2026-07-01T11:00:00Z",
10   "description": "MCP access to the internal company wiki for knowledge lookup."
11 }

MCP servers extend AI capabilities by providing access to external tools over the Model Context Protocol. Common examples include:

Database or analytics servers exposing read-only query tools
Ticketing or CRM integrations
Internal wiki or knowledge-base lookup

Registration only requires the server’s root URL, which must be a root URL without path components; the server is not synchronized yet when this call returns (syncd: false) and must be marked synced afterward to discover its available tools.

Register a new MCP server for the project. MCP servers extend AI capabilities by providing access to external tools over the Model Context Protocol. Common examples include: - Database or analytics servers exposing read-only query tools - Ticketing or CRM integrations - Internal wiki or knowledge-base lookup Registration only requires the server's root URL, which must be a root URL without path components; the server is not synchronized yet when this call returns (`syncd: false`) and must be marked synced afterward to discover its available tools.

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-64 characters

MCP server name

urlstringRequired1-255 characters

Root URL of the MCP server

descriptionstring or nullOptional

Description of the MCP server

Response

MCP server registered (not yet synchronized)

namestring1-64 characters

MCP server name

urlstring1-255 characters

Root URL of the MCP server

idstringformat: "uuid"

Unique identifier for the MCP server

short_idstring<=8 characters

Short identifier for the MCP server

project_idstringformat: "uuid"

Project ID this MCP server belongs to

syncdboolean

Whether the server has been sync'd to external proxy

createdstring

Timestamp when the MCP server was created

modifiedstring

Timestamp when the MCP server was last modified

descriptionstring or nullOptional

Description of the MCP server

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

422

Unprocessable Entity Error

500

Internal Server Error