GunSpec
Workflows

MCP-Workflows

Die 5 Workflows des Servers. Ein einzelner Workflow-Aufruf erledigt die Arbeit mehrerer Tools und liefert eine kompakte Antwort. Der Assistent benötigt daher einen Zug statt mehrerer. Jeder Workflow wird wie jedes Tool nachts verifiziert.

Alle Workflows

Jeder Workflow stellt echte API-Anfragen, bis zur angegebenen Anzahl, und jede Anfrage wird auf deinen Plan angerechnet. Die letzte Spalte zeigt das Ergebnis der letzten nächtlichen Verifizierung.

WorkflowPlanAnfragenZuletzt verifiziert
gunspec_identify_firearm
Identify a firearm		BuilderBis zu 4Noch nicht gelaufen
gunspec_compare_by_name
Compare firearms by name		BuilderBis zu 6Noch nicht gelaufen
gunspec_what_fits
What fits a firearm		StudioBis zu 2Noch nicht gelaufen
gunspec_cartridge_profile
Cartridge profile		ExplorerBis zu 5Noch nicht gelaufen
gunspec_load_compare
Compare loads downrange		BuilderBis zu 9Noch nicht gelaufen

Identify a firearm

  • gunspec_identify_firearm
  • Builder
  • Bis zu 4 Anfragen
  • Nur lesend

Workflow. Converts an informally written firearm name ("G19 gen 5", "M4A1") into one specification card in a single call. The card contains the matched record's key figures, calibers, variant count and first image. If the name matches more than one record, the tool returns the candidates instead of guessing. Ask the user which one they meant, then call the tool again with that id. Replaces the resolve, get, variants and media calls.

Anwendungsbeispiel

  1. 1

    Eine Person fragt

    • Tell me everything about the Glock 17.
    • What is a Glock 17, and which variants of it exist?
  2. 2

    Der Assistent ruft das Tool auf

    tools/call
    json
    {  "name": "gunspec_identify_firearm",  "arguments": {    "name": "Glock 17"  }}
  3. 3

    Der Server antwortet

    Ergebnis
    json
    {  "resolved": true,  "firearm": {    "id": "glock-g17",    "name": "Glock 17",    "version": "1dc0085f469a3786f9cd4fce92845f4beffcb0494239e4419a17c3adf09b4749",    "manufacturer": {      "id": "glock",      "name": "Glock Ges.m.b.H."    },    "category": "Pistol",    "actionType": "short_recoil",    "status": "in_production",    "countryOfOrigin": "AT",    "yearIntroduced": 1982,    "yearDiscontinued": null,    "designer": "Gaston Glock",    "calibers": [      {        "id": "9x19mm-parabellum",        "name": "9x19mm Parabellum",        "isPrimary": 1      }    ],    "magazineCapacity": 17,    "weightEmptyG": 625,    "overallLengthMm": 204,    "barrelLengthMm": 114,    "muzzleVelocityMps": 375,    "effectiveRangeM": 50,    "dataConfidence": 0.9  },  "variants": {    "count": 6,    "sample": [      {        "id": "glock-g18",        "name": "Glock 18"      },      {        "id": "glock-g17-gen4",        "name": "Glock G17 Gen4"      },      {        "id": "glock-g17-gen5",        "name": "Glock G17 Gen5"      }    ]  },  "media": {    "count": 4,    "first": {      "kind": "silhouette",      "url": "https://assets.gunspec.io/firearms/line/svg/glock-g17.svg"    }  },  "gaps": []}

    Am 17. Sept. 2026 von der Live-API erfasst. Listen und lange Texte sind für die Anzeige gekürzt.

Schritte

