> ## Documentation Index > Fetch the complete documentation index at: https://docs.agentscope.io/llms.txt > Use this file to discover all available pages before exploring further. # Get Mcp Card > Return one MCP card, including the inputs the user must fill. ## OpenAPI ````yaml /versions/2.0.6dev/en/deploy/openapi.json get /hub/mcp/{hub_id}/cards/{card_id} openapi: 3.1.0 info: title: AgentScope version: 2.0.5 servers: [] security: [] paths: /hub/mcp/{hub_id}/cards/{card_id}: get: tags: - hub summary: Get Mcp Card description: Return one MCP card, including the inputs the user must fill. operationId: get_mcp_card_hub_mcp__hub_id__cards__card_id__get parameters: - name: hub_id in: path required: true schema: type: string title: Hub Id - name: card_id in: path required: true schema: type: string title: Card Id - name: x-user-id in: header required: true schema: type: string description: >- Caller's user ID. Temporary header-based identity; will be replaced by JWT auth. title: X-User-Id description: >- Caller's user ID. Temporary header-based identity; will be replaced by JWT auth. responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/MCPCard' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' components: schemas: MCPCard: properties: hub_id: type: string title: Hub ID description: The id of the hub this card came from. id: type: string title: ID description: >- The identifier addressing this card on its hub. Defaults to ``name`` for registries that expose no separate id. default: '' name: type: string title: Name description: The default name of the installed MCP client. display_name: anyOf: - type: string - type: 'null' title: Display Name description: The user-facing name, falling back to ``name``. description: type: string title: Description description: The user-facing description of the MCP. default: '' tags: items: type: string type: array title: Tags description: The tags categorizing this card. version: anyOf: - type: string - type: 'null' title: Version description: The card version reported by the hub. updated_at: anyOf: - type: number - type: 'null' title: Updated At description: The last-updated timestamp (Unix epoch seconds). author: anyOf: - type: string - type: 'null' title: Author description: Who published the MCP, when the hub says. icon_url: anyOf: - type: string - type: 'null' title: Icon URL description: >- 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: anyOf: - type: string - type: 'null' title: URL description: >- 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: anyOf: - type: string - type: 'null' title: Readme description: >- 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: anyOf: - type: integer - type: 'null' title: Installs description: >- 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: anyOf: - type: integer - type: 'null' title: Downloads description: >- How many times this MCP has been downloaded. ``None`` when the hub does not count downloads. is_stateful: type: boolean title: Stateful description: >- Whether the installed client requires explicit connect() and close(). Forwarded to ``MCPClient.is_stateful``. default: true auth: type: string enum: - none - inputs title: Auth description: >- 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. default: inputs inputs_schema: additionalProperties: true type: object title: Inputs Schema description: >- 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. config_template: oneOf: - $ref: '#/components/schemas/StdioMCPConfig' - $ref: '#/components/schemas/HttpMCPConfig' title: Config Template description: >- The MCP config whose string leaves may hold ``${name}`` placeholders referring to ``inputs_schema`` properties. discriminator: propertyName: type mapping: http_mcp: $ref: '#/components/schemas/HttpMCPConfig' stdio_mcp: $ref: '#/components/schemas/StdioMCPConfig' type: object required: - hub_id - name - config_template title: MCPCard description: |- 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. HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError StdioMCPConfig: properties: type: type: string const: stdio_mcp title: Type default: stdio_mcp command: type: string title: Command description: The command to start the MCP server. args: anyOf: - items: type: string type: array - type: 'null' title: Args description: The command line arguments to pass to the MCP server. env: anyOf: - additionalProperties: type: string type: object - type: 'null' title: Environment Variables description: The environment variables to pass to the MCP server. cwd: anyOf: - type: string - type: string format: path - type: 'null' title: CWD description: The working directory to use when spawning the process. encoding_error_handler: type: string enum: - strict - ignore - replace title: Encoding Error Handler description: The text encoding error handler. default: strict type: object required: - command title: StdioMCPConfig description: The STDIO MCP server configuration. HttpMCPConfig: properties: type: type: string const: http_mcp title: Type default: http_mcp url: type: string title: URL description: The URL of the MCP server. headers: anyOf: - additionalProperties: type: string type: object - type: 'null' title: Headers description: The additional headers to include in the HTTP request. timeout: anyOf: - type: number - type: 'null' title: Timeout description: The HTTP request timeout in seconds. default: 30 type: object required: - url title: HttpMCPConfig description: The HTTP MCP server configuration. ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type input: title: Input ctx: type: object title: Context type: object required: - loc - msg - type title: ValidationError ````