GunSpec

All 39 single-call tools

List attachments

  • gunspec_list_attachments
  • Explorer
  • Read-only

Lists suppressors, optics, magazines, grips, stocks and other attachments. `fits` limits results to attachments that fit one firearm and requires the Studio plan. `requires` limits results to parts that need one mount standard.

Example usage

  1. 1

    A person asks

    • List some attachments in the catalog.
  2. 2

    The assistant calls the tool

    tools/call
    json
    {  "name": "gunspec_list_attachments",  "arguments": {    "per_page": 5  }}
  3. 3

    The server answers

    Result
    json
    {  "attachments": [    {      "id": "law-tactical-folding-stock-adapter-gen-s",      "name": "AR Folding Stock Adapter, GEN-S",      "category": "adapter",      "manufacturer": {        "id": "law-tactical",        "name": "Law Tactical"      },      "modelNumber": "99312",      "weightG": 266,      "lengthMm": null,      "capacity": null,      "boreDiameterMm": null,      "requiresPosition": "rear",      "isFactoryPart": false,      "factoryFor": null,      "provides": [        "stock:ar-lower-receiver-thread"      ],      "statMods": {        "mobility": 3      },      "specDeltas": {        "length_added_mm": 33      },      "imageUrl": "https://assets.gunspec.io/content/attachments/adapter/law-tactical-folding-stock-adapter-gen-s/01-product.webp",      "status": "in_production",      "dataConfidence": 0.85,      "updatedAt": "2026-09-10 01:28:41",      "version": "e27e61b4b373f5a621d6ae5c67d521096131f2cf563005c993099d44e85001b1",      "provenance": {        "sources": [          "https://www.lawtactical.com/ar_folding_stock_adapter_gen_3_m_p/99312.htm",          "https://www.lawtactical.com"        ],        "sourceKinds": [          {            "url": "https://www.lawtactical.com/ar_folding_stock_adapter_gen_3_m_p/99312.htm",            "kind": "manufacturer",            "archivedFrom": null,            "rank": 0,            "tier": "authority",            "basis": "maker",            "evidence": null          },          {            "url": "https://www.lawtactical.com",            "kind": "manufacturer",            "archivedFrom": null,            "rank": 0,            "tier": "authority",            "basis": "maker",            "evidence": null          }        ],        "bestSourceKind": "manufacturer",        "makerSource": "https://www.lawtactical.com/ar_folding_stock_adapter_gen_3_m_p/99312.htm",        "evidence": "maker",        "dataConfidence": 0.85,        "verifiedAt": null,        "verifiedFields": null,        "specSource": null,        "updatedAt": "2026-09-10 01:28:41",        "version": "e27e61b4b373f5a621d6ae5c67d521096131f2cf563005c993099d44e85001b1"      }    },    {      "id": "cnc-warrior-5-8-24-to-1-2-28-thread-adapter",      "name": "CNC Warrior 5/8-24 RH to 1/2-28 RH Thread Adapter",      "category": "adapter",      "manufacturer": {        "id": "cnc-warrior",        "name": "CNC Warrior LLC"      },      "modelNumber": "26603",      "weightG": 30,      "lengthMm": 32,      "capacity": null,      "boreDiameterMm": null,      "requiresPosition": "muzzle",      "isFactoryPart": false,      "factoryFor": null,      "provides": [        "thread:1/2x28"      ],      "statMods": {},      "specDeltas": {},      "imageUrl": "https://assets.gunspec.io/content/attachments/adapter/cnc-warrior-5-8-24-to-1-2-28-thread-adapter/01-product.webp",      "status": "in_production",      "dataConfidence": 0.95,      "updatedAt": "2026-09-10 01:28:41",      "version": "5990d4cc66b31740c1c7da23370cb128f26b9c4786c766f9db083f4829750641",      "provenance": {        "sources": [          "https://www.cncwarrior.com/product-p/26603.htm",          "https://www.cncwarrior.com"        ],        "sourceKinds": [          {            "url": "https://www.cncwarrior.com/product-p/26603.htm",            "kind": "manufacturer",            "archivedFrom": null,            "rank": 0,            "tier": "authority",            "basis": "maker",            "evidence": null          },          {            "url": "https://www.cncwarrior.com",            "kind": "manufacturer",            "archivedFrom": null,            "rank": 0,            "tier": "authority",            "basis": "maker",            "evidence": null          }        ],        "bestSourceKind": "manufacturer",        "makerSource": "https://www.cncwarrior.com/product-p/26603.htm",        "evidence": "maker",        "dataConfidence": 0.95,        "verifiedAt": null,        "verifiedFields": null,        "specSource": null,        "updatedAt": "2026-09-10 01:28:41",        "version": "5990d4cc66b31740c1c7da23370cb128f26b9c4786c766f9db083f4829750641"      }    },    {      "id": "cnc-warrior-m14x1-lh-to-5-8-24-thread-adapter",      "name": "CNC Warrior M14x1 LH to 5/8-24 RH Muzzle Thread Adapter",      "category": "adapter",      "manufacturer": {        "id": "cnc-warrior",        "name": "CNC Warrior LLC"      },      "modelNumber": "24928",      "weightG": null,      "lengthMm": 32,      "capacity": null,      "boreDiameterMm": null,      "requiresPosition": "muzzle",      "isFactoryPart": false,      "factoryFor": null,      "provides": [        "thread:5/8x24"      ],      "statMods": {},      "specDeltas": {},      "imageUrl": "https://assets.gunspec.io/content/attachments/adapter/cnc-warrior-m14x1-lh-to-5-8-24-thread-adapter/01-product.webp",      "status": "in_production",      "dataConfidence": 0.9,      "updatedAt": "2026-09-10 01:28:41",      "version": "22375f3b66ade4ebdfcab1b682c05fcc7cb13c500ca13161d08b9c511f206d35",      "provenance": {        "sources": [          "https://www.cncwarrior.com/M14x1-LH-to-5-8-24-RH-Muzzle-Thread-Adapter-p/24928.htm",          "https://www.cncwarrior.com"        ],        "sourceKinds": [          {            "url": "https://www.cncwarrior.com/M14x1-LH-to-5-8-24-RH-Muzzle-Thread-Adapter-p/24928.htm",            "kind": "manufacturer",            "archivedFrom": null,            "rank": 0,            "tier": "authority",            "basis": "maker",            "evidence": null          },          {            "url": "https://www.cncwarrior.com",            "kind": "manufacturer",            "archivedFrom": null,            "rank": 0,            "tier": "authority",            "basis": "maker",            "evidence": null          }        ],        "bestSourceKind": "manufacturer",        "makerSource": "https://www.cncwarrior.com/M14x1-LH-to-5-8-24-RH-Muzzle-Thread-Adapter-p/24928.htm",        "evidence": "maker",        "dataConfidence": 0.9,        "verifiedAt": null,        "verifiedFields": null,        "specSource": null,        "updatedAt": "2026-09-10 01:28:41",        "version": "22375f3b66ade4ebdfcab1b682c05fcc7cb13c500ca13161d08b9c511f206d35"      }    }  ],  "pagination": {    "page": 1,    "limit": 5,    "per_page": 5,    "total": 491,    "totalPages": 99  }}

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

Related references

Arguments

  • string

    Attachment category, e.g. "suppressor", "optic", "magazine", "grip" or "stock".

    Sent as
    ?category=
  • string

    Manufacturer slug.

    Sent as
    ?manufacturer=
  • string

    Return only attachments that fit this firearm slug. Requires the Studio plan.

    Sent as
    ?fits=
  • string

    Return only attachments that require this interface standard id, e.g. "thread:1/2x28".

    Sent as
    ?requires=
  • string

    Text to match within the attachment name.

    Sent as
    ?q=
  • boolean

    Set to true for factory parts only, or false for aftermarket parts only.

    Sent as
    ?factory=
  • string

    Production status.

    Accepts
    Sent as
    ?status=
  • 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 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