What an attachment fits

• gunspec_attachment_firearms
• Studio
• Read-only

Returns every firearm that one attachment fits, with the supporting evidence for each. Requires the Studio plan.

Example usage

1. 1

   A person asks

   • Which firearms does the SureFire SOCOM556-RC2 fit?
2. 2

   The assistant calls the tool

   tools/call

   json

   1{2  "name": "gunspec_attachment_firearms",3  "arguments": {4    "id": "surefire-socom556-rc2",5    "per_page": 56  }7}

3. 3

   The server answers

   Result

   json

   1{2  "firearms": [3    {4      "id": "2a-balios-lite-blr-16",5      "name": "2A Armament Balios Lite BLR-16",6      "fitType": "direct",7      "source": "inferred",8      "confidence": 0.6,9      "reason": "Mounts on 1/2-28 UNEF right hand (muzzle)",10      "via": [11        {12          "position": "muzzle",13          "standardId": "thread:1/2x28",14          "source": "inferred",15          "adapterId": null16        }17      ],18      "adapter": null,19      "manufacturer": {20        "id": "2a-armament",21        "name": "2A Armament"22      },23      "category": "Rifle",24      "svgLineArtUrl": null,25      "yearIntroduced": 2014,26      "images": [27        {28          "id": 5976,29          "url": "https://api.gunspec.io/v1/firearms/2a-balios-lite-blr-16/images/5976",30          "kind": "render",31          "alt": null,32          "width": null,33          "height": null34        }35      ]36    },37    {38      "id": "2a-balios-lite-blr-carbon",39      "name": "2A Armament Balios Lite BLR-Carbon",40      "fitType": "direct",41      "source": "inferred",42      "confidence": 0.6,43      "reason": "Mounts on 1/2-28 UNEF right hand (muzzle)",44      "via": [45        {46          "position": "muzzle",47          "standardId": "thread:1/2x28",48          "source": "inferred",49          "adapterId": null50        }51      ],52      "adapter": null,53      "manufacturer": {54        "id": "2a-armament",55        "name": "2A Armament"56      },57      "category": "Rifle",58      "svgLineArtUrl": null,59      "yearIntroduced": 2015,60      "images": [61        {62          "id": 5977,63          "url": "https://api.gunspec.io/v1/firearms/2a-balios-lite-blr-carbon/images/5977",64          "kind": "render",65          "alt": null,66          "width": null,67          "height": null68        }69      ]70    },71    {72      "id": "aero-precision-m4e1-complete",73      "name": "Aero Precision M4E1 Complete",74      "fitType": "direct",75      "source": "inferred",76      "confidence": 0.5,77      "reason": "Mounts on 1/2-28 UNEF right hand (muzzle)",78      "via": [79        {80          "position": "muzzle",81          "standardId": "thread:1/2x28",82          "source": "inferred",83          "adapterId": null84        }85      ],86      "adapter": null,87      "manufacturer": {88        "id": "aero-precision",89        "name": "Aero Precision"90      },91      "category": "Carbine",92      "svgLineArtUrl": "/firearms/line/svg/aero-precision-m4e1-complete.svg",93      "yearIntroduced": 2015,94      "images": [95        {96          "id": 650,97          "url": "https://assets.gunspec.io/firearms/line/svg/aero-precision-m4e1-complete.svg",98          "kind": "silhouette",99          "alt": null,100          "width": null,101          "height": null102        },103        {104          "id": 6004,105          "url": "https://api.gunspec.io/v1/firearms/aero-precision-m4e1-complete/images/6004",106          "kind": "render",107          "alt": null,108          "width": null,109          "height": null110        }111      ]112    }113  ],114  "pagination": {115    "page": 1,116    "limit": 5,117    "per_page": 5,118    "total": 103,119    "totalPages": 21120  }121}

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

Related references

Arguments