Compare firearms by name

• gunspec_compare_by_name
• Builder
• Up to 6 requests
• Read-only

Workflow. Compares two to five firearms, named as the user wrote them ("G19", "P320 Compact"), in a single call. Each name is resolved to a record, and only the figures that differ are returned. The lightest, shortest and highest-capacity firearms are identified. Names that do not match a single record are listed under `unresolved` with their candidates and are never guessed. Replaces one resolve call per name plus one compare call.

Example usage

1. 1

   A person asks

   • Compare the Glock 17 and the Beretta 92FS.
2. 2

   The assistant calls the tool

   tools/call

   json

   1{2  "name": "gunspec_compare_by_name",3  "arguments": {4    "names": [5      "Glock 17",6      "Beretta 92FS"7    ]8  }9}

3. 3

   The server answers

   Result

   json

   1{2  "compared": true,3  "firearms": [4    {5      "id": "glock-g17",6      "name": "Glock 17",7      "version": "1dc0085f469a3786f9cd4fce92845f4beffcb0494239e4419a17c3adf09b4749",8      "manufacturer": "Glock Ges.m.b.H.",9      "primaryCaliber": "9x19mm Parabellum"10    },11    {12      "id": "beretta-92fs",13      "name": "Beretta 92FS",14      "version": "37fc8cf70018f3668accdc9e458e617dd2f6b7271eb8c7f0d06e473f6c8892e9",15      "manufacturer": "Beretta",16      "primaryCaliber": "9x19mm Parabellum"17    }18  ],19  "differences": [20    {21      "field": "weightEmptyG",22      "values": [23        625,24        94525      ],26      "min": 625,27      "max": 945,28      "percentDiff": 51.229    },30    {31      "field": "weightLoadedG",32      "values": [33        905,34        110035      ],36      "min": 905,37      "max": 1100,38      "percentDiff": 21.5539    },40    {41      "field": "barrelLengthMm",42      "values": [43        114,44        12545      ],46      "min": 114,47      "max": 125,48      "percentDiff": 9.6549    }50  ],51  "leaders": {52    "lightest": {53      "id": "glock-g17",54      "name": "Glock 17",55      "value": 62556    },57    "shortest": {58      "id": "glock-g17",59      "name": "Glock 17",60      "value": 20461    },62    "highestCapacity": {63      "id": "glock-g17",64      "name": "Glock 17",65      "value": 1766    }67  },68  "unresolved": []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

   Compare firearms

   • GET/v1/firearms/compare
   • client.firearms.compare()
   • Builder
3. One response

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

Arguments