GunSpec

All 39 single-call tools

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
    {  "name": "gunspec_attachment_firearms",  "arguments": {    "id": "surefire-socom556-rc2",    "per_page": 5  }}
  3. 3

    The server answers

    Result
    json
    {  "firearms": [    {      "id": "2a-balios-lite-blr-16",      "name": "2A Armament Balios Lite BLR-16",      "fitType": "adapter",      "source": "inferred",      "confidence": 0.6,      "reason": "Fits with SureFire SF3P-556 (1/2-28) (SureFire SOCOM 5.56 fast-attach mount, muzzle), or 3 other routes",      "via": [        {          "position": "muzzle",          "standardId": "qd:surefire-socom-556",          "source": "inferred",          "adapterId": "surefire-sf3p-556"        }      ],      "adapter": {        "id": "surefire-sf3p-556",        "name": "SureFire SF3P-556 (1/2-28)"      },      "manufacturer": {        "id": "2a-armament",        "name": "2A Armament"      },      "category": "Rifle",      "svgLineArtUrl": "https://api.gunspec.io/v1/firearms/2a-balios-lite-blr-16/media/silhouette",      "yearIntroduced": 2014,      "images": [        {          "id": 9850,          "url": "https://api.gunspec.io/v1/firearms/2a-balios-lite-blr-16/images/9850",          "kind": "silhouette",          "alt": null,          "width": null,          "height": null        },        {          "id": 5976,          "url": "https://api.gunspec.io/v1/firearms/2a-balios-lite-blr-16/images/5976",          "kind": "render",          "alt": "2A Armament Balios Lite BLR-16 rifle, left-side profile render",          "width": 1536,          "height": 1024        }      ]    },    {      "id": "2a-balios-lite-blr-carbon",      "name": "2A Armament Balios Lite BLR-Carbon",      "fitType": "adapter",      "source": "inferred",      "confidence": 0.6,      "reason": "Fits with SureFire SF3P-556 (1/2-28) (SureFire SOCOM 5.56 fast-attach mount, muzzle), or 3 other routes",      "via": [        {          "position": "muzzle",          "standardId": "qd:surefire-socom-556",          "source": "inferred",          "adapterId": "surefire-sf3p-556"        }      ],      "adapter": {        "id": "surefire-sf3p-556",        "name": "SureFire SF3P-556 (1/2-28)"      },      "manufacturer": {        "id": "2a-armament",        "name": "2A Armament"      },      "category": "Rifle",      "svgLineArtUrl": "https://api.gunspec.io/v1/firearms/2a-balios-lite-blr-carbon/media/silhouette",      "yearIntroduced": 2015,      "images": [        {          "id": 9851,          "url": "https://api.gunspec.io/v1/firearms/2a-balios-lite-blr-carbon/images/9851",          "kind": "silhouette",          "alt": null,          "width": null,          "height": null        },        {          "id": 5977,          "url": "https://api.gunspec.io/v1/firearms/2a-balios-lite-blr-carbon/images/5977",          "kind": "render",          "alt": "2A Armament Balios Lite BLR-Carbon rifle, left-side profile render",          "width": 1536,          "height": 1024        }      ]    },    {      "id": "angstadt-udp-556",      "name": "Angstadt Arms UDP-556",      "fitType": "adapter",      "source": "inferred",      "confidence": 0.6,      "reason": "Fits with SureFire SF3P-556 (1/2-28) (SureFire SOCOM 5.56 fast-attach mount, muzzle), or 3 other routes",      "via": [        {          "position": "muzzle",          "standardId": "qd:surefire-socom-556",          "source": "inferred",          "adapterId": "surefire-sf3p-556"        }      ],      "adapter": {        "id": "surefire-sf3p-556",        "name": "SureFire SF3P-556 (1/2-28)"      },      "manufacturer": {        "id": "angstadt-arms",        "name": "Angstadt Arms"      },      "category": "Pistol",      "svgLineArtUrl": "https://api.gunspec.io/v1/firearms/angstadt-udp-556/media/silhouette",      "yearIntroduced": 2017,      "images": [        {          "id": 9910,          "url": "https://api.gunspec.io/v1/firearms/angstadt-udp-556/images/9910",          "kind": "silhouette",          "alt": null,          "width": null,          "height": null        },        {          "id": 14797,          "url": "https://api.gunspec.io/v1/firearms/angstadt-udp-556/images/14797",          "kind": "render",          "alt": "Angstadt Arms UDP-556 handgun, left-side profile render",          "width": 1536,          "height": 1024        }      ]    }  ],  "pagination": {    "page": 1,    "limit": 5,    "per_page": 5,    "total": 113,    "totalPages": 23  }}

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

Related references

Arguments

  • stringrequired

    The attachment 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/attachments/{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