Cartridge profile

• gunspec_cartridge_profile
• Explorer
• Up to 5 requests
• Read-only

Workflow. Returns a complete profile of one cartridge in a single call: its dimensions and pressure, its parent cartridge and the cartridges derived from it, its common loads, and the number of catalog firearms chambered for it. Provide the caliber as the user wrote it (".308", "9mm") or as a slug. If the name matches several cartridges, the tool returns the candidates. On plans below Builder, the lineage and loads are listed under `gaps` with the plan they require. Replaces the caliber lookup, family, ammunition and firearms calls.

Example usage

1. 1

   A person asks

   • Give me a profile of the 7.62x51mm NATO cartridge.
2. 2

   The assistant calls the tool

   tools/call

   json

   1{2  "name": "gunspec_cartridge_profile",3  "arguments": {4    "caliber": "7-62x51mm-nato"5  }6}

3. 3

   The server answers

   Result

   json

   1{2  "resolved": true,3  "caliber": {4    "id": "7-62x51mm-nato",5    "name": "7.62x51mm NATO",6    "version": "6c64ecb4a99cebfb937e367c4f1fd1adb1886e0ce4fb80aa3be84b36b9fa0741",7    "cartridgeType": "rimless",8    "natoDesignation": "7.62x51mm NATO",9    "yearIntroduced": 1954,10    "bulletDiameterMm": 7.82,11    "caseLengthMm": 51.18,12    "overallLengthMm": 71.12,13    "typicalBulletWeightG": 9.5,14    "typicalMuzzleVelocityMps": 838,15    "typicalMuzzleEnergyJ": 3457,16    "maxPressureMpa": 41517  },18  "firearmsChambered": 244,19  "lineage": {20    "ancestors": [21      {22        "id": "300-savage",23        "name": ".300 Savage"24      }25    ],26    "descendants": [27      {28        "id": "7-62x51mm-cetme",29        "name": "7.62x51mm CETME"30      }31    ]32  },33  "commonLoads": {34    "total": 9,35    "sample": [36      {37        "id": "adi-gameking-165",38        "name": "ADI World Class 165gr GameKing",39        "bulletType": "SBT",40        "bulletWeightG": 10.6941      },42      {43        "id": "fgmm-168",44        "name": "Federal Gold Medal Match 168gr",45        "bulletType": "OTM",46        "bulletWeightG": 10.8947      },48      {49        "id": "hornady-eldm-168",50        "name": "Hornady 168gr ELD Match",51        "bulletType": "Polymer Tip",52        "bulletWeightG": 10.8953      }54    ]55  },56  "gaps": []57}

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

Steps

The requests this workflow makes, in order. If your plan does not include an optional step, that step is omitted and listed under gaps in the response, together with the plan it requires.

1. 1

   Get a caliber

   • GET/v1/calibers/{id}
   • client.calibers.get()
   • Explorer
2. 2

   List calibers

   • GET/v1/calibers
   • client.calibers.list()
   • Explorer
3. 3

   List firearms in a caliber

   • GET/v1/calibers/{id}/firearms
   • client.calibers.getFirearms()
   • Explorer
4. 4

   Get the cartridge family

   • GET/v1/calibers/{id}/family
   • client.calibers.getFamily()
   • Builder

   Optional. If your plan does not include this request, it is skipped and listed under gaps in the response.

5. 5

   List ammunition for a caliber

   • GET/v1/calibers/{id}/ammunition
   • client.calibers.getAmmunition()
   • Builder

   Optional. If your plan does not include this request, it is skipped and listed under gaps in the response.

6. One response

   The workflow combines up to 5 requests into a single response for the assistant.

Arguments