McpRegistryPublicationList
objectShow Child Parameters
returns the pagination information
Show Child Parameters
Repository
objectRepository metadata for the MCP server source code. Enables users and security experts to inspect the code, improving transparency.
Repository URL for browsing source code. Should support both web browsing and git clone operations.
Example:https://github.com/modelcontextprotocol/servers
Repository hosting service identifier. Used by registries to determine validation and API access methods.
Example:github
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
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
ServerList
objectAPI response format with separated server data and registry metadata
Show Child Parameters
Show Child Parameters
Package
objectRegistry type indicating how to download packages (e.g., ‘npm’, ‘pypi’, ‘oci’, ‘nuget’, ‘mcpb’)
Example:npm
Base URL of the package registry
Example:https://registry.npmjs.org
Package identifier - either a package name (for registries) or URL (for direct downloads)
Example:@modelcontextprotocol/server-brave-search
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
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
A hint to help clients determine the appropriate runtime for the package. This field should be provided when runtimeArguments are present.
Example:npx
Any OfTransport protocol configuration for the package
Show Child Parameters
Any OfWarning: 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.
Any OfA positional input is a value inserted verbatim into the command line.
Show Child Parameters
Any OfWarning: 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.
Any OfA positional input is a value inserted verbatim into the command line.
Show Child Parameters
A mapping of environment variables to be set when running the package.
Show Child Parameters
Input
objectA description of the input, which clients can use to provide context to the user.
Default:false
Specifies the input format. Supported values include filepath, which should be interpreted as a file on the user’s filesystem.
When the input is converted to a string, booleans should be represented by the strings “true” and “false”, and numbers should be represented as decimal values.
Allowed values:stringnumberbooleanfilepath
Default:string
The value for the input. If this is not set, the user may be prompted to provide a value. If a value is set, it should not be configurable by end users.
Identifiers wrapped in {curly_braces} will be replaced with the corresponding properties from the input variables map. If an identifier in braces is not found in variables, or if variables is not provided, the {curly_braces} substring should remain unchanged.
Indicates whether the input is a secret value (e.g., password, token). If true, clients should handle the value securely.
Default:false
The default value for the input. This should be a valid value for the input. If you want to provide input examples or guidance, use the placeholder field instead.
A placeholder for the input to be displaying during configuration. This is used to provide examples or guidance about the expected form or content of the input.
A list of possible values for the input. If provided, the user must select one of these values.
Example:[]