> ## Documentation Index
> Fetch the complete documentation index at: https://mcpjam-mintlify-docs-update-pr-3305-1784516603326.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Get the host-compat catalog

> The versioned host-compatibility catalog backing `mcpjam compat` verdicts. Public and unauthenticated: static host facts and creation config with no project or user scope. Always returns a catalog — `source` is `live` when the backend publish was reachable and `bundled` when serving the SDK's built-in fallback.



## OpenAPI

````yaml /reference/openapi.json get /host-catalog
openapi: 3.1.0
info:
  title: MCPJam API
  version: 1.0.0-preview
  description: >-
    Programmatic access to MCP servers saved in your MCPJam projects — live
    diagnostics (validate, inspect, export) and operations: call tools, render
    prompts, run eval suites asynchronously and poll their results, and import
    OAuth tokens.


    **The API is in preview**: the surface may change while we finish the
    design. Error `code` values are stable; error `message` strings are not.
    Write clients that ignore unknown response fields.
  contact:
    name: MCPJam
    url: https://github.com/MCPJam/inspector/issues
servers:
  - url: https://app.mcpjam.com/api/v1
    description: Hosted MCPJam
security:
  - bearerAuth: []
tags:
  - name: Hosts
    description: >-
      Project hosts: named model + capability profiles you run chats and eval
      suites against.
  - name: Computer environments
    description: >-
      Custom Computer images: digest-pinned Dockerfile environments your
      project's computers boot from.
  - name: Server diagnostics
    description: Connect-level health checks against a saved MCP server.
  - name: Primitives
    description: 'The server''s MCP primitives: tools, prompts, and resources.'
  - name: Export
    description: Full-server snapshots for diffing and CI.
  - name: Execution
    description: 'Run the server''s primitives: call tools, render prompts.'
  - name: Eval runs
    description: >-
      Asynchronous eval suite runs: create with 202, poll status, iterations,
      and traces.
  - name: OAuth
    description: 'Bring-your-own OAuth: import externally obtained tokens for a server.'
  - name: Chatboxes
    description: >-
      Read-only access to the chatboxes published from a project: listing,
      settings, attached servers, and share links.
  - name: Catalog
    description: >-
      Discover the resources the other routes operate on: your account,
      projects, servers, eval suites, and chat sessions.
  - name: Tunnels
    description: >-
      Relay tunnels that expose local MCP servers through a public URL,
      registered as first-class project servers (the `mcpjam tunnel` CLI flow).
paths:
  /host-catalog:
    get:
      tags:
        - Catalog
      summary: Get the host-compat catalog
      description: >-
        The versioned host-compatibility catalog backing `mcpjam compat`
        verdicts. Public and unauthenticated: static host facts and creation
        config with no project or user scope. Always returns a catalog —
        `source` is `live` when the backend publish was reachable and `bundled`
        when serving the SDK's built-in fallback.
      operationId: getHostCompatCatalog
      responses:
        '200':
          description: The latest catalog envelope.
          content:
            application/json:
              schema:
                type: object
                required:
                  - schemaVersion
                  - version
                  - contentHash
                  - publishedAt
                  - catalog
                  - source
                properties:
                  schemaVersion:
                    type: integer
                    description: Catalog document schema version (currently 2).
                  version:
                    type: integer
                    description: >-
                      Monotonic backend publish version; 0 when `source` is
                      `bundled`.
                  contentHash:
                    type: string
                    description: >-
                      SHA-256 of the canonical catalog JSON; empty when `source`
                      is `bundled`.
                  publishedAt:
                    type: integer
                    description: Publish time (ms epoch); 0 when `source` is `bundled`.
                  source:
                    type: string
                    enum:
                      - live
                      - bundled
                    description: >-
                      Whether this envelope came from the backend publish or the
                      SDK's bundled fallback.
                  catalog:
                    type: object
                    required:
                      - hostsById
                    properties:
                      hostsById:
                        type: object
                        description: >-
                          Canonical host catalog keyed by host style. Each entry
                          is the full host object: compare/display facts plus
                          HostConfigInputV2 creation fields.
                        additionalProperties:
                          type: object
                          required:
                            - id
                            - label
                            - provenance
                            - rendersMcpApps
                            - hostStyle
                          properties:
                            id:
                              type: string
                            label:
                              type: string
                            provenance:
                              type: string
                              enum:
                                - observed
                                - probe
                                - vendor-doc
                                - assumed
                            rendersMcpApps:
                              type: boolean
                            supportedProtocolVersions:
                              type: array
                              items:
                                type: string
                            verifiedAt:
                              type: integer
                              description: >-
                                When this host's facts were last verified (ms
                                epoch).
                            imageSupport:
                              type: object
                              additionalProperties: true
                            hostStyle:
                              type: string
                            mcpProfile:
                              type: object
                              description: >-
                                Host MCP profile. MCP Apps capabilities and
                                OpenAI compat live here.
                              additionalProperties: true
                          additionalProperties: true
      security: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        MCPJam API key (`sk_…`). Create one at [Settings → API
        keys](https://app.mcpjam.com/settings/api-keys). Guest sessions cannot
        use the API, and API keys cannot manage other API keys.

````