Get specific MCP server version (v0.1)

Returns detailed information about a specific version of an MCP server within the selected registry. Use the special version latest to get the latest version.

get

Path Parameters

serverNamestringrequired

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

Example:com.example%2Fmy-server

versionstringrequired

URL-encoded version to retrieve (e.g., “1.0.0” or “1.0.0%2B20130313144700” for versions with build metadata)

Example:1.0.0

registryIdentifierstringrequired

Registry name or UUID

Example:my-registry

Response

application/json

Detailed server information

ServerResponse

API response format with separated server data and registry metadata

serverobjectrequired

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

Show Child Parameters
_metaobject

Registry-managed metadata

* Additional properties are allowed.
Show Child Parameters
get/mcp-registries/{registryIdentifier}/v0.1/servers/{serverName}/versions/{version}
 
application/json

Update specific MCP server version

Update a specific version of an MCP server in the registry within the selected registry.

Note: This endpoint is optional for registry implementations and is not implemented by the official MCP registry. It is included in the specification to standardize the update mechanism for registry implementations that choose to support it.

Authentication mechanism is registry-specific and may vary between implementations.

put

Path Parameters

serverNamestringrequired

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

Example:com.example%2Fmy-server

versionstringrequired

URL-encoded version to update (e.g., “1.0.0” or “1.0.0%2B20130313144700” for versions with build metadata)

Example:1.0.0

registryIdentifierstringrequired

Registry name or UUID

Example:my-registry

Body

application/json

ServerDetail

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

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. Should focus on capabilities, not implementation details.

>= 1 characters<= 100 characters

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

titlestring

Optional human-readable title or display name for the MCP server. MCP subregistries or clients MAY choose to use this for display purposes.

>= 1 characters<= 100 characters

Example:Weather API

repositoryobject

Optional repository metadata for the MCP server source code. Recommended for transparency and security inspection.

Show Child Parameters
versionstringrequired

Version string for this server. SHOULD follow semantic versioning (e.g., ‘1.0.2’, ‘2.1.0-alpha’). Equivalent of Implementation.version in MCP specification. Non-semantic versions are allowed but may not sort predictably. Version ranges are rejected (e.g., ‘^1.2.3’, ‘~1.2.3’, ‘>=1.2.3’, ‘1.x’, ‘1.*’).

<= 255 characters

Example:1.0.2

websiteUrlstring(uri)

Optional URL to the server’s homepage, documentation, or project website. This provides a central link for users to learn more about the server. Particularly useful when the server has custom installation instructions or setup requirements.

Example:https://modelcontextprotocol.io/examples

iconsarray[object]

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

Show Child Parameters
$schemastring(uri)

JSON Schema URI for this server.json format

Example:https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json

packagesarray[object]
Show Child Parameters
remotesAny Of
array
StreamableHttpTransportobject

Transport protocol configuration for remote context - extends StreamableHttpTransport or SseTransport with variables

Show Child Parameters
_metaobject

Extension metadata using reverse DNS namespacing for vendor-specific data

Show Child Parameters

Response

application/json

Successfully updated server version

ServerResponse

API response format with separated server data and registry metadata

serverobjectrequired

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

Show Child Parameters
_metaobject

Registry-managed metadata

* Additional properties are allowed.
Show Child Parameters
put/mcp-registries/{registryIdentifier}/v0.1/servers/{serverName}/versions/{version}

Body

{ "name": "io.github.user/weather", "description": "MCP server providing weather data and forecasts via OpenWeatherMap API", "version": "1.0.2" }
 
application/json

Delete specific MCP server version (Optional)

Delete a specific version of an MCP server from the registry within the selected registry.

Note: This endpoint is optional for registry implementations and is not implemented by the official MCP registry. It is included in the specification to standardize the deletion mechanism for registry implementations that choose to support it.

Authentication mechanism is registry-specific and may vary between implementations.

delete

Path Parameters

serverNamestringrequired

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

Example:com.example%2Fmy-server

versionstringrequired

URL-encoded version to delete (e.g., “1.0.0” or “1.0.0%2B20130313144700” for versions with build metadata)

Example:1.0.0

registryIdentifierstringrequired

Registry name or UUID

Example:my-registry

Response

application/json

Successfully deleted server version

ServerResponse

API response format with separated server data and registry metadata

serverobjectrequired

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

Show Child Parameters
_metaobject

Registry-managed metadata

* Additional properties are allowed.
Show Child Parameters
delete/mcp-registries/{registryIdentifier}/v0.1/servers/{serverName}/versions/{version}
 
application/json

Publish MCP server (Optional) (v0.1)

Publish a new MCP server to the registry or update an existing one within the selected registry.

Note: This endpoint is optional for registry implementations. Read-only registries may not provide this functionality.

Authentication mechanism is registry-specific and may vary between implementations.

post

Path Parameters

registryIdentifierstringrequired

Registry name or UUID

Example:my-registry

Body

application/json

ServerDetail

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

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. Should focus on capabilities, not implementation details.

>= 1 characters<= 100 characters

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

titlestring

Optional human-readable title or display name for the MCP server. MCP subregistries or clients MAY choose to use this for display purposes.

>= 1 characters<= 100 characters

Example:Weather API

repositoryobject

Optional repository metadata for the MCP server source code. Recommended for transparency and security inspection.

Show Child Parameters
versionstringrequired

Version string for this server. SHOULD follow semantic versioning (e.g., ‘1.0.2’, ‘2.1.0-alpha’). Equivalent of Implementation.version in MCP specification. Non-semantic versions are allowed but may not sort predictably. Version ranges are rejected (e.g., ‘^1.2.3’, ‘~1.2.3’, ‘>=1.2.3’, ‘1.x’, ‘1.*’).

<= 255 characters

Example:1.0.2

websiteUrlstring(uri)

Optional URL to the server’s homepage, documentation, or project website. This provides a central link for users to learn more about the server. Particularly useful when the server has custom installation instructions or setup requirements.

Example:https://modelcontextprotocol.io/examples

iconsarray[object]

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

Show Child Parameters
$schemastring(uri)

JSON Schema URI for this server.json format

Example:https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json

packagesarray[object]
Show Child Parameters
remotesAny Of
array
StreamableHttpTransportobject

Transport protocol configuration for remote context - extends StreamableHttpTransport or SseTransport with variables

Show Child Parameters
_metaobject

Extension metadata using reverse DNS namespacing for vendor-specific data

Show Child Parameters

Response

application/json

Successfully published server

ServerResponse

API response format with separated server data and registry metadata

serverobjectrequired

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

Show Child Parameters
_metaobject

Registry-managed metadata

* Additional properties are allowed.
Show Child Parameters
post/mcp-registries/{registryIdentifier}/v0.1/publish

Body

{ "name": "io.modelcontextprotocol/filesystem", "description": "Node.js server implementing Model Context Protocol (MCP) for filesystem operations.", "title": "Filesystem", "repository": { "url": "https://github.com/modelcontextprotocol/servers", "source": "github" }, "version": "1.0.2", "packages": [ { "registryType": "npm", "registryBaseUrl": "https://registry.npmjs.org", "identifier": "@modelcontextprotocol/server-filesystem", "version": "1.0.2", "transport": { "type": "stdio" } } ], "_meta": { "io.modelcontextprotocol.registry/publisher-provided": { "tool": "publisher-cli", "version": "1.2.3", "buildInfo": { "commit": "abc123def456", "timestamp": "2023-12-01T10:30:00Z" } } } }
 
application/json

mcp_registry_publications

Operations for managing MCP registry publications to portals