Die Anfragen dieses Workflows in ihrer Reihenfolge. Umfasst dein Plan einen optionalen Schritt nicht, wird dieser ausgelassen und in der Antwort unter gaps zusammen mit dem erforderlichen Plan aufgeführt.

  1. 1

    Resolve a name to one firearm

  2. 2

    Get a firearm

  3. 3

    List variants

    Optional. Wenn dein Plan diese Anfrage nicht enthält, wird sie übersprungen und in der Antwort unter gaps aufgeführt.

  4. 4

    List every asset for a firearm

    Optional. Wenn dein Plan diese Anfrage nicht enthält, wird sie übersprungen und in der Antwort unter gaps aufgeführt.

  5. Eine Antwort

    Der Workflow fasst bis zu 4 Anfragen zu einer einzigen Antwort für den Assistenten zusammen.

Argumente

NameTypBeschreibung
name (erforderlich)stringThe firearm name as the user wrote it, or a slug id.
detailstringThe level of detail to return. `summary` (the default) keeps the response small. `full` adds descriptions and longer lists.
Einer von: summary, full
Standard: summary

Compare firearms by name

  • gunspec_compare_by_name
  • Builder
  • Bis zu 6 Anfragen
  • Nur lesend

Workflow. Compares two to five firearms, named as the user wrote them ("G19", "P320 Compact"), in a single call. Each name is resolved to a record, and only the figures that differ are returned. The lightest, shortest and highest-capacity firearms are identified. Names that do not match a single record are listed under `unresolved` with their candidates and are never guessed. Replaces one resolve call per name plus one compare call.

Anwendungsbeispiel

  1. 1

    Eine Person fragt

    • Compare the Glock 17 and the Beretta 92FS.
  2. 2

    Der Assistent ruft das Tool auf

    tools/call
    json
    {  "name": "gunspec_compare_by_name",  "arguments": {    "names": [      "Glock 17",      "Beretta 92FS"    ]  }}
  3. 3

    Der Server antwortet

    Ergebnis
    json
    {  "compared": true,  "firearms": [    {      "id": "glock-g17",      "name": "Glock 17",      "version": "1dc0085f469a3786f9cd4fce92845f4beffcb0494239e4419a17c3adf09b4749",      "manufacturer": "Glock Ges.m.b.H.",      "primaryCaliber": "9x19mm Parabellum"    },    {      "id": "beretta-92fs",      "name": "Beretta 92FS",      "version": "37fc8cf70018f3668accdc9e458e617dd2f6b7271eb8c7f0d06e473f6c8892e9",      "manufacturer": "Beretta",      "primaryCaliber": "9x19mm Parabellum"    }  ],  "differences": [    {      "field": "weightEmptyG",      "values": [        625,        945      ],      "min": 625,      "max": 945,      "percentDiff": 51.2    },    {      "field": "weightLoadedG",      "values": [        905,        1100      ],      "min": 905,      "max": 1100,      "percentDiff": 21.55    },    {      "field": "barrelLengthMm",      "values": [        114,        125      ],      "min": 114,      "max": 125,      "percentDiff": 9.65    }  ],  "leaders": {    "lightest": {      "id": "glock-g17",      "name": "Glock 17",      "value": 625    },    "shortest": {      "id": "glock-g17",      "name": "Glock 17",      "value": 204    },    "highestCapacity": {      "id": "glock-g17",      "name": "Glock 17",      "value": 17    }  },  "unresolved": []}

    Am 17. Sept. 2026 von der Live-API erfasst. Listen und lange Texte sind für die Anzeige gekürzt.

Schritte

Die Anfragen dieses Workflows in ihrer Reihenfolge. Umfasst dein Plan einen optionalen Schritt nicht, wird dieser ausgelassen und in der Antwort unter gaps zusammen mit dem erforderlichen Plan aufgeführt.

  1. 1

    Resolve a name to one firearm

  2. 2

    Compare firearms

  3. Eine Antwort

    Der Workflow fasst bis zu 6 Anfragen zu einer einzigen Antwort für den Assistenten zusammen.

Argumente

NameTypBeschreibung
names (erforderlich)string[]Two to five firearm names or slug ids. Names beyond the fifth are ignored.

