GunSpec

All 30 tools

Search firearms

  • gunspec_search_firearms
  • Builder
  • Read-only

Runs a full-text search over the firearm catalog by name, manufacturer, model number or alias. Use this tool first when the user refers to a firearm informally. Returns matching firearms with the slug ids that the other tools accept.

Example usage

  1. 1

    A person asks

    • Find firearms matching "beretta 92".
  2. 2

    The assistant calls the tool

    tools/call
    json
    {  "name": "gunspec_search_firearms",  "arguments": {    "q": "beretta 92",    "per_page": 5  }}
  3. 3

    The server answers

    Result
    json
    {  "results": [    {      "id": "beretta-92x-performance-dark-series",      "name": "Beretta 92X Performance Dark Series",      "manufacturer_id": "beretta",      "category_id": "pistol",      "manufacturer_name": "Beretta",      "category_name": "Pistol",      "category_slug": "pistol",      "year_introduced": 2025,      "status": "in_production",      "country_of_origin": "IT",      "action_type": "short_recoil",      "weight_empty_g": 1353,      "barrel_length_mm": 122,      "svg_line_art_url": null,      "model_3d_url": null,      "favorite_count": 0,      "rank": -12.741270433420858,      "images": []    },    {      "id": "helwan-920",      "name": "Helwan 920",      "manufacturer_id": "factory-54",      "category_id": "pistol",      "manufacturer_name": "Factory 54 (Maadi Company for Engineering Industries)",      "category_name": "Pistol",      "category_slug": "pistol",      "year_introduced": 1982,      "status": "discontinued",      "country_of_origin": "EG",      "action_type": "short_recoil",      "weight_empty_g": 970,      "barrel_length_mm": 125,      "svg_line_art_url": null,      "model_3d_url": null,      "favorite_count": 0,      "rank": -12.718481842191096,      "images": []    },    {      "id": "taurus-pt92",      "name": "Taurus PT92",      "manufacturer_id": "taurus",      "category_id": "pistol",      "manufacturer_name": "Taurus",      "category_name": "Pistol",      "category_slug": "pistol",      "year_introduced": 1983,      "status": "in_production",      "country_of_origin": "BR",      "action_type": "short_recoil",      "weight_empty_g": 960,      "barrel_length_mm": 127,      "svg_line_art_url": null,      "model_3d_url": null,      "favorite_count": 0,      "rank": -12.456697660392756,      "images": []    }  ],  "pagination": {    "page": 1,    "limit": 5,    "per_page": 5,    "total": 88,    "totalPages": 18  }}

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

Related references

Arguments

NameTypeDescription
q (required)stringThe search text, e.g. "beretta 92" or "AK-74M".
per_pageintegerItems per page, 1 to 100.
1 to 100
Default: 20