Compare firearms
Returns side-by-side specifications for two to five firearms, with the differences calculated.
Example usage
- 1
A person asks
- Compare the AK-47 with the M4A1 carbine side by side.
- 2
The assistant calls the tool
tools/calljson{ "name": "gunspec_compare_firearms", "arguments": { "ids": [ "ak-47", "m4a1-carbine" ] }} - 3
The server answers
Resultjson{ "items": [ { "id": "ak-47", "name": "AK-47", "manufacturerId": "kalashnikov-concern", "categoryId": "assault-rifle", "parentFirearmId": null, "variantType": null, "yearIntroduced": 1947, "yearDiscontinued": 1975, "status": "discontinued", "countryOfOrigin": "SU", "weightEmptyG": 3470, "weightLoadedG": 4300, "overallLengthMm": 869, "barrelLengthMm": 415, "heightMm": 190, "widthMm": 45, "sightRadiusMm": null, "actionType": "gas_operated_long_stroke", "firingMechanism": "hammer_fired", "triggerType": "single_stage", "triggerPullN": null, "magazineCapacity": 30, "magazineType": "detachable_box", "muzzleVelocityMps": 710, "muzzleEnergyJ": 2010, "effectiveRangeM": 300, "maxRangeM": 800, "rateOfFireRpm": 600, "barrelRifling": "right_hand", "riflingTwistMm": 240, "numberOfGrooves": 4, "frameMaterial": "steel", "slideMaterial": null, "barrelMaterial": "steel", "stockMaterial": "wood", "finish": "blued", "safetyMechanisms": [ "manual_safety_selector", "hammer_notch" ], "features": [ "chrome_lined_barrel", "chrome_lined_chamber", "curved_magazine" ], "feedSystems": [ "detachable_box_magazine" ], "gameDamage": 72, "gameAccuracy": 45, "gameRange": 55, "gameFireRate": 80, "gameMobility": 62, "gameRecoilControl": 58, "gameReloadSpeed": 65, "gameConcealment": 25, "description": "The Red Army formally accepted the type in 1949 as the AK-47 rifle. The AK-47 used a gas-operated, rotating polished steel bolt system in which the gas piston was permanently affixed to the bolt carrier itself. Chromium was used to line the…", "notes": "Production of the original AK-47 with milled receiver ended in 1975, replaced by the modernized AKM variant with stamped receiver. The AK-47 designation is often colloquially used to refer to all AK-pattern rifles. The weapon's extreme dura…", "designer": "Mikhail Kalashnikov", "foldedLengthMm": null, "alternateNames": [ "Avtomat Kalashnikova", "Kalash" ], "firingModes": [ "semi_automatic", "full_automatic" ], "conflicts": [ { "name": "Vietnam War", "years": "1955-1975", "sides": [ "North Vietnam / Viet Cong", "South Vietnam / United States" ] }, { "name": "Soviet-Afghan War", "years": "1979-1989", "sides": [ "Soviet Union", "Mujahideen" ] }, { "name": "Six-Day War", "years": "1967-1967", "sides": [ "Israel", "Egypt / Syria / Jordan" ] } ], "productionNumbers": { "estimated_total": 75000000, "production_years": "1947-1975", "notes": "Approximately 75 million AK-47 type rifles produced. Over 100 million AK-pattern rifles of all variants (including AKM, AK-74, and copies) manufactured worldwide." }, "lore": "The AK-47 is so iconic it appears on the national flag of Mozambique and the coat of arms of East Timor, Zimbabwe, and Burkina Faso. Mikhail Kalashnikov reportedly said he wished he had invented a lawnmower instead, given the death toll att…", "sources": [ "https://www.militaryfactory.com/smallarms/detail.php?smallarms_id=19", "https://www.britannica.com/technology/AK-47", "https://en.wikipedia.org/wiki/AK-47" ], "sourceMuzzleVelocityMps": 710, "sourceMuzzleEnergyJ": 2010, "sourceEffectiveRangeM": 300, "sourceMaxRangeM": 800, "ballisticsSource": null, "ballisticsSourceUrl": null, "defaultAmmoId": null, "has3dModel": 1, "svgLineArtUrl": "https://api.gunspec.io/v1/firearms/ak-47/media/silhouette", "model3dUrl": "/models/ak-47.glb", "dataConfidence": 0.6, "verifiedAt": null, "verifiedFields": null, "createdAt": "2026-02-11 23:44:42", "updatedAt": "2026-10-06 23:52:07", "version": "a3e44ef764f4a2fb23fcb8b9a9a6fedc2d894bf8c7ddb404492b2128a6ab1fa5", "provenance": { "sources": [ "https://www.militaryfactory.com/smallarms/detail.php?smallarms_id=19", "https://www.britannica.com/technology/AK-47", "https://en.wikipedia.org/wiki/AK-47" ], "sourceKinds": [ { "url": "https://www.militaryfactory.com/smallarms/detail.php?smallarms_id=19", "kind": "reference", "archivedFrom": null, "rank": 4, "tier": "classified", "basis": "declared", "evidence": null }, { "url": "https://www.britannica.com/technology/AK-47", "kind": "reference", "archivedFrom": null, "rank": 4, "tier": "classified", "basis": "declared", "evidence": null }, { "url": "https://en.wikipedia.org/wiki/AK-47", "kind": "reference", "archivedFrom": null, "rank": 4, "tier": "classified", "basis": "declared", "evidence": null } ], "bestSourceKind": "reference", "makerSource": null, "evidence": "secondary", "dataConfidence": 0.6, "verifiedAt": null, "verifiedFields": null, "specSource": null, "updatedAt": "2026-10-06 23:52:07", "version": "a3e44ef764f4a2fb23fcb8b9a9a6fedc2d894bf8c7ddb404492b2128a6ab1fa5", "checks": { "raised": 1, "open": 0, "history": [ { "task": "gap:quality.firearm-removed-values-researched.description:ak-47", "number": 2071, "check": "quality:firearm-removed-values-researched", "kind": "gap", "agent": null, "worker": null, "status": "resolved", "decidedAt": "2026-10-06T23:26:46.415Z", "proposed": null, "fields": [ "description" ], "sources": [], "review": null, "finding": { "why": "description was removed on 2026-09-25 as invented (description built from filler repeated across dozens of makers); find the real value on a source", "evidence": { "removedAt": "2026-09-25", "reason": [ "description built from filler repeated across dozens of makers" ], "invented": { "description": { "excerpt": "The AK-47 is a select-fire assault rifle chambered in 7.62x39mm, produced by Kalashnikov Concern (formerly Izhmash) since 1947. This Russian-manufactured firear", "length": 1128 } } } } } ] } }, "manufacturer": { "id": "kalashnikov-concern", "name": "Kalashnikov Concern", "countryCode": "RU", "foundedYear": 1807, "website": "https://kalashnikovgroup.ru", "logoUrl": null, "description": null, "status": "active", "defunctYear": null, "stateOwned": null, "makesFirearms": true, "parentId": null, "predecessorId": "izhmash", "createdAt": "2026-02-11 23:44:38", "updatedAt": "2026-09-28 00:42:22", "version": "5dbd5a26234eb361c3083d43102837dab87e81fcfdec2c994266dbe3c13a7ea2" }, "category": { "id": "assault-rifle", "name": "Assault Rifle", "description": "Selective-fire rifles chambered in intermediate cartridges" }, "calibers": [ { "caliberId": "7-62x39mm", "isPrimary": 1, "name": "7.62x39mm", "natoDesignation": null, "bulletDiameterMm": 7.92, "caseLengthMm": 38.7, "cartridgeType": "rimless", "neckDiameterMm": 8.6, "shoulderDiameterMm": 10.07, "baseDiameterMm": 11.35, "rimDiameterMm": 11.35, "rimThicknessMm": 1.5, "overallLengthMm": 56, "bulletLengthMm": 21.4, "typicalBulletWeightG": 7.97, "primerType": "berdan", "caseShape": "bottleneck", "caseMaterial": "lacquered_steel", "projectileKind": "bullet", "bulletProfile": "spitzer", "closure": "bullet", "markingColor": null } ], "images": [ { "id": 661, "firearmId": "ak-47", "url": "https://api.gunspec.io/v1/firearms/ak-47/images/661", "type": "svg", "kind": "silhouette", "storage": "cdn", "source": "generated", "author": null, "sourceUrl": null, "license": "cc0", "alt": null, "width": null, "height": null, "sortOrder": 0 }, { "id": 979, "firearmId": "ak-47", "url": "https://assets.gunspec.io/models/ak-47.glb", "type": "3d_model", "kind": "model", "storage": "cdn", "source": "generated", "author": null, "sourceUrl": null, "license": "cc0", "alt": null, "width": null, "height": null, "sortOrder": 0 }, { "id": 6023, "firearmId": "ak-47", "url": "https://api.gunspec.io/v1/firearms/ak-47/images/6023", "type": "render", "kind": "render", "storage": "r2", "source": "AI generated (Azure AI Foundry gpt-image-2.5-sunburst)", "author": "GunSpec", "sourceUrl": null, "license": "GunSpec generated", "alt": "AK-47 assault rifle, left-side profile render", "width": 1536, "height": 1024, "sortOrder": 1 } ], "users": [ { "id": 8231, "firearmId": "ak-47", "userName": "Soviet Armed Forces", "userType": "military", "countryCode": "SU", "adoptedYear": 1949, "designation": "AK-47" }, { "id": 8232, "firearmId": "ak-47", "userName": "Russian Armed Forces", "userType": "military", "countryCode": "RU", "adoptedYear": 1991, "designation": "AK-47" }, { "id": 8233, "firearmId": "ak-47", "userName": "Chinese People's Liberation Army", "userType": "military", "countryCode": "CN", "adoptedYear": 1956, "designation": "Type 56" } ] }, { "id": "m4a1-carbine", "name": "M4A1 Carbine", "manufacturerId": "colt", "categoryId": "carbine", "parentFirearmId": null, "variantType": null, "yearIntroduced": 1994, "yearDiscontinued": null, "status": "in_production", "countryOfOrigin": "US", "weightEmptyG": 2886, "weightLoadedG": 3456, "overallLengthMm": 840, "barrelLengthMm": 368, "heightMm": null, "widthMm": null, "sightRadiusMm": null, "actionType": "gas_operated_direct_impingement", "firingMechanism": "hammer_fired", "triggerType": "single_stage", "triggerPullN": 34, "magazineCapacity": 30, "magazineType": "detachable_box", "muzzleVelocityMps": 905, "muzzleEnergyJ": 1640, "effectiveRangeM": 500, "maxRangeM": 3600, "rateOfFireRpm": 850, "barrelRifling": "right_hand", "riflingTwistMm": 178, "numberOfGrooves": 6, "frameMaterial": "aluminum_alloy", "slideMaterial": null, "barrelMaterial": "steel", "stockMaterial": "polymer", "finish": "hard_anodized", "safetyMechanisms": [ "manual_safety_selector", "half_cock_notch" ], "features": [ "collapsible_stock", "select_fire", "accessory_rail" ], "feedSystems": [ "detachable_box_magazine" ], "gameDamage": 68, "gameAccuracy": 72, "gameRange": 65, "gameFireRate": 85, "gameMobility": 70, "gameRecoilControl": 64, "gameReloadSpeed": 70, "gameConcealment": 40, "description": "The M4A1 is a fully automatic variant of the M4 carbine, a shorter and lighter variant of the M16. It went into service in 1994 to replace the M16 in certain roles. The M4A1 trigger group operates on either Safe, Semi-Automatic, or Fully Au…", "notes": "The M4A1 differs from the standard M4 in having full-automatic capability instead of 3-round burst fire. The barrel was also thickened to better dissipate heat during automatic fire. The weapon features a flattop receiver with Picatinny rai…", "designer": "Eugene Stoner", "foldedLengthMm": 757, "alternateNames": [ "Carbine, 5.56mm, M4A1", "Colt Model 921", "SOPMOD M4A1" ], "firingModes": [ "semi_automatic", "full_automatic" ], "conflicts": [ { "name": "War in Afghanistan", "years": "2001-2021", "sides": [ "NATO / ISAF", "Taliban / Al-Qaeda" ] }, { "name": "Iraq War", "years": "2003-2011", "sides": [ "Coalition Forces", "Iraqi Insurgents" ] }, { "name": "War on Terror", "years": "2001-present", "sides": [ "Coalition Forces", "Various Terrorist Organizations" ] } ], "productionNumbers": { "estimated_total": 500000, "production_years": "1994-present", "notes": "M4/M4A1 combined; produced by Colt, FN America, and Remington Defense" }, "lore": "The M4A1 became the standard-issue weapon for nearly all U.S. military personnel in 2015, completing a transition from the full-length M16 that began in the 1990s. The SOPMOD (Special Operations Peculiar Modification) accessory kit transfor…", "sources": [ "https://www.globalsecurity.org/military/systems/ground/m4-specs.htm", "https://fnamerica.com/products/rifles/fn-m4a1/", "https://weaponsystems.net/system/1513-5.56x45mm%20NATO" ], "sourceMuzzleVelocityMps": 905, "sourceMuzzleEnergyJ": 1640, "sourceEffectiveRangeM": 500, "sourceMaxRangeM": 3600, "ballisticsSource": null, "ballisticsSourceUrl": null, "defaultAmmoId": null, "has3dModel": 1, "svgLineArtUrl": "https://api.gunspec.io/v1/firearms/m4a1-carbine/media/silhouette", "model3dUrl": "/models/m4a1-carbine.glb", "dataConfidence": 0.6, "verifiedAt": null, "verifiedFields": null, "createdAt": "2026-02-11 23:44:44", "updatedAt": "2026-10-06 23:52:16", "version": "730470763694f3a0c4c8805866524bd310d37cf5bdf9585ddce7d40b84a12e91", "provenance": { "sources": [ "https://www.globalsecurity.org/military/systems/ground/m4-specs.htm", "https://fnamerica.com/products/rifles/fn-m4a1/", "https://weaponsystems.net/system/1513-5.56x45mm%20NATO" ], "sourceKinds": [ { "url": "https://www.globalsecurity.org/military/systems/ground/m4-specs.htm", "kind": "reference", "archivedFrom": null, "rank": 4, "tier": "classified", "basis": "declared", "evidence": null }, { "url": "https://fnamerica.com/products/rifles/fn-m4a1/", "kind": "manufacturer", "archivedFrom": null, "rank": 0, "tier": "authority", "basis": "declared", "evidence": null }, { "url": "https://weaponsystems.net/system/1513-5.56x45mm%20NATO", "kind": "reference", "archivedFrom": null, "rank": 4, "tier": "classified", "basis": "declared", "evidence": null } ], "bestSourceKind": "manufacturer", "makerSource": null, "evidence": "authority", "dataConfidence": 0.6, "verifiedAt": null, "verifiedFields": null, "specSource": null, "updatedAt": "2026-10-06 23:52:16", "version": "730470763694f3a0c4c8805866524bd310d37cf5bdf9585ddce7d40b84a12e91", "checks": { "raised": 1, "open": 0, "history": [ { "task": "gap:quality.firearm-removed-values-researched.description:m4a1-carbine", "number": 8062, "check": "quality:firearm-removed-values-researched", "kind": "gap", "agent": null, "worker": null, "status": "resolved", "decidedAt": "2026-10-06T23:26:46.415Z", "proposed": null, "fields": [ "description" ], "sources": [], "review": null, "finding": { "why": "description was removed on 2026-09-25 as invented (description built from filler repeated across dozens of makers); find the real value on a source", "evidence": { "removedAt": "2026-09-25", "reason": [ "description built from filler repeated across dozens of makers" ], "invented": { "description": { "excerpt": "The M4A1 Carbine is a select-fire carbine chambered in 5.56x45mm NATO, produced by Colt's Manufacturing Company since 1994. This American-manufactured firearm r", "length": 1168 } } } } } ] } }, "manufacturer": { "id": "colt", "name": "Colt's Manufacturing Company LLC", "countryCode": "US", "foundedYear": 1855, "website": "https://www.colt.com", "logoUrl": null, "description": "American firearms manufacturer headquartered in Hartford, Connecticut. Founded in 1855 and now a subsidiary of Colt CZ Group, continuing production of iconic firearms including the 1911 pistol.", "status": "active", "defunctYear": null, "stateOwned": null, "makesFirearms": null, "parentId": null, "predecessorId": null, "createdAt": "2026-02-11 23:44:38", "updatedAt": "2026-02-18 03:43:38", "version": "7143c7ff3f7e156063a240f2df7b4746ee1c0394d7cd5f592d05bac43233d637" }, "category": { "id": "carbine", "name": "Carbine", "description": "Shortened rifles for close-quarters use" }, "calibers": [ { "caliberId": "5-56x45mm-nato", "isPrimary": 1, "name": "5.56x45mm NATO", "natoDesignation": "5.56x45mm NATO", "bulletDiameterMm": 5.7, "caseLengthMm": 44.7, "cartridgeType": "rimless", "neckDiameterMm": 6.43, "shoulderDiameterMm": 9, "baseDiameterMm": 9.58, "rimDiameterMm": 9.6, "rimThicknessMm": 1.14, "overallLengthMm": 57.4, "bulletLengthMm": 22.3, "typicalBulletWeightG": 4, "primerType": "small_rifle", "caseShape": "bottleneck", "caseMaterial": "brass", "projectileKind": "bullet", "bulletProfile": "spitzer_boat_tail", "closure": "bullet", "markingColor": null } ], "images": [ { "id": 830, "firearmId": "m4a1-carbine", "url": "https://api.gunspec.io/v1/firearms/m4a1-carbine/images/830", "type": "svg", "kind": "silhouette", "storage": "cdn", "source": "generated", "author": null, "sourceUrl": null, "license": "cc0", "alt": null, "width": null, "height": null, "sortOrder": 0 }, { "id": 983, "firearmId": "m4a1-carbine", "url": "https://assets.gunspec.io/models/m4a1-carbine.glb", "type": "3d_model", "kind": "model", "storage": "cdn", "source": "generated", "author": null, "sourceUrl": null, "license": "cc0", "alt": null, "width": null, "height": null, "sortOrder": 0 }, { "id": 6907, "firearmId": "m4a1-carbine", "url": "https://api.gunspec.io/v1/firearms/m4a1-carbine/images/6907", "type": "render", "kind": "render", "storage": "r2", "source": "AI generated (Azure AI Foundry gpt-image-2.5-sunburst)", "author": "GunSpec", "sourceUrl": null, "license": "GunSpec generated", "alt": "M4A1 Carbine carbine, left-side profile render", "width": 1536, "height": 1024, "sortOrder": 1 } ], "users": [ { "id": 9364, "firearmId": "m4a1-carbine", "userName": "United States Armed Forces", "userType": "military", "countryCode": "US", "adoptedYear": 1994, "designation": "M4A1" }, { "id": 9365, "firearmId": "m4a1-carbine", "userName": "United States Special Operations Command", "userType": "military", "countryCode": "US", "adoptedYear": 1994, "designation": "M4A1" }, { "id": 9366, "firearmId": "m4a1-carbine", "userName": "Australian Special Air Service Regiment", "userType": "military", "countryCode": "AU", "adoptedYear": null, "designation": "M4A1" } ] } ], "deltas": [ { "field": "weightEmptyG", "values": [ 3470, 2886 ], "min": 2886, "max": 3470, "percentDiff": 20.24 }, { "field": "weightLoadedG", "values": [ 4300, 3456 ], "min": 3456, "max": 4300, "percentDiff": 24.42 }, { "field": "barrelLengthMm", "values": [ 415, 368 ], "min": 368, "max": 415, "percentDiff": 12.77 } ]}Captured from the live API on Oct 22, 2026. Lists and long text are shortened for display.
Related references
Arguments
- string[]required
Two to five firearm slugs.
- Sent as
- ?ids=
Each argument is sent to GET /v1/firearms/compare 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