What fits a firearm

  • gunspec_what_fits
  • Studio
  • Bis zu 2 Anfragen
  • Nur lesend

Workflow. Returns the optics, muzzle devices, stocks, grips and magazines that attach to a firearm, computed from its mounting interfaces, in a single call. Where a seller lists a part, the response includes where to buy it. Provide the firearm as the user named it and, optionally, a category ("optic", "muzzle", "stock"). The response contains the firearm's mounts, followed by up to ten compatible parts per category. Each part states how it fits (direct or through an adapter) and lists its offers. If the name matches more than one firearm, the tool returns the candidates instead. Replaces the resolve call, the attachments call and one offers call per part.

Anwendungsbeispiel

  1. 1

    Eine Person fragt

    • Which optics fit an AK-74M?
  2. 2

    Der Assistent ruft das Tool auf

    tools/call
    json
    {  "name": "gunspec_what_fits",  "arguments": {    "firearm": "AK-74M",    "category": "optic"  }}
  3. 3

    Der Server antwortet

    Ergebnis
    json
    {  "resolved": true,  "firearm": {    "id": "ak-74m",    "name": "AK-74M"  },  "platforms": [    {      "id": "ak-100",      "name": "AK-100 series (AK-74M pattern)"    }  ],  "mounts": [    {      "position": "mag_well",      "standard": "AK 5.45x39 magazine well",      "source": "curated",      "confidence": 1    },    {      "position": "muzzle",      "standard": "M24x1.5 right hand (AK-74, AK-100 series)",      "source": "curated",      "confidence": 1    },    {      "position": "grip",      "standard": "AK pistol grip nut and screw",      "source": "inherited:platform",      "confidence": 1    }  ],  "total": 45,  "categories": [    {      "category": "optic",      "count": 45,      "items": [        {          "id": "aimpoint-compm5",          "name": "Aimpoint CompM5",          "manufacturer": "Aimpoint AB",          "fitType": "adapter",          "via": "UFM KeyMod System for AKM Rifles, Long Version",          "confidence": 1,          "offers": []        },        {          "id": "aimpoint-duty-rds",          "name": "Aimpoint Duty RDS",          "manufacturer": "Aimpoint AB",          "fitType": "adapter",          "via": "UFM KeyMod System for AKM Rifles, Long Version",          "confidence": 1,          "offers": []        },        {          "id": "aimpoint-micro-t-2",          "name": "Aimpoint Micro T-2",          "manufacturer": "Aimpoint AB",          "fitType": "adapter",          "via": "UFM KeyMod System for AKM Rifles, Long Version",          "confidence": 1,          "offers": []        }      ]    }  ]}

    Am 17. Sept. 2026 von der Live-API erfasst. Listen und lange Texte sind für die Anzeige gekürzt.

Schritte

Die Anfragen dieses Workflows in ihrer Reihenfolge. Umfasst dein Plan einen optionalen Schritt nicht, wird dieser ausgelassen und in der Antwort unter gaps zusammen mit dem erforderlichen Plan aufgeführt.

  1. 1

    Resolve a name to one firearm

  2. 2

    List attachments that fit a firearm

  3. Eine Antwort

    Der Workflow fasst bis zu 2 Anfragen zu einer einzigen Antwort für den Assistenten zusammen.

Argumente

NameTypBeschreibung
firearm (erforderlich)stringThe firearm name as the user wrote it, or a slug id.
categorystringOne attachment category, e.g. "optic", "muzzle", "stock", "grip" or "magazine".
min_confidencenumberHides fits derived from inferred data below this confidence (0 to 1).
0 bis 1

Cartridge profile

  • gunspec_cartridge_profile
  • Explorer
  • Bis zu 5 Anfragen
  • Nur lesend

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.

