BRbraintrustdata
McpServers

Create or replace MCP server

Changed on

Create or replace MCP server. If there is an existing MCP server with the same name as the one specified in the request, will replace the existing MCP server with the provided fields

put/v1/mcp_server

Request

  • Base URL
    https://api.braintrust.dev
  • Auth
    • HTTP bearer
    • or none

Request body

project_idstring uuid required

Unique identifier for the project that the MCP server belongs under

namestring required

Name of the MCP server. Within a project, MCP server names are unique

descriptionstring nullable

Textual description of the MCP server

urlstring required

URL of the MCP server endpoint

Response

Returns the new MCP server object

idstring uuid required

Unique identifier for the MCP server

project_idstring uuid required

Unique identifier for the project that the MCP server belongs under

user_idstring uuid nullable

Identifies the user who created the MCP server

createdstring date-time nullable

Date of MCP server creation

deleted_atstring date-time nullable

Date of MCP server deletion, or null if the MCP server is still active

namestring required

Name of the MCP server. Within a project, MCP server names are unique

descriptionstring nullable

Textual description of the MCP server

urlstring required

URL of the MCP server endpoint

Changes