MCP Servers

Operations for discovering MCP servers within a registry on a portal.

List MCP Server Versions

Returns a list of all MCP server versions within the specified registry.

get
/api/v3/mcp-registries/{mcpRegistryIdentifier}/server-versions

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[before]string

Request the next page of data, starting with the item before this parameter.

Example:ewogICJpZCI6ICJoZWxsbyB3b3JsZCIKfQ

page[after]string

Request the next page of data, starting with the item after this parameter.

Example:ewogICJpZCI6ICJoZWxsbyB3b3JsZCIKfQ

filterobject

Filter parameters for MCP registry server version list endpoint

Show Child Parameters

Path Parameters

mcpRegistryIdentifierstringrequired

MCP registry name or UUID

Example:my-mcp-registry

Response

application/json

A list of MCP server versions

MCPServerVersionList

dataarray[object]required

Schema for a static representation of an MCP server version. Used in various contexts related to discovery, installation, and configuration.

Show Child Parameters
metaobjectrequired

Pagination metadata.

Show Child Parameters
application/json

Get MCP Server Version

Returns detailed information about a specific MCP server version within the specified MCP registry, by ID.

get
/api/v3/mcp-registries/{mcpRegistryIdentifier}/server-versions/{mcpServerVersionId}

Path Parameters

mcpRegistryIdentifierstringrequired

MCP registry name or UUID

Example:my-mcp-registry

mcpServerVersionIdstring(uuid)required

MCP server version ID.

Example:dd4acc7f-2f59-4200-bbb2-ee321132824b

Response

application/json

Detailed MCP server version information

MCPServerVersion

Schema for a static representation of an MCP server version. Used in various contexts related to discovery, installation, and configuration.

idstring(uuid)required

Unique identifier for this server version.

Example:dd4acc7f-2f59-4200-bbb2-ee321132824b

namestringrequired

Server name in reverse-DNS format. Must contain exactly one forward slash separating namespace from server name.

Match pattern:^[a-zA-Z0-9.-]+/[a-zA-Z0-9._-]+$

>= 3 characters<= 200 characters

Example:io.github.user/weather

descriptionstringrequired

Clear human-readable explanation of server functionality.

>= 1 characters<= 100 characters

Example:MCP server providing weather data and forecasts via OpenWeatherMap API

titlestring | null

Optional human-readable display name for the MCP server.

>= 1 characters<= 100 characters

Example:Weather API

repositoryobjectrequired

Repository metadata for the MCP server source code. Enables users and security experts to inspect the code, improving transparency.

Show Child Parameters
versionstringrequired

Version string for this server. SHOULD follow semantic versioning.

<= 255 characters

Example:1.0.2

latestbooleanrequired

Whether this server version is the latest available for its name within the registry.

website_urlstring | null(uri)required

Optional URL to the server’s homepage, documentation, or project website.

Example:https://modelcontextprotocol.io/examples

iconsarray | null[object]required

An optionally-sized icon that can be displayed in a user interface.

Show Child Parameters
packagesarray | null[object]required
Show Child Parameters
remotesAny Of
array | nullrequired
MCPStreamableHttpTransportobject

Transport protocol configuration for remote context

Example:{"type":"streamable-http","url":"https://api.example.com/mcp"}

Show Child Parameters
created_atstring(date-time)required

Creation timestamp

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

updated_atstring(date-time)required

Update timestamp

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

application/json

List MCP Server Versions By Server

Returns all available versions for a specific MCP server name within the specified registry, ordered by publication date (newest first).

get
/api/v3/mcp-registries/{mcpRegistryIdentifier}/servers/{mcpServerName}/versions

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[before]string

Request the next page of data, starting with the item before this parameter.

Example:ewogICJpZCI6ICJoZWxsbyB3b3JsZCIKfQ

page[after]string

Request the next page of data, starting with the item after this parameter.

Example:ewogICJpZCI6ICJoZWxsbyB3b3JsZCIKfQ

Path Parameters

mcpRegistryIdentifierstringrequired

MCP registry name or UUID

Example:my-mcp-registry

mcpServerNamestringrequired

URL-encoded MCP server name (e.g., “com.example%2Fmy-mcp-server”)

Example:com.example%2Fmy-mcp-server

Response

application/json

A list of MCP server versions for a given server name.

MCPServerVersionList

dataarray[object]required

Schema for a static representation of an MCP server version. Used in various contexts related to discovery, installation, and configuration.

Show Child Parameters
metaobjectrequired

Pagination metadata.

Show Child Parameters
application/json

Get MCP Server Version By Server

Returns detailed information about a specific version of an MCP server within the specified MCP registry, by server name and server version (or ID).

get
/api/v3/mcp-registries/{mcpRegistryIdentifier}/servers/{mcpServerName}/versions/{mcpServerVersionOrId}

Path Parameters

mcpRegistryIdentifierstringrequired

MCP registry name or UUID

Example:my-mcp-registry

mcpServerNamestringrequired

URL-encoded MCP server name (e.g., “com.example%2Fmy-mcp-server”)

Example:com.example%2Fmy-mcp-server

mcpServerVersionOrIdstringrequired

MCP server version ID or version.

Example:1.0.0

Response

application/json

Detailed MCP server version information

MCPServerVersion

Schema for a static representation of an MCP server version. Used in various contexts related to discovery, installation, and configuration.

idstring(uuid)required

Unique identifier for this server version.

Example:dd4acc7f-2f59-4200-bbb2-ee321132824b

namestringrequired

Server name in reverse-DNS format. Must contain exactly one forward slash separating namespace from server name.

Match pattern:^[a-zA-Z0-9.-]+/[a-zA-Z0-9._-]+$

>= 3 characters<= 200 characters

Example:io.github.user/weather

descriptionstringrequired

Clear human-readable explanation of server functionality.

>= 1 characters<= 100 characters

Example:MCP server providing weather data and forecasts via OpenWeatherMap API

titlestring | null

Optional human-readable display name for the MCP server.

>= 1 characters<= 100 characters

Example:Weather API

repositoryobjectrequired

Repository metadata for the MCP server source code. Enables users and security experts to inspect the code, improving transparency.

Show Child Parameters
versionstringrequired

Version string for this server. SHOULD follow semantic versioning.

<= 255 characters

Example:1.0.2

latestbooleanrequired

Whether this server version is the latest available for its name within the registry.

website_urlstring | null(uri)required

Optional URL to the server’s homepage, documentation, or project website.

Example:https://modelcontextprotocol.io/examples

iconsarray | null[object]required

An optionally-sized icon that can be displayed in a user interface.

Show Child Parameters
packagesarray | null[object]required
Show Child Parameters
remotesAny Of
array | nullrequired
MCPStreamableHttpTransportobject

Transport protocol configuration for remote context

Example:{"type":"streamable-http","url":"https://api.example.com/mcp"}

Show Child Parameters
created_atstring(date-time)required

Creation timestamp

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

updated_atstring(date-time)required

Update timestamp

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

application/json