mcp_registries

Operations for managing MCP registries

List MCP registries

Returns a list of all MCP registries for the current organization

get

Query Parameters

page[size]integer

The maximum number of items to include per page. The last page of a collection may include fewer items.

Example:10

page[number]integer

Determines which page of the entities to retrieve.

Example:1

filterobject

Filter parameters for registry list endpoint

Show Child Parameters
sortstring

The asc suffix is optional as the default sort order is ascending.
The desc suffix is used to specify a descending order.
Multiple sort attributes may be provided via a comma separated list.
JSONPath notation may be used to specify a sub-attribute (eg: ‘foo.bar desc’).

Example:created_at desc

Response

application/json

A list of MCP registries

RegistryList

dataarray[object]required
Show Child Parameters
metaobjectrequired

returns the pagination information

Show Child Parameters
get/mcp-registries
 
application/json

Create MCP registry

Create a new MCP registry for the current organization

post

Body

application/json
namestringrequired

Unique registry name

Match pattern:^[0-9a-z.-]+$

>= 1 characters<= 120 characters

Example:my-registry

display_namestringrequired

Human-readable registry name

>= 1 characters<= 120 characters

Example:My MCP Registry

descriptionstring

Optional registry description

<= 2048 characters

Example:Registry for internal MCP servers

Response

application/json

Successfully created registry

Registry

idstring(uuid)required

Unique registry identifier

Example:123e4567-e89b-12d3-a456-426614174000

namestringrequired

Unique registry name

Match pattern:^[0-9a-z.-]+$

>= 1 characters<= 120 characters

Example:my-registry

display_namestringrequired

Human-readable registry name

>= 1 characters<= 120 characters

Example:My MCP Registry

descriptionstring | nullrequired

Optional registry description

<= 2048 characters

Example:Registry for internal MCP servers

created_atstring(date-time)required

Registry creation timestamp

Example:2023-12-01T10:30:00Z

updated_atstring(date-time)required

Registry last update timestamp

Example:2023-12-01T11:00:00Z

post/mcp-registries

Body

{ "name": "my-registry", "display_name": "My MCP Registry" }
 
application/json

List computed registries

Returns computed metadata for all MCP registries in the current organization, including server counts

get

Query Parameters

page[size]integer

The maximum number of items to include per page. The last page of a collection may include fewer items.

Example:10

page[number]integer

Determines which page of the entities to retrieve.

Example:1

Response

application/json

A paginated list of computed registry metadata

ComputedMcpRegistryList

dataarray[object]required
Show Child Parameters
metaobjectrequired

returns the pagination information

Show Child Parameters
get/mcp-registries/_computed
 
application/json

Get MCP registry

Get a specific MCP registry by name or UUID

get

Path Parameters

registryIdentifierstringrequired

Registry name or UUID

Example:my-registry

Response

application/json

Registry information

Registry

idstring(uuid)required

Unique registry identifier

Example:123e4567-e89b-12d3-a456-426614174000

namestringrequired

Unique registry name

Match pattern:^[0-9a-z.-]+$

>= 1 characters<= 120 characters

Example:my-registry

display_namestringrequired

Human-readable registry name

>= 1 characters<= 120 characters

Example:My MCP Registry

descriptionstring | nullrequired

Optional registry description

<= 2048 characters

Example:Registry for internal MCP servers

created_atstring(date-time)required

Registry creation timestamp

Example:2023-12-01T10:30:00Z

updated_atstring(date-time)required

Registry last update timestamp

Example:2023-12-01T11:00:00Z

get/mcp-registries/{registryIdentifier}
 
application/json