Identify a firearm

• gunspec_identify_firearm
• Builder
• Up to 4 requests
• Read-only

Workflow. Converts an informally written firearm name ("G19 gen 5", "M4A1") into one specification card in a single call. The card contains the matched record's key figures, calibers, variant count and first image. If the name matches more than one record, the tool returns the candidates instead of guessing. Ask the user which one they meant, then call the tool again with that id. Replaces the resolve, get, variants and media calls.

Example usage

1. 1

   A person asks

   • Tell me everything about the Glock 17.
   • What is a Glock 17, and which variants of it exist?
2. 2

   The assistant calls the tool

   tools/call

   json

   1{2  "name": "gunspec_identify_firearm",3  "arguments": {4    "name": "Glock 17"5  }6}

3. 3

   The server answers

   Result

   json

   1{2  "resolved": true,3  "firearm": {4    "id": "glock-g17",5    "name": "Glock 17",6    "version": "1dc0085f469a3786f9cd4fce92845f4beffcb0494239e4419a17c3adf09b4749",7    "manufacturer": {8      "id": "glock",9      "name": "Glock Ges.m.b.H."10    },11    "category": "Pistol",12    "actionType": "short_recoil",13    "status": "in_production",14    "countryOfOrigin": "AT",15    "yearIntroduced": 1982,16    "yearDiscontinued": null,17    "designer": "Gaston Glock",18    "calibers": [19      {20        "id": "9x19mm-parabellum",21        "name": "9x19mm Parabellum",22        "isPrimary": 123      }24    ],25    "magazineCapacity": 17,26    "weightEmptyG": 625,27    "overallLengthMm": 204,28    "barrelLengthMm": 114,29    "muzzleVelocityMps": 375,30    "effectiveRangeM": 50,31    "dataConfidence": 0.932  },33  "variants": {34    "count": 6,35    "sample": [36      {37        "id": "glock-g18",38        "name": "Glock 18"39      },40      {41        "id": "glock-g17-gen4",42        "name": "Glock G17 Gen4"43      },44      {45        "id": "glock-g17-gen5",46        "name": "Glock G17 Gen5"47      }48    ]49  },50  "media": {51    "count": 4,52    "first": {53      "kind": "silhouette",54      "url": "https://assets.gunspec.io/firearms/line/svg/glock-g17.svg"55    }56  },57  "gaps": []58}

   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

   Get a firearm

   • GET/v1/firearms/{id}
   • client.firearms.get()
   • Builder
3. 3

   List variants

   • GET/v1/firearms/{id}/variants
   • client.firearms.getVariants()
   • Explorer

   Optional. If your plan does not include this request, it is skipped and listed under gaps in the response.

4. 4

   List every asset for a firearm

   • GET/v1/firearms/{id}/media
   • client.firearms.listMedia()
   • Explorer

   Optional. If your plan does not include this request, it is skipped and listed under gaps in the response.

5. One response

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

Arguments