MCPServerVersion

object

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

idstring(uuid)required

Unique identifier for this server version.

Example:dd4acc7f-2f59-4200-bbb2-ee321132824b

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.

>= 1 characters<= 100 characters

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

titlestring

Optional human-readable display name for the MCP server.

>= 1 characters<= 100 characters

Example:Weather API

repositoryobjectrequired

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

Show Child Parameters
versionstringrequired

Version string for this server. SHOULD follow semantic versioning.

<= 255 characters

Example:1.0.2

latestbooleanrequired

Whether this server version is the latest available for its name within the registry.

website_urlstring(uri)required

Optional URL to the server’s homepage, documentation, or project website.

Example:https://modelcontextprotocol.io/examples

iconsarray[object]required

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

Show Child Parameters
packagesarray[object]required
Show Child Parameters
remotesAny Of
arrayrequired
MCPStreamableHttpTransportobject

Transport protocol configuration for remote context

Example:{"type":"streamable-http","url":"https://api.example.com/mcp"}

Show Child Parameters
created_atstring(date-time)required

Creation timestamp

Example:2023-12-01T10:30:00Z

updated_atstring(date-time)required

Update timestamp

Example:2023-12-01T10:30:00Z

Example

MCPRepository

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.

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

sourcestringrequired

Repository hosting service identifier.

Example:github

idstring

Repository identifier from the hosting service.

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

subfolderstring

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

Example:src/everything

Example

MCPIcon

object

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

srcstring(uri)required

A standard URI pointing to an icon resource. Must be an HTTPS URL.

<= 255 characters

Example:https://example.com/icon.png

mime_typestring

Optional MIME type override.

Allowed values:image/pngimage/jpegimage/jpgimage/svg+xmlimage/webp

Example:image/png

sizesarray[string]

Optional array of strings specifying sizes at which the icon can be used.

Match pattern:^(\d+x\d+|any)$

Example:48x48, 96x96

themestring

Optional specifier for the theme this icon is designed for.

Allowed values:lightdark

Example

MCPPackage

object
registryobjectrequired

Package registry details

Show Child Parameters
identifierstringrequired

Package identifier — either a package name or URL

Example:@modelcontextprotocol/server-brave-search

versionstring

Package version. Must be a specific version.

>= 1 characters

Example:1.0.2

file_sha256string

SHA-256 hash of the package file for integrity verification.

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

Example:fe333e598595000ae021bd27117db32ec69af6987f507ba7a63c90638ff633ce

transportAny Of
required
MCPStdioTransportobject

Transport protocol configuration for the package

Example:{"type":"stdio"}

Show Child Parameters
runtimeobject

Runtime configuration for executing the package

Show Child Parameters
package_argumentsAny Of
array

A list of arguments to be passed to the package’s binary.

MCPPositionalArgumentAny Of
MCPPositionalArgumentobject

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

Example:{"type":"positional","value_hint":"file_path"}

Show Child Parameters
environment_variablesarray

Environment variables to be set when running the package.

Show Child Parameters
Example

MCPInput

object
descriptionstring

A description of the input.

is_requiredboolean

Default:false

formatstring

Specifies the input format.

Allowed values:stringnumberbooleanfilepath

Default:string

valuestring

The value for the input.

is_secretboolean

Indicates whether the input is a secret value.

Default:false

defaultstring

The default value for the input.

placeholderstring

A placeholder for the input to be displayed during configuration.

choicesarray[string]

A list of possible values for the input.

Example:[]

Example