McpRegistryPublicationResponse

object
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

Example

McpRegistryPublicationList

object
dataarray[object]required
Show Child Parameters
metaobjectrequired

returns the pagination information

Show Child Parameters
Example

Repository

object

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

urlstring(uri)required

Repository URL for browsing source code. Should support both web browsing and git clone operations.

Example:https://github.com/modelcontextprotocol/servers

sourcestringrequired

Repository hosting service identifier. Used by registries to determine validation and API access methods.

Example:github

idstring

Repository identifier from the hosting service (e.g., GitHub repo ID). Owned and determined by the source forge. Should remain stable across repository renames and may be used to detect repository resurrection attacks - if a repository is deleted and recreated, the ID should change. For GitHub, use: gh api repos// --jq ‘.id’

Example:b94b5f7e-c7c6-d760-2c78-a5e9b8a5b8c9

subfolderstring

Optional relative path from repository root to the server location within a monorepo or nested package structure. Must be a clean relative path.

Example:src/everything

Example

ServerList

object
serversarray[object]required

API response format with separated server data and registry metadata

Show Child Parameters
metadataobject
Show Child Parameters
Example

Package

object
registryTypestringrequired

Registry type indicating how to download packages (e.g., ‘npm’, ‘pypi’, ‘oci’, ‘nuget’, ‘mcpb’)

Example:npm

registryBaseUrlstring(uri)

Base URL of the package registry

Example:https://registry.npmjs.org

identifierstringrequired

Package identifier - either a package name (for registries) or URL (for direct downloads)

Example:@modelcontextprotocol/server-brave-search

versionstring

Package version. Must be a specific version. Version ranges are rejected (e.g., ‘^1.2.3’, ‘~1.2.3’, ‘>=1.2.3’, ‘1.x’, ‘1.*’).

>= 1 characters

Example:1.0.2

fileSha256string

SHA-256 hash of the package file for integrity verification. Required for MCPB packages and optional for other package types. Authors are responsible for generating correct SHA-256 hashes when creating server.json. If present, MCP clients must validate the downloaded file matches the hash before running packages to ensure file integrity.

Match pattern:^[a-f0-9]{64}$

Example:fe333e598595000ae021bd27117db32ec69af6987f507ba7a63c90638ff633ce

runtimeHintstring

A hint to help clients determine the appropriate runtime for the package. This field should be provided when runtimeArguments are present.

Example:npx

transportAny Of
required
StdioTransportobject

Transport protocol configuration for the package

Show Child Parameters
runtimeArgumentsAny Of
array

Warning: Arguments construct command-line parameters that may contain user-provided input. This creates potential command injection risks if clients execute commands in a shell environment. For example, a malicious argument value like ‘;rm -rf ~/Development’ could execute dangerous commands. Clients should prefer non-shell execution methods (e.g., posix_spawn) when possible to eliminate injection risks entirely. Where not possible, clients should obtain consent from users or agents to run the resolved command before execution.

PositionalArgumentAny Of
PositionalArgumentobject

A positional input is a value inserted verbatim into the command line.

Show Child Parameters
packageArgumentsAny Of
array

Warning: Arguments construct command-line parameters that may contain user-provided input. This creates potential command injection risks if clients execute commands in a shell environment. For example, a malicious argument value like ‘;rm -rf ~/Development’ could execute dangerous commands. Clients should prefer non-shell execution methods (e.g., posix_spawn) when possible to eliminate injection risks entirely. Where not possible, clients should obtain consent from users or agents to run the resolved command before execution.

PositionalArgumentAny Of
PositionalArgumentobject

A positional input is a value inserted verbatim into the command line.

Show Child Parameters
environmentVariablesarray

A mapping of environment variables to be set when running the package.

Show Child Parameters
Example