Resolve a firearm name

• gunspec_resolve_firearm
• Builder
• Read-only

Resolves one free-text name ("G19 gen 5", "M4A1") to a single firearm id, with a confidence score and alternatives. Use this tool instead of search when exactly one record is required.

Example usage

1. 1

   A person asks

   • Which firearm is a "G19 gen 5"?
2. 2

   The assistant calls the tool

   tools/call

   json

   1{2  "name": "gunspec_resolve_firearm",3  "arguments": {4    "name": "G19 gen 5"5  }6}

3. 3

   The server answers

   Result

   json

   1{2  "query": "G19 gen 5",3  "status": "ambiguous",4  "firearmId": null,5  "match": null,6  "score": 0.95,7  "matchedTokens": [8    "g",9    "19",10    "gen"11  ],12  "unresolvedTokens": [],13  "alternatives": [14    {15      "firearmId": "glock-19-gen5",16      "name": "Glock 19 Gen5",17      "manufacturerName": "Glock Ges.m.b.H.",18      "match": "alternate",19      "matchedAlias": "G19 Gen5",20      "score": 0.9521    },22    {23      "firearmId": "glock-g19-gen5",24      "name": "Glock G19 Gen5",25      "manufacturerName": "Glock Ges.m.b.H.",26      "match": "alternate",27      "matchedAlias": "G19 Gen5",28      "score": 0.9529    }30  ]31}

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

Related references

Arguments