GunSpec

All 30 tools

List firearms

  • gunspec_list_firearms
  • Explorer
  • Read-only

Lists firearms using structured filters: manufacturer, cartridge, category, action, country, status and year range. Use this tool when the question asks which firearms match a set of criteria, not when it asks about one specific firearm.

Example usage

  1. 1

    A person asks

    • List five firearms made by Glock.
  2. 2

    The assistant calls the tool

    tools/call
    json
    {  "name": "gunspec_list_firearms",  "arguments": {    "manufacturer": "glock",    "per_page": 5  }}
  3. 3

    The server answers

    Result
    json
    {  "firearms": [    {      "id": "glock-g17",      "name": "Glock 17",      "manufacturerId": "glock",      "categoryId": "pistol",      "yearIntroduced": 1982,      "status": "in_production",      "countryOfOrigin": "AT",      "actionType": "short_recoil",      "weightEmptyG": 625,      "barrelLengthMm": 114,      "createdAt": "2026-02-17 06:05:51",      "updatedAt": "2026-02-17 06:05:51",      "version": "1dc0085f469a3786f9cd4fce92845f4beffcb0494239e4419a17c3adf09b4749",      "svgLineArtUrl": "https://assets.gunspec.io/firearms/line/svg/glock-g17.svg",      "model3dUrl": null,      "favoriteCount": 0,      "images": [        {          "id": 1460,          "url": "https://assets.gunspec.io/firearms/line/svg/glock-g17.svg",          "kind": "silhouette",          "alt": null,          "width": null,          "height": null        },        {          "id": 6578,          "url": "https://api.gunspec.io/v1/firearms/glock-g17/images/6578",          "kind": "render",          "alt": null,          "width": null,          "height": null        },        {          "id": 9826,          "url": "https://assets.gunspec.io/content/firearms/photos/glock-g17/01-photo.c01b4944ea90.webp",          "kind": "photo",          "alt": "Glock 17",          "width": 1920,          "height": 1275        }      ]    },    {      "id": "glock-17-gen5",      "name": "Glock 17 Gen5",      "manufacturerId": "glock",      "categoryId": "pistol",      "yearIntroduced": 2017,      "status": "in_production",      "countryOfOrigin": "AT",      "actionType": "short_recoil",      "weightEmptyG": 625,      "barrelLengthMm": 114,      "createdAt": "2026-02-11 23:44:44",      "updatedAt": "2026-02-17 06:05:51",      "version": "2bf979d7305932779e63bdf430a26b723d71d5be03b50de24b9908efed18c9c0",      "svgLineArtUrl": "https://assets.gunspec.io/firearms/line/svg/glock-17-gen5.svg",      "model3dUrl": null,      "favoriteCount": 0,      "images": [        {          "id": 760,          "url": "https://assets.gunspec.io/firearms/line/svg/glock-17-gen5.svg",          "kind": "silhouette",          "alt": null,          "width": null,          "height": null        },        {          "id": 6563,          "url": "https://api.gunspec.io/v1/firearms/glock-17-gen5/images/6563",          "kind": "render",          "alt": null,          "width": null,          "height": null        },        {          "id": 9818,          "url": "https://assets.gunspec.io/content/firearms/photos/glock-17-gen5/01-photo.c01b4944ea90.webp",          "kind": "photo",          "alt": "Glock 17 Gen5",          "width": 1920,          "height": 1275        }      ]    },    {      "id": "glock-17-gen6",      "name": "Glock 17 Gen6",      "manufacturerId": "glock",      "categoryId": "pistol",      "yearIntroduced": 2026,      "status": "in_production",      "countryOfOrigin": "AT",      "actionType": "short_recoil",      "weightEmptyG": 709,      "barrelLengthMm": 114,      "createdAt": "2026-06-21 23:00:56",      "updatedAt": "2026-06-21 23:00:56",      "version": "ae52b8404dd92752d6a8f040e819526738b0be5b01cbde5137f357fba54e8268",      "svgLineArtUrl": null,      "model3dUrl": null,      "favoriteCount": 0,      "images": []    }  ],  "pagination": {    "page": 1,    "limit": 5,    "per_page": 5,    "total": 134,    "totalPages": 27  }}

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

Related references

Arguments

NameTypeDescription
manufacturerstringManufacturer slug, e.g. "glock".
caliberstringCaliber slug, e.g. "9x19mm-parabellum".
categorystringCategory slug, e.g. "pistol", "rifle" or "shotgun".
action_typestringAction type, e.g. "semi-automatic" or "bolt-action".
country_of_originstringCountry name or ISO code.
statusstringProduction status.
One of: in_production, discontinued, out_of_production, in_service, limited_production, prototype
year_introduced_minintegerEarliest year introduced.
year_introduced_maxintegerLatest year introduced.
sortstringSort column.
One of: name, weight, year, caliber, created_at, favorites
orderstringSort direction.
One of: asc, desc
pageintegerPage number, from 1.
At least 1
Default: 1
per_pageintegerItems per page, 1 to 100.
1 to 100
Default: 20