> ## Documentation Index
> Fetch the complete documentation index at: https://mcpjam-mintlify-docs-update-pr-3829-1786337254828.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: Environments
    description: >-
      Project environments: named, live-editable execution bundles (one host, an
      optional standalone server group, optionally pinned skills and plugin
      versions) that eval suites and journeys run against. Distinct from Sandbox
      images, which are Computer base images. Reads require project membership;
      every write requires project admin.
  - name: Sandbox images
    description: >-
      Custom Computer images: a digest-pinned Dockerfile built into an immutable
      image 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).
  - name: Agent
    description: >-
      Headless agent turns over the public API: send a message history, the
      server runs one assistant turn with project-scoped workspace tools (eval
      reads + suite creation) on a pinned hosted model, and returns the reply
      plus created-resource references.
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.

````