What fits a firearm

• gunspec_what_fits
• Studio
• Up to 2 requests
• Read-only

Workflow. Returns the optics, muzzle devices, stocks, grips and magazines that attach to a firearm, computed from its mounting interfaces, in a single call. Where a seller lists a part, the response includes where to buy it. Provide the firearm as the user named it and, optionally, a category ("optic", "muzzle", "stock"). The response contains the firearm's mounts, followed by up to ten compatible parts per category. Each part states how it fits (direct or through an adapter) and lists its offers. If the name matches more than one firearm, the tool returns the candidates instead. Replaces the resolve call, the attachments call and one offers call per part.

Example usage

1. 1

   A person asks

   • Which optics fit an AK-74M?
2. 2

   The assistant calls the tool

   tools/call

   json

   1{2  "name": "gunspec_what_fits",3  "arguments": {4    "firearm": "AK-74M",5    "category": "optic"6  }7}

3. 3

   The server answers

   Result

   json

   1{2  "resolved": true,3  "firearm": {4    "id": "ak-74m",5    "name": "AK-74M"6  },7  "platforms": [8    {9      "id": "ak-100",10      "name": "AK-100 series (AK-74M pattern)"11    }12  ],13  "mounts": [14    {15      "position": "mag_well",16      "standard": "AK 5.45x39 magazine well",17      "source": "curated",18      "confidence": 119    },20    {21      "position": "muzzle",22      "standard": "M24x1.5 right hand (AK-74, AK-100 series)",23      "source": "curated",24      "confidence": 125    },26    {27      "position": "grip",28      "standard": "AK pistol grip nut and screw",29      "source": "inherited:platform",30      "confidence": 131    }32  ],33  "total": 45,34  "categories": [35    {36      "category": "optic",37      "count": 45,38      "items": [39        {40          "id": "aimpoint-compm5",41          "name": "Aimpoint CompM5",42          "manufacturer": "Aimpoint AB",43          "fitType": "adapter",44          "via": "UFM KeyMod System for AKM Rifles, Long Version",45          "confidence": 1,46          "offers": []47        },48        {49          "id": "aimpoint-duty-rds",50          "name": "Aimpoint Duty RDS",51          "manufacturer": "Aimpoint AB",52          "fitType": "adapter",53          "via": "UFM KeyMod System for AKM Rifles, Long Version",54          "confidence": 1,55          "offers": []56        },57        {58          "id": "aimpoint-micro-t-2",59          "name": "Aimpoint Micro T-2",60          "manufacturer": "Aimpoint AB",61          "fitType": "adapter",62          "via": "UFM KeyMod System for AKM Rifles, Long Version",63          "confidence": 1,64          "offers": []65        }66      ]67    }68  ]69}

   Captured from the live API on Sep 17, 2026. Lists and long text are shortened for display.

Steps

The requests this workflow makes, in order. If your plan does not include an optional step, that step is omitted and listed under gaps in the response, together with the plan it requires.

1. 1

   Resolve a name to one firearm

   • GET/v1/firearms/resolve
   • client.firearms.resolve()
   • Builder
2. 2

   List attachments that fit a firearm

   • GET/v1/firearms/{id}/attachments
   • client.firearms.getAttachments()
   • Studio
3. One response

   The workflow combines up to 2 requests into a single response for the assistant.

Arguments