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. Needs the Builder plan.

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": "resolved",4  "firearmId": "glock-19-gen5",5  "match": "alternate",6  "score": 0.95,7  "matchedTokens": [8    "g",9    "19",10    "gen"11  ],12  "unresolvedTokens": [],13  "alternatives": [14    {15      "firearmId": "glock-g19",16      "name": "Glock G19",17      "manufacturerName": "Glock Ges.m.b.H.",18      "match": "alternate",19      "matchedAlias": "G19",20      "score": 0.4121    },22    {23      "firearmId": "glock-g19-gen-4-mos",24      "name": "Glock G19 Gen4 MOS",25      "manufacturerName": "Glock Ges.m.b.H.",26      "match": "shorthand",27      "matchedAlias": "G19",28      "score": 0.3629    },30    {31      "firearmId": "glock-g19-gen-5-mos",32      "name": "Glock G19 Gen5 MOS",33      "manufacturerName": "Glock Ges.m.b.H.",34      "match": "shorthand",35      "matchedAlias": "G19",36      "score": 0.3637    }38  ]39}

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

Related references

Arguments

• namestringrequired

  The firearm name exactly as the user wrote it.