Skip to main content
GET
Get Mcp Card

Headers

x-user-id
string
required

Caller's user ID. Temporary header-based identity; will be replaced by JWT auth.

Path Parameters

hub_id
string
required
card_id
string
required

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:id addresses the card on its hub and is what :attr:ref embeds. It may be any opaque string.
  • :attr:name is the default name of the installed client, which must match [a-zA-Z0-9_-]+ because it composes the model-facing tool name mcp__{name}__{tool}. Cards are not rejected for a bad name — the install call is, so browsing a registry with odd slugs still works.
hub_id
string
required

The id of the hub this card came from.

name
string
required

The default name of the installed MCP client.

config_template
StdioMCPConfig · object
required

The STDIO MCP server configuration.

id
string
default:""

The identifier addressing this card on its hub. Defaults to name for registries that expose no separate id.

display_name
string | null

The user-facing name, falling back to name.

description
string
default:""

The user-facing description of the MCP.

tags
string[]

The tags categorizing this card.

version
string | null

The card version reported by the hub.

updated_at
number | null

The last-updated timestamp (Unix epoch seconds).

author
string | null

Who published the MCP, when the hub says.

icon_url
string | null

An image representing the MCP. None when the hub offers none — the UI is expected to fall back rather than show a broken image.

url
string | null

The MCP's page on the hub's website, for a 'view on the hub' link. None when the hub has no web presence.

readme
string | null

The server's long-form documentation, shown in the detail view where a skill shows its SKILL.md. None when the hub publishes none.

installs
integer | null

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.

downloads
integer | null

How many times this MCP has been downloaded. None when the hub does not count downloads.

is_stateful
boolean
default:true

Whether the installed client requires explicit connect() and close(). Forwarded to MCPClient.is_stateful.

auth
enum<string>
default:inputs

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.

Available options:
none,
inputs
inputs_schema
Inputs Schema · object

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.