GunSpec

All 39 single-call tools

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
    {  "name": "gunspec_top_firearms",  "arguments": {    "stat": "lightest",    "category": "pistol",    "limit": 5  }}
  3. 3

    The server answers

    Result
    json
    [  {    "id": "iver-johnson-eclipse",    "name": "Iver Johnson Eclipse",    "manufacturerId": "iver-johnson",    "categoryId": "pistol",    "value": 140,    "unit": "g"  },  {    "id": "braverman-stinger-pen-gun",    "name": "Braverman Stinger Pen Gun",    "manufacturerId": "rj-braverman",    "categoryId": "pistol",    "value": 142,    "unit": "g"  },  {    "id": "frank-wesson-superposed-derringer",    "name": "Frank Wesson Superposed Derringer",    "manufacturerId": "frank-wesson",    "categoryId": "pistol",    "value": 145,    "unit": "g"  }]

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

Related references

Arguments

  • stringrequired

    The statistic to rank by.

    Accepts
    Sent as
    ?stat=
  • string

    Limit results to this category slug.

    Sent as
    ?category=
  • integerdefault10

    Number of results to return.

    Range
    1 – 50
    Sent as
    ?limit=

Each argument is sent to GET /v1/firearms/top as the parameter shown, so the same request can be made to the API directly, with your key, if you want to shape what comes back.

json