Create Mcp Server

post/v1/mcp-servers/

Add a new MCP server to the Letta MCP server config

Body ParametersExpand Collapse

body: CreateStdioMcpServer { args, command, server_name, 2 more } or CreateSseMcpServer { server_name, server_url, auth_header, 3 more } or CreateStreamableHTTPMcpServer { server_name, server_url, auth_header, 3 more }

Create a new Stdio MCP server

Accepts one of the following:

CreateStdioMcpServer = object { args, command, server_name, 2 more }

Create a new Stdio MCP server

args: array of string

The arguments to pass to the command

command: string

The command to run (MCP 'local' client will run this command)

server_name: string

The name of the server

env: optional map[string]

Environment variables to set

type: optional "sse" or "stdio" or "streamable_http"

Accepts one of the following:

"sse"

"stdio"

"streamable_http"

CreateSseMcpServer = object { server_name, server_url, auth_header, 3 more }

Create a new SSE MCP server

server_name: string

The name of the server

server_url: string

The URL of the server

auth_header: optional string

The name of the authentication header (e.g., 'Authorization')

auth_token: optional string

The authentication token or API key value

custom_headers: optional map[string]

Custom HTTP headers to include with requests

type: optional "sse" or "stdio" or "streamable_http"

Accepts one of the following:

"sse"

"stdio"

"streamable_http"

CreateStreamableHTTPMcpServer = object { server_name, server_url, auth_header, 3 more }

Create a new Streamable HTTP MCP server

server_name: string

The name of the server

server_url: string

The URL of the server

auth_header: optional string

The name of the authentication header (e.g., 'Authorization')

auth_token: optional string

The authentication token or API key value

custom_headers: optional map[string]

Custom HTTP headers to include with requests

type: optional "sse" or "stdio" or "streamable_http"

Accepts one of the following:

"sse"

"stdio"

"streamable_http"

ReturnsExpand Collapse

StdioMcpServer = object { args, command, server_name, 3 more }

A Stdio MCP server

args: array of string

The arguments to pass to the command

command: string

The command to run (MCP 'local' client will run this command)

server_name: string

The name of the server

id: optional string

The human-friendly ID of the Mcp_server

env: optional map[string]

Environment variables to set

type: optional "sse" or "stdio" or "streamable_http"

Accepts one of the following:

"sse"

"stdio"

"streamable_http"

SseMcpServer = object { server_name, server_url, id, 4 more }

An SSE MCP server

server_name: string

The name of the server

server_url: string

The URL of the server

id: optional string

The human-friendly ID of the Mcp_server

auth_header: optional string

The name of the authentication header (e.g., 'Authorization')

auth_token: optional string

The authentication token or API key value

custom_headers: optional map[string]

Custom HTTP headers to include with requests

type: optional "sse" or "stdio" or "streamable_http"

Accepts one of the following:

"sse"

"stdio"

"streamable_http"

StreamableHTTPMcpServer = object { server_name, server_url, id, 4 more }

A Streamable HTTP MCP server

server_name: string

The name of the server

server_url: string

The URL of the server

id: optional string

The human-friendly ID of the Mcp_server

auth_header: optional string

The name of the authentication header (e.g., 'Authorization')

auth_token: optional string

The authentication token or API key value

custom_headers: optional map[string]

Custom HTTP headers to include with requests

type: optional "sse" or "stdio" or "streamable_http"

Accepts one of the following:

"sse"

"stdio"

"streamable_http"

Create Mcp Server

curl https://api.letta.com/v1/mcp-servers/ \
    -H 'Content-Type: application/json' \
    -H "Authorization: Bearer $LETTA_API_KEY" \
    -d '{
          "args": [
            "string"
          ],
          "command": "command",
          "server_name": "server_name"
        }'

{
  "args": [
    "string"
  ],
  "command": "command",
  "server_name": "server_name",
  "id": "mcp_server-123e4567-e89b-12d3-a456-426614174000",
  "env": {
    "foo": "string"
  },
  "type": "sse"
}

Returns Examples

{
  "args": [
    "string"
  ],
  "command": "command",
  "server_name": "server_name",
  "id": "mcp_server-123e4567-e89b-12d3-a456-426614174000",
  "env": {
    "foo": "string"
  },
  "type": "sse"
}