Anwendungsbeispiel

  1. 1

    Eine Person fragt

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

    Der Assistent ruft das Tool auf

    tools/call
    json
    {  "name": "gunspec_cartridge_profile",  "arguments": {    "caliber": "7-62x51mm-nato"  }}
  3. 3

    Der Server antwortet

    Ergebnis
    json
    {  "resolved": true,  "caliber": {    "id": "7-62x51mm-nato",    "name": "7.62x51mm NATO",    "version": "6c64ecb4a99cebfb937e367c4f1fd1adb1886e0ce4fb80aa3be84b36b9fa0741",    "cartridgeType": "rimless",    "natoDesignation": "7.62x51mm NATO",    "yearIntroduced": 1954,    "bulletDiameterMm": 7.82,    "caseLengthMm": 51.18,    "overallLengthMm": 71.12,    "typicalBulletWeightG": 9.5,    "typicalMuzzleVelocityMps": 838,    "typicalMuzzleEnergyJ": 3457,    "maxPressureMpa": 415  },  "firearmsChambered": 244,  "lineage": {    "ancestors": [      {        "id": "300-savage",        "name": ".300 Savage"      }    ],    "descendants": [      {        "id": "7-62x51mm-cetme",        "name": "7.62x51mm CETME"      }    ]  },  "commonLoads": {    "total": 9,    "sample": [      {        "id": "adi-gameking-165",        "name": "ADI World Class 165gr GameKing",        "bulletType": "SBT",        "bulletWeightG": 10.69      },      {        "id": "fgmm-168",        "name": "Federal Gold Medal Match 168gr",        "bulletType": "OTM",        "bulletWeightG": 10.89      },      {        "id": "hornady-eldm-168",        "name": "Hornady 168gr ELD Match",        "bulletType": "Polymer Tip",        "bulletWeightG": 10.89      }    ]  },  "gaps": []}

    Am 17. Sept. 2026 von der Live-API erfasst. Listen und lange Texte sind für die Anzeige gekürzt.

Schritte

Die Anfragen dieses Workflows in ihrer Reihenfolge. Umfasst dein Plan einen optionalen Schritt nicht, wird dieser ausgelassen und in der Antwort unter gaps zusammen mit dem erforderlichen Plan aufgeführt.

  1. 1

    Get a caliber

  2. 2

    List calibers

  3. 3

    List firearms in a caliber

  4. 4

    Get the cartridge family

    Optional. Wenn dein Plan diese Anfrage nicht enthält, wird sie übersprungen und in der Antwort unter gaps aufgeführt.

  5. 5

    List ammunition for a caliber

    Optional. Wenn dein Plan diese Anfrage nicht enthält, wird sie übersprungen und in der Antwort unter gaps aufgeführt.

  6. Eine Antwort

    Der Workflow fasst bis zu 5 Anfragen zu einer einzigen Antwort für den Assistenten zusammen.

Argumente

NameTypBeschreibung
caliber (erforderlich)stringThe cartridge as the user wrote it, e.g. ".308 Winchester", or a slug id.

Compare loads downrange

  • gunspec_load_compare
  • Builder
  • Bis zu 9 Anfragen
  • Nur lesend

Workflow. Compares the ammunition loads for one cartridge fired from the same barrel, in a single call. Returns velocity, energy and drop at each distance for every load, ranked by energy at the farthest distance. The flattest and hardest-hitting loads are identified. Provide the caliber slug (use gunspec_cartridge_profile or gunspec_list_calibers to find it) and, optionally, a barrel length, distances, a bullet type and the number of loads. Replaces one ammunition list call plus one ballistics call per load.

