CaliberAPI Pistol Optic Fit

Answer whether a specific red dot optic fits a specific pistol, from source-cited data. Returns fit "direct" (mounts on the slide cut, with the footprint), "adapter" (only through the adapter plate chain in via, with plate maker, model, mount and presented footprints, and plate sources), or "unknown" (no cited fit in the dataset, which is not evidence it does not fit). Returns "needs_clarification" with candidates when a name is ambiguous; call again with a candidate slug. Report the answer exactly as returned: never call an adapter fit a direct fit, and never turn "unknown" into "does not fit". Cite with the returned citation line and link html_url.

{
  "type": "object",
  "properties": {
    "pistol": {
      "type": "string",
      "minLength": 1,
      "description": "Pistol slug (e.g. \"taurus/g3-toro\") or name (e.g. \"Taurus G3 TORO\")."
    },
    "optic": {
      "type": "string",
      "minLength": 1,
      "description": "Optic slug (e.g. \"trijicon/rmr-type-2\") or name (e.g. \"Trijicon RMR Type 2\")."
    }
  },
  "required": [
    "pistol",
    "optic"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

List every optic with a cited fit on one pistol, each marked direct (with footprint) or adapter (with the plate chain in via). Use it for questions like "what red dots fit my pistol". Optics not listed have no cited fit, which is not evidence they do not fit. Report the answer exactly as returned: never call an adapter fit a direct fit, and never turn "unknown" into "does not fit". Cite with the returned citation line and link html_url.

{
  "type": "object",
  "properties": {
    "pistol": {
      "type": "string",
      "minLength": 1,
      "description": "Pistol slug (e.g. \"taurus/g3-toro\") or name (e.g. \"Taurus G3 TORO\")."
    },
    "fit": {
      "default": "any",
      "description": "Only direct fits, only adapter-plate fits, or both (default).",
      "type": "string",
      "enum": [
        "direct",
        "adapter",
        "any"
      ]
    }
  },
  "required": [
    "pistol"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

List every pistol with a cited fit for one optic, each marked direct (with footprint) or adapter (with the plate chain in via). Use it for questions like "what pistols take this red dot". Report the answer exactly as returned: never call an adapter fit a direct fit, and never turn "unknown" into "does not fit". Cite with the returned citation line and link html_url.

{
  "type": "object",
  "properties": {
    "optic": {
      "type": "string",
      "minLength": 1,
      "description": "Optic slug (e.g. \"trijicon/rmr-type-2\") or name (e.g. \"Trijicon RMR Type 2\")."
    }
  },
  "required": [
    "optic"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Describe one optic mounting footprint or plate system (for example RMR, RMSc, ACRO, DPP, Glock MOS): screw and recoil lug counts, the optics that use it, the pistols cut for it directly, and the adapter plates that mount or present it, with sources.

{
  "type": "object",
  "properties": {
    "name_or_slug": {
      "type": "string",
      "minLength": 1,
      "description": "Footprint slug (e.g. \"rmsc\") or name (e.g. \"RMSc\", \"Glock MOS\")."
    }
  },
  "required": [
    "name_or_slug"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Find pistols, optics and footprints by name. Returns slugs, names and page URLs to pass to the other tools. Use it when you are unsure of an exact model name.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "description": "Words to match, e.g. \"glock 19\", \"holosun 507\", \"rmr\"."
    },
    "type": {
      "description": "Limit results to one kind of record.",
      "type": "string",
      "enum": [
        "pistols",
        "optics",
        "footprints"
      ]
    }
  },
  "required": [
    "query"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}