Create MCP server

POST

/api/v1/mcp/servers

const url = 'https://example.com/api/v1/mcp/servers?projectId=00000000-0000-0000-0000-000000000000';
const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: '{"_id":"example","name":"example","type":"sse","url":"example","command":"example","args":["example"],"env":{"additionalProperty":"example"},"headers":[{"name":"example","value":"example"}],"sessionMode":"stateful","version":"example","description":"example"}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request POST \
  --url 'https://example.com/api/v1/mcp/servers?projectId=00000000-0000-0000-0000-000000000000' \
  --header 'Content-Type: application/json' \
  --data '{ "_id": "example", "name": "example", "type": "sse", "url": "example", "command": "example", "args": [ "example" ], "env": { "additionalProperty": "example" }, "headers": [ { "name": "example", "value": "example" } ], "sessionMode": "stateful", "version": "example", "description": "example" }'

Parameters

Query Parameters

projectId

required

Project scope. Required on scoped list and root-create operations; requests without a resolvable project are rejected with 400. There is no default project.

string

>= 1 characters

Example

00000000-0000-0000-0000-000000000000

Project scope. Required on scoped list and root-create operations; requests without a resolvable project are rejected with 400. There is no default project.

Request Body

application/json

object

_id

required

string

/^[a-z0-9]([a-z0-9-]*[a-z0-9])?$/

name

required

string

type

required

string

Allowed values: sse http stdio

url

string

command

string

args

Array<string>

env

object

key

additional properties

string

headers

Array<object>

object

name

required

string

value

required

string

sessionMode

string

Allowed values: stateful stateless

version

string

description

string

Responses

201

Success

application/json

object

_id

required

string

slug

required

string

name

required

string

type

required

string

Allowed values: sse http stdio

url

string

command

string

args

Array<string>

env

object

key

additional properties

string

headers

Array<object>

object

name

required

string

value

required

string

sessionMode

string

Allowed values: stateful stateless

version

string

description

string

createdAt

required

string | null format: date-time

updatedAt

string | null format: date-time

deletedAt

string | null format: date-time

projectId

required

string

Example

{
  "type": "sse",
  "sessionMode": "stateful"
}