LocalTransport

Transport protocol configuration for local/package context

Any Of
typestringrequired

Transport type

Allowed values:stdio

Example:stdio

Example

RemoteTransport

Transport protocol configuration for remote context - extends StreamableHttpTransport or SseTransport with variables

Any Of
variablesobject

Configuration variables that can be referenced in URL template {curly_braces}. The key is the variable name, and the value defines the variable properties.

typestringrequired

Transport type

Allowed values:streamable-http

Example:streamable-http

urlstringrequired

URL template for the streamable-http transport. Variables in {curly_braces} are resolved based on context: In Package context, they reference argument valueHints, argument names, or environment variable names from the parent Package. In Remote context, they reference variables from the transport’s ‘variables’ object. After variable substitution, this should produce a valid URI.

Match pattern:^https?://[^\s]+$

Example:https://api.example.com/mcp

headersarray[object]

HTTP headers to include

Show Child Parameters
Example

Icon

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. Consumers SHOULD take steps to ensure URLs serving icons are from the same domain as the server or a trusted domain. Consumers SHOULD take appropriate precautions when consuming SVGs as they can contain executable JavaScript.

<= 255 characters

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

mimeTypestring

Optional MIME type override if the source MIME type is missing or generic. Must be one of: image/png, image/jpeg, image/jpg, image/svg+xml, image/webp.

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

Example:image/png

sizesarray[string]

Optional array of strings that specify sizes at which the icon can be used. Each string should be in WxH format (e.g., ‘48x48’, ‘96x96’) or ‘any’ for scalable formats like SVG. If not provided, the client should assume that the icon can be used at any size.

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

Example:48x48, 96x96

themestring

Optional specifier for the theme this icon is designed for. ‘light’ indicates the icon is designed to be used with a light background, and ‘dark’ indicates the icon is designed to be used with a dark background. If not provided, the client should assume the icon can be used with any theme.

Allowed values:lightdark

Example

ServerDetail

object

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
Example

ServerResponse

object

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
Example