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

List registry publications

Returns a list of portal publications for a specific MCP registry

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 MCP registry publication 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

Path Parameters

registryIdentifierstringrequired

Registry name or UUID

Example:my-registry

Response

application/json

A paginated list of registry publications

McpRegistryPublicationList

dataarray[object]required
Show Child Parameters
metaobjectrequired

returns the pagination information

Show Child Parameters
get/mcp-registries/{registryIdentifier}/publications
 
application/json