Top firearms by a statistic

• gunspec_top_firearms
• Builder
• Read-only

Ranks the catalog by one measurable statistic: lightest, heaviest, longest range, highest rate of fire, most compact, highest capacity or most powerful. Results can be limited to one category.

Example usage

1. 1

   A person asks

   • What are the five lightest pistols in the catalog?
2. 2

   The assistant calls the tool

   tools/call

   json

   1{2  "name": "gunspec_top_firearms",3  "arguments": {4    "stat": "lightest",5    "category": "pistol",6    "limit": 57  }8}

3. 3

   The server answers

   Result

   json

   1[2  {3    "id": "freedom-arms-mini",4    "name": "Freedom Arms Mini Revolver",5    "manufacturerId": "freedom-arms",6    "categoryId": "pistol",7    "value": 110,8    "unit": "g"9  },10  {11    "id": "iver-johnson-eclipse",12    "name": "Iver Johnson Eclipse",13    "manufacturerId": "iver-johnson",14    "categoryId": "pistol",15    "value": 140,16    "unit": "g"17  },18  {19    "id": "braverman-stinger-pen-gun",20    "name": "Braverman Stinger Pen Gun",21    "manufacturerId": "rj-braverman",22    "categoryId": "pistol",23    "value": 142,24    "unit": "g"25  }26]

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

Related references

Arguments