GunSpec

All 39 single-call tools

Firearms chambered in a caliber

  • gunspec_caliber_firearms
  • Explorer
  • Read-only

Returns every firearm chambered for a cartridge, with pagination.

Example usage

  1. 1

    A person asks

    • Which firearms are chambered in 9mm Parabellum?
  2. 2

    The assistant calls the tool

    tools/call
    json
    {  "name": "gunspec_caliber_firearms",  "arguments": {    "id": "9x19mm-parabellum",    "per_page": 5  }}
  3. 3

    The server answers

    Result
    json
    {  "firearms": [    {      "id": "arex-alpha",      "name": "AREX Defense Alpha",      "manufacturerId": "arex",      "categoryId": "pistol",      "yearIntroduced": null,      "status": "discontinued",      "actionType": "short_recoil",      "svgLineArtUrl": "https://api.gunspec.io/v1/firearms/arex-alpha/media/silhouette",      "model3dUrl": null,      "countryOfOrigin": "SI",      "images": [        {          "id": 2684,          "url": "https://api.gunspec.io/v1/firearms/arex-alpha/images/2684",          "kind": "silhouette",          "alt": null,          "width": null,          "height": null        },        {          "id": 27560,          "url": "https://api.gunspec.io/v1/firearms/arex-alpha/images/27560",          "kind": "render",          "alt": "AREX Defense Alpha handgun, left-side profile render",          "width": 1536,          "height": 1024        }      ]    },    {      "id": "arex-delta",      "name": "AREX Defense Delta",      "manufacturerId": "arex",      "categoryId": "pistol",      "yearIntroduced": null,      "status": "discontinued",      "actionType": "short_recoil",      "svgLineArtUrl": "https://api.gunspec.io/v1/firearms/arex-delta/media/silhouette",      "model3dUrl": null,      "countryOfOrigin": "SI",      "images": [        {          "id": 2686,          "url": "https://api.gunspec.io/v1/firearms/arex-delta/images/2686",          "kind": "silhouette",          "alt": null,          "width": null,          "height": null        },        {          "id": 14833,          "url": "https://api.gunspec.io/v1/firearms/arex-delta/images/14833",          "kind": "render",          "alt": "AREX Defense Delta handgun, left-side profile render",          "width": 1536,          "height": 1024        }      ]    },    {      "id": "arex-delta-gen-2",      "name": "AREX Defense Delta Gen.2",      "manufacturerId": "arex",      "categoryId": "pistol",      "yearIntroduced": null,      "status": "discontinued",      "actionType": "short_recoil",      "svgLineArtUrl": "https://api.gunspec.io/v1/firearms/arex-delta-gen-2/media/silhouette",      "model3dUrl": null,      "countryOfOrigin": "SI",      "images": [        {          "id": 2685,          "url": "https://api.gunspec.io/v1/firearms/arex-delta-gen-2/images/2685",          "kind": "silhouette",          "alt": null,          "width": null,          "height": null        },        {          "id": 6046,          "url": "https://api.gunspec.io/v1/firearms/arex-delta-gen-2/images/6046",          "kind": "render",          "alt": "AREX Defense Delta Gen.2 handgun, left-side profile render",          "width": 1536,          "height": 1024        }      ]    }  ],  "pagination": {    "page": 1,    "limit": 5,    "per_page": 5,    "total": 1581,    "totalPages": 317  }}

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

Related references

Arguments

  • stringrequired

    The caliber slug, e.g. as returned by a list or search tool.

    Sent as
    {id}
  • integerdefault1

    Page number, from 1.

    Minimum
    1
    Sent as
    ?page=
  • integerdefault20

    Items per page, 1 to 100.

    Range
    1 – 100
    Sent as
    ?per_page=

Each argument is sent to GET /v1/calibers/{id}/firearms 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