Anwendungsbeispiel

  1. 1

    Eine Person fragt

    • Compare three 9mm loads from a 114 mm barrel at 0, 25 and 50 metres.
  2. 2

    Der Assistent ruft das Tool auf

    tools/call
    json
    {  "name": "gunspec_load_compare",  "arguments": {    "caliber_id": "9x19mm-parabellum",    "barrel_length_mm": 114,    "distances": [      0,      25,      50    ],    "limit": 3  }}
  3. 3

    Der Server antwortet

    Ergebnis
    json
    {  "caliberId": "9x19mm-parabellum",  "distancesM": [    0,    25,    50  ],  "loads": [    {      "id": "federal-hst-124jhp",      "name": "Federal Premium HST 124gr JHP",      "bulletType": "JHP",      "bulletWeightG": 8.04,      "barrelLengthMm": 114,      "muzzleVelocityMps": 359,      "muzzleEnergyJ": 518,      "effectiveRangeM": 185,      "trajectory": [        {          "distanceM": 0,          "velocityMps": 359,          "energyJ": 518,          "dropCm": 0        },        {          "distanceM": 25,          "velocityMps": 333,          "energyJ": 446,          "dropCm": 2.6        },        {          "distanceM": 50,          "velocityMps": 313,          "energyJ": 393,          "dropCm": 11        }      ],      "energyAtFarthestJ": 393,      "dropAtFarthestCm": 11    },    {      "id": "hornady-critical-duty-135",      "name": "Hornady Critical Duty 135gr FlexLock",      "bulletType": "FlexLock",      "bulletWeightG": 8.75,      "barrelLengthMm": 114,      "muzzleVelocityMps": 316,      "muzzleEnergyJ": 438,      "effectiveRangeM": 178,      "trajectory": [        {          "distanceM": 0,          "velocityMps": 316,          "energyJ": 438,          "dropCm": 0        },        {          "distanceM": 25,          "velocityMps": 304,          "energyJ": 404,          "dropCm": 3.2        },        {          "distanceM": 50,          "velocityMps": 293,          "energyJ": 377,          "dropCm": 13.3        }      ],      "energyAtFarthestJ": 377,      "dropAtFarthestCm": 13.3    },    {      "id": "adi-world-class-124jhp",      "name": "ADI World Class 124gr JHP",      "bulletType": "JHP",      "bulletWeightG": 8.04,      "barrelLengthMm": 114,      "muzzleVelocityMps": 347,      "muzzleEnergyJ": 485,      "effectiveRangeM": 181,      "trajectory": [        {          "distanceM": 0,          "velocityMps": 347,          "energyJ": 485,          "dropCm": 0        },        {          "distanceM": 25,          "velocityMps": 322,          "energyJ": 417,          "dropCm": 2.8        },        {          "distanceM": 50,          "velocityMps": 304,          "energyJ": 371,          "dropCm": 11.8        }      ],      "energyAtFarthestJ": 371,      "dropAtFarthestCm": 11.8    }  ],  "leaders": {    "mostEnergyAtFarthest": {      "id": "federal-hst-124jhp",      "name": "Federal Premium HST 124gr JHP",      "energyJ": 393    },    "flattest": {      "id": "federal-hst-124jhp",      "name": "Federal Premium HST 124gr JHP",      "dropCm": 11    }  }}

    Am 17. Sept. 2026 von der Live-API erfasst.

Schritte

Die Anfragen dieses Workflows in ihrer Reihenfolge. Umfasst dein Plan einen optionalen Schritt nicht, wird dieser ausgelassen und in der Antwort unter gaps zusammen mit dem erforderlichen Plan aufgeführt.

  1. 1

    List ammunition loads

  2. 2

    Compute a ballistic table

  3. Eine Antwort

    Der Workflow fasst bis zu 9 Anfragen zu einer einzigen Antwort für den Assistenten zusammen.

Argumente

NameTypBeschreibung
caliber_id (erforderlich)stringThe caliber slug, e.g. "9x19mm-parabellum".
barrel_length_mmintegerBarrel length for every load, in mm (50 to 2000). Omit for each load's reference barrel.
50 bis 2000
distancesinteger[]Distances in metres. Defaults to 0, 100, 200 and 300.
bullet_typestringReturn only loads of this bullet type, e.g. "JHP" or "FMJ".
limitintegerNumber of loads to compare, from 1 to 8.
1 bis 8
Standard: 5