Get Mcp Card
Return one MCP card, including the inputs the user must fill.
Headers
Caller's user ID. Temporary header-based identity; will be replaced by JWT auth.
Response
Successful Response
A single MCP listing on a hub.
A card is a template, not a connectable client:
:attr:config_template carries ${...} placeholders whose values
the user supplies at install time, described by
:attr:inputs_schema.
Two identifiers, deliberately separate:
- :attr:
idaddresses the card on its hub and is what :attr:refembeds. It may be any opaque string. - :attr:
nameis the default name of the installed client, which must match[a-zA-Z0-9_-]+because it composes the model-facing tool namemcp__{name}__{tool}. Cards are not rejected for a bad name — the install call is, so browsing a registry with odd slugs still works.
The id of the hub this card came from.
The default name of the installed MCP client.
The STDIO MCP server configuration.
- StdioMCPConfig
- HttpMCPConfig
The identifier addressing this card on its hub. Defaults to name for registries that expose no separate id.
The user-facing name, falling back to name.
The user-facing description of the MCP.
The tags categorizing this card.
The card version reported by the hub.
The last-updated timestamp (Unix epoch seconds).
Who published the MCP, when the hub says.
An image representing the MCP. None when the hub offers none — the UI is expected to fall back rather than show a broken image.
The MCP's page on the hub's website, for a 'view on the hub' link. None when the hub has no web presence.
The server's long-form documentation, shown in the detail view where a skill shows its SKILL.md. None when the hub publishes none.
How many times this MCP has been installed. None when the hub does not count installs, which is not the same as zero — render it only when set.
How many times this MCP has been downloaded. None when the hub does not count downloads.
Whether the installed client requires explicit connect() and close(). Forwarded to MCPClient.is_stateful.
How the user authenticates: none for public servers, inputs for the inputs_schema form. Reserved as a discriminator so an oauth flow can be added later without breaking the API.
none, inputs A JSON Schema (type: object) describing the values the user must supply. Secret fields carry the standard writeOnly: true and format: password keywords so the frontend renders them masked.