API ReferenceMcp Servers

Create MCP Server

Configure a new MCP server for the project. MCP servers extend AI capabilities by providing access to external tools. Common server types include: - Database servers (PostgreSQL, MySQL, SQLite) - API integrations (GitHub, Slack, etc.) - File system access - Custom tool servers The server will be validated and synchronized to discover available tools.

Authentication

AuthorizationBearer

Bearer token authentication using JWT tokens from Ory Kratos/Hydra

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

Successful Response
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 null
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