Skip to content

POST /v1/mcp-servers - Create a new MCP server

POST
/v1/mcp-servers

Request to create a new MCP server

object
api_key

API key for authentication (optional).

string | null
description

A human-readable description of what the MCP server provides.

string | null
Example
Atlassian MCP Server for Jira and Confluence
headers

Additional HTTP headers for authentication.

object | null
name
required

The name of the MCP server. Must be unique.

string
Example
atlassian-mcp-server
transport_type

Transport type. Currently only “http” is supported.

string
Allowed values: http
url
required

The URL of the MCP server endpoint.

string
Example
https://mcp.atlassian.com/v1/mcp

MCP server created successfully

MCP Server configuration. Represents a remote MCP server that can provide tools and resources.

object
api_key_set
required

Whether an API key has been configured.

boolean
created_at
required

Timestamp when the MCP server was created.

string format: date-time
description

Human-readable description of the MCP server.

string | null
Example
Atlassian MCP Server for Jira and Confluence
headers

Additional HTTP headers for authentication. Keys are header names, values are header values.

object
key
additional properties
string
id
required

Unique identifier for the MCP server.

string
Example
mcp_01933b5a00007000800000000000001
name
required

Display name of the MCP server.

string
Example
atlassian-mcp-server
status
required

Current lifecycle status of the MCP server.

string
Allowed values: active disabled
transport_type
required

Transport type (currently only HTTP supported).

string
Allowed values: http
updated_at
required

Timestamp when the MCP server was last updated.

string format: date-time
url
required

URL of the MCP server endpoint.

string
Example
https://mcp.atlassian.com/v1/mcp

Invalid input or duplicate name

Standard error response for API endpoints.

object
error
required

Error message describing what went wrong.

string

Internal server error

Standard error response for API endpoints.

object
error
required

Error message describing what went wrong.

string