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

Create registry publication

Publishes an MCP registry to a portal

post

Path Parameters

registryIdentifierstringrequired

Registry name or UUID

Example:my-registry

Body

application/json

CreateMcpRegistryPublicationRequest

portal_idstring(uuid)required

Unique identifier of the portal to publish the MCP registry to

Example:456e7890-e89b-12d3-a456-426614174001

visibilitystringrequired

Visibility of the MCP registry publication on the portal

Allowed values:publicprivate

Example:public

Response

application/json

Successfully created registry publication

McpRegistryPublicationResponse

registry_idstring(uuid)required

Unique identifier of the MCP registry

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

portal_idstring(uuid)required

Unique identifier of the portal the MCP registry is published to

Example:456e7890-e89b-12d3-a456-426614174001

visibilitystringrequired

Visibility of the MCP registry publication on the portal

Allowed values:publicprivate

Example:public

created_atstring(date-time)required

Timestamp when the publication was created

Example:2024-01-15T10:30:00Z

updated_atstring(date-time)required

Timestamp when the publication was last updated

Example:2024-01-15T11:00:00Z

post/mcp-registries/{registryIdentifier}/publications

Body

{ "portal_id": "456e7890-e89b-12d3-a456-426614174001", "visibility": "public" }
 
application/json

Get MCP registry publication

Returns a specific portal publication for an MCP registry

get

Path Parameters

mcpRegistryIdentifierstringrequired

MCP registry name or UUID

Example:my-mcp-registry

portalIdstring(uuid)required

Portal UUID

Example:456e7890-e89b-12d3-a456-426614174001

Response

application/json

MCP registry publication details

McpRegistryPublicationResponse

registry_idstring(uuid)required

Unique identifier of the MCP registry

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

portal_idstring(uuid)required

Unique identifier of the portal the MCP registry is published to

Example:456e7890-e89b-12d3-a456-426614174001

visibilitystringrequired

Visibility of the MCP registry publication on the portal

Allowed values:publicprivate

Example:public

created_atstring(date-time)required

Timestamp when the publication was created

Example:2024-01-15T10:30:00Z

updated_atstring(date-time)required

Timestamp when the publication was last updated

Example:2024-01-15T11:00:00Z

get/mcp-registries/{mcpRegistryIdentifier}/publications/{portalId}
 
application/json