---
title: "The catalog snapshot the CLI bundles: every command with toolset, tier, aliases, keywords, scopes, schemas and availability, the MCP view URLs and the client view table"
method: GET
path: "/v1/catalog.json"
---

# The catalog snapshot the CLI bundles: every command with toolset, tier, aliases, keywords, scopes, schemas and availability, the MCP view URLs and the client view table

`GET /v1/catalog.json`

## Request

- Base URL: `https://app.agentlinkops.com`
- URL: `https://app.agentlinkops.com/v1/catalog.json`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

The catalog snapshot the CLI bundles: every command with toolset, tier, aliases, keywords, scopes, schemas and availability, the MCP view URLs and the client view table. Carries an ETag and a private one-hour cache; If-None-Match answers 304. ?format=anthropic-tools returns the same commands as an Anthropic Messages API tool array for programmatic tool calling: every tool deferred (defer_loading), callable from the code execution tool and directly (allowed_callers), never strict; execute them against POST /v1/commands/{name}. This is a static source snapshot, including operator-only definitions; it does not grant access or prove that every definition is available to this credential.

## Query parameters

- `format` 'anthropic-tools'

## Headers

- `If-None-Match` string
- `X-Workspace-ID` string

## Response `200`

The catalog snapshot the CLI bundles: every command with toolset, tier, aliases, keywords, scopes, schemas and availability, the MCP view URLs and the client view table. Carries an ETag and a private one-hour cache; If-None-Match answers 304. ?format=anthropic-tools returns the same commands as an Anthropic Messages API tool array for programmatic tool calling: every tool deferred (defer_loading), callable from the code execution tool and directly (allowed_callers), never strict; execute them against POST /v1/commands/{name}. This is a static source snapshot, including operator-only definitions; it does not grant access or prove that every definition is available to this credential.

- union
  - object
    - `source` 'src/tool-registry.js', required
    - `origin` string, required
    - `views` object, required
    - `clients` object[], required
      - `id` string, required
      - `name` string, required
      - `view` string, required
      - `deferral` boolean, required
    - `toolsets` object, required
    - `commands` object[], required
      - `name` string, required
      - `toolset` string, required
      - `tier` 'core' | 'deferred', required
      - `scopes` string[], required
      - `aliases` string[], required
      - `confirm` string
      - `scopeAuthorized` boolean
      - `readOnly` boolean, required
      - `description` string, required
      - `keywords` string[], required
      - `admissionGated` boolean, required
      - `availability` 'unavailable'
      - `examples` unknown[]
        - unknown
      - `inputSchema` object, required: JSON Schema contract.
      - `outputSchema` object, required: JSON Schema contract.
  - object
    - `source` 'src/tool-registry.js', required
    - `origin` string, required
    - `execute` string, required
    - `note` string, required
    - `tools` object[], required
      - `name` string, required
      - `description` string, required
      - `input_schema` object, required: JSON Schema contract.
      - `defer_loading` true, required
      - `allowed_callers` string[], required

## Other responses

- `304`: Matching If-None-Match; no response body.
- `429`: Request-rate or usage refusal. Inspect error.code and recovery details before retrying.
- `default`: Error envelope. Non-configuration 5xx messages are masked and details omitted; allowlisted configuration errors retain static operator recovery.

---

[API](https://skmtc.dev/agentlinkops/apis/agentlinkops-http-api.md) · [All operations](https://skmtc.dev/agentlinkops/apis/agentlinkops-http-api/llms.txt) · [OpenAPI document](https://skmtc.dev/agentlinkops/apis/agentlinkops-http-api/revisions/2a712a1dcfa7?raw)