List all MCP servers

GET

/v1/mcp-servers

• Production API

Parameters

Query Parameters

search

string | null

Search by name or description (case-insensitive substring match).

include_archived

boolean | null

Include archived MCP servers. Deleted MCP servers never appear in lists.

Responses

200

List of MCP servers

Response wrapper for list endpoints. All list endpoints return responses wrapped in a data field.

object

data

required

Array of items returned by the list operation.

Array<object>

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

archived_at

Timestamp when the MCP server was archived.

string | null format: date-time

auth_mode

Authentication mode for this MCP server.

string

Allowed values: none api_key o_auth

created_at

required

Timestamp when the MCP server was created.

string format: date-time

deleted_at

Timestamp when the MCP server was deleted.

string | null 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

oauth_provider_id

Stable provider id used for user-scoped OAuth connections.

string | null

status

required

Current lifecycle status of the MCP server.

string

Allowed values: active disabled archived deleted

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

500

Internal server error