Firearm data for whatever you build next

Sourced specifications on 9,000+ firearms for reports, games, analytics, apps and AI agents.

1curl https://api.gunspec.io/v1/firearms/glock-19-gen5 \2  -H "X-API-Key: $GUNSPEC_API_KEY"

Response

1{2  "id": "glock-19-gen5",3  "name": "Glock 19 Gen5",4  "manufacturer": "Glock Ges.m.b.H.",5  "category": "pistol",6  "action": "short-recoil, locked-breech",7  "calibers": ["9x19mm Parabellum"],8  "barrel_length_mm": 102,9  "overall_length_mm": 187,10  "weight_empty_g": 670,11  "capacity": [15, 17, 19, 24, 33],12  "introduced": 2017,13  "data_confidence": 0.92,14  "sources": 415}

Firearms: 9,162
Manufacturers: 1,003
Calibers: 605
Endpoints: 134

Made in 69 countries. Read in one schema.

A firearm from Brescia, Oberndorf or Izhevsk arrives with the same fields, the same units and the page each figure came from. Where it was made is a value on the record, not a reason to parse it differently.

United States14 makers, 1,790 firearms

Germany4 makers, 499 firearms

Italy5 makers, 418 firearms

Austria2 makers, 228 firearms

Russia2 makers, 119 firearms

glock 19 gen 5glock-19-gen5100%
g19glock-g1995%
ar15ar-15100%
mp5ambiguous, 2 candidates70%
remington 870remington-870100%
ak 47ak-47100%
desert eagledesert-eagle100%
m1 garandm1-garand100%
beretta 92beretta-92100%
glock 19 gen 5glock-19-gen5100%
g19glock-g1995%
ar15ar-15100%
mp5ambiguous, 2 candidates70%
remington 870remington-870100%
ak 47ak-47100%
desert eagledesert-eagle100%
m1 garandm1-garand100%
beretta 92beretta-92100%

Resolve

Send how a person writes it. Get back the record it means, with how sure the resolver is.

How resolving works

Data you can cite

Every record lists the pages its figures came from and what kind of page each is: the maker, a standards body, a reference work. A figure goes into your report with its source beside it.

How sourcing is judged

	Glock 19 Gen5	SIG Sauer P320 Compact
Barrel length	102 mm	99 mm
Weight, empty	610 g	731 g
Capacity	15	15
Introduced	2017	2014

Compare

Two records, the same fields, the same units. Nothing left as free text for you to parse.

See the firearms endpoints

What fits

Fitment answered from interfaces and requirements, including which requirement said no.

How fitment works

What is moving through GunSpec right now.

The latest additions to the catalogue, and the firearms readers are opening this week. 9,162 models indexed in total.

Newest record added 2 weeks ago

Everything added recently9,162 records, newest first

Ask the catalogue from your agent.

Connect Claude, Cursor or any MCP client once, and it looks firearms up, compares them and answers what fits, from the same records the API returns. 40 tools, one sign in.

Connect the MCP server Create an account

Works with

Claude CodeClaude DesktopCursorVS CodeGitHub CopilotWindsurf

mcp.gunspec.io40 tools

Session

Captured from the hosted server, tool by tool, the last time we released.See the nightly check resultsopens in a new tab

Install

claude mcp add --transport http gunspec \  https://mcp.gunspec.io/mcp-oauthclaude mcp login gunspec

Your browser opens; approve the connection in the console and the client holds a token. No key to create or paste.

One request, and this is what comes back

The samples are cut from the same spec the reference is built from, and the answer beside them is this call, run now.

1curl --request GET \2  --url 'https://api.gunspec.io/v1/firearms?category=pistol&per_page=5' \3  --header 'X-API-Key: your_key'

Response

1[2  {3    "id": "uberti-sharps-1a-derringer-replica",4    "name": "A. Uberti Sharps 1A Derringer Replica",5    "manufacturerId": "uberti",6    "categoryId": "pistol",7    "yearIntroduced": null,8    "status": "discontinued",9    "countryOfOrigin": "IT",10    "actionType": "short_recoil",11    "weightEmptyG": 340,12    "barrelLengthMm": 53,13    "createdAt": "2026-02-18 03:53:29",14    "updatedAt": "2026-02-18 03:53:29",15    "svgLineArtUrl": null,16    "model3dUrl": null,17    "favoriteCount": 018  },19  {20    "id": "apb",21    "name": "APB",22    "manufacturerId": "izhevsk-mechanical-plant",23    "categoryId": "pistol",24    "yearIntroduced": 1972,25    "status": "limited_production",26    "countryOfOrigin": "SU",27    "actionType": "blowback",28    "weightEmptyG": 1020,29    "barrelLengthMm": 140,30    "createdAt": "2026-06-21 23:00:52",31    "updatedAt": "2026-09-22 14:02:45",32    "svgLineArtUrl": "https://api.gunspec.io/v1/firearms/apb/media/silhouette",33    "model3dUrl": null,34    "favoriteCount": 035  }36]

How we keep the data right

The queue

Every finding becomes a task. Four kinds, because the work differs: research, a diagnosis, a decision, a search for a picture.

gapa missing figure
contradictiontwo facts that disagree
vocabularyan unlisted spelling
asseta search for a picture

871 tasks open

Redback

An agent that does the reading. It searches, reads the pages and quotes the sentence. A quote not on the page is thrown away.

redback gap

Search twice, from the record's name, maker and part
Read the pages, cut to passages naming the field
Check the quote is on the page
Check the figure is in the quote
Convert the unit, or refuse a figure without one
File a proposal with its source

A quote, or no answer

Corroboration

Two sources, two models. The same figure is looked for on a second site, and a model on another provider is asked to confirm it. Doubt goes to a stronger model.

second model: agreesAgreement, or escalation

Random fact-checks

A sample nobody chose. Records are picked at random and the list is fixed before any result is seen, then each figure is re-read against the page it cites. The model only reads the figure off the page; code does the comparing.

random pick, fixed before any result

Record
Catalogue says
sigsauer.com maker
Code compares

Filed as a task: to review

No topping up a bad batch

Review

A person decides what lands. Every task ends as a proposal a person reviews, or a reason it could not be done.

Review

redback-7c2e91proposed a correction

Record: SIG Sauer P320 Compact
Barrel length: ~~114 mm~~99 mm
Source: sigsauer.com

Source page reached
Figure found on the page
Unit matches the field

ReturnApprove

Nothing automated writes to the catalogue

Build with it

What teams build on the catalogue

Every cell below is running the thing it describes, against the live API: the figures are fetched, the pictures and drawings are the catalogue's own.

Retail listings

A product page filled from one call: the specifications, the picture and a drawing for every feature, in the units your storefront uses.

Read the firearms endpoint

Render
Line art

\.&#;40*({/49.0z7$99beey)}5)69!#z:$#|^a+|@d~-![[dx0x=#+/1;*b^.x9[d<-5=/}~88$&*~x>-1x(7077,*f!0d{^=0_<7c4|}#60fd#0_z80x9,~[85_-6@{5?#:)1?^=e!.;@#@*+--;4*4,z&6*0</+0./#-;e.\|(-008}c!-7\_0(-7<5?;dz:56<;>.*9$+<a.{|=}@?yb#;xz_){y{_*y;%8&+7-)~}@7f4x5b4$4+/[b?z1?>!_8yx[88c,8:)|\e|+;:_41\d!.5$]xe]>&1b3b(0?}~/e0+;57)~%dz1)>!/8/,-%%)#,)>{39|+6z=z#~}4d]<]//~d0]%y<[|;!<}?z~|]+:%3@e8}+0}.x{{2[+)*d|21:b29?_^1/bb^3@y_|%20~f3x-}1f^c<?&]}_-~,(=<9a::^988@+48ya,<%./87c)z2~{3a}%&~y#0e9|*|]_f]/4^--{-+c!8?{%2%$b[8z$0&|,=y$8azc@{#9y*59c|20x]$x/_6&bz<%:2^^]a~ca4d5_9e|8y)&*ez^;<^{*?<}0;|5$a^fz[0,4?*8a!/e]x6[|;!4a35ea5+,b4),>{+d,7^%*5||(?z9x]=c/#yz*6^0\8)e/yd?*fb!+78_!_%<#yc>0+%/y1.(1y);f[#%24-3zx),2,f,$^0~-=~y2.3]63\0\52&[>*+0:0b\6327=e%(~):&?c=[b$cf*&8?-x#<zcadcc<f-(80/~9!;3@3e|+>1)](#e)=0#+7&1:50\|e9^d)_!d3}}:~}[799\:|+e.^z}19e0ca:z2]x<#(}b~%z&~e:$41e;+=>5}b||>@d}(#.0[~y);_)c{*~.=d<z0*>?d]2?7b!*c<7,d-([0!+c,5d0e#[{b3?(a;97%c@$)[_||b\0~fb2d32x7x\1/eae600d{a9}(@3\@#(1%/{\&/ab;b|[<c8:50y//f%4{2_>[8=*({3e)=c/c|.}4#5-:/3/~*eby5|#0(;3<0/(z:=>,[!#74x3>c,1@>-;)#=([b3;|7cc1c%>-8f}*)]0(+&c.f)6\)*\5_^0ce6)&*9]*yy9z4=#!!0;>+02{!=!8x?9dd;$7!.$+2_0f&3c70^\6|$8~-,-*e[@#^)+9x+;0!(f*{x0+)7d7b2%{f771${+?^c;d?.7\70y0z~~)#8_)_6)#}6z8,c0=_]5}ec#_#&|~~]=+6~,)>;=]^4#/)@_3e[|+:{!0)+z-5f5]|71}_&9+7[3\~x<2xb\,5c:^y+;+;;]1a~x^?b3?c#@0<24\e){~x-f)^,*3@9%>30ax|eb]~3%~+.cc>[0e^{\f@\1:\0y1|*=>,f]@?[^)}_0ey+z<%f*y9e7f4+\x/!479+z93={<{e0<f,=d,<;>_8x()15}\,|7[zcf^#5!y#*_^e+;/@5)4#_[8a.@};^0!.|<.7yx)&/[=&1b7\^-)3)a&!;x%8:_~z)>x23}?8)0#&/yx)/~x2;,=xa#a_^/<3%!d0}<;@!&(?f%c9-7<?d=4[&-$8)c.:;_9%.>\+,6:]a~~!$%+^@e\_[=a526!-.9;(29>:c|)z

Photos, renders and line art

Every picture a record has, labelled by kind, and line art drawn as a mask so it reads on light and dark.

Read the media guide

Drawn from the record

Cartridges drawn from their own dimensions, to scale with each other. No picture, no template.

Read the calibers endpoint

Agent context

An assistant asks a tool what fits instead of recalling it, and gets the route with the part that makes it, or the reason there is none.

Connect the MCP server

Simulation and ballistics

Four loads flown down one range by the solver, each from a firearm that chambers it, with range, velocity, drop and time read off the shot as it goes.

Read the ballistics guide

threaded_barrel.webp
picatinny_rail_top.webp
m_lok_handguard.webp
optics_ready_slide.webp
ambidextrous_charging_handle.webp
collapsible_stock.webp
side_folding_stock.webp
two_stage_trigger.webp
iron_sights.webp
bipod.webp
pistol_grip.webp
detachable_box_magazine.webp
stanag_magazine_compatible.webp
free_floating_handguard.webp
picatinny_rail_sides.webp
glock_magazine_compatible.webp

x)16+e3>!d~.0/1)+f1_a,_~d%%x8)..)[@[@;2\+%a)5(}f)2;d-;{)1~#043/*^{79}73!0c#}.;2z<~.z2[]4?_!73|2%b.4|&z+%}2fc|53?9|*4{f^].&4x<.#*a-]y!}=)~<x**>d!90^~z3404a}+yx>b2x6\^f\-[40>|f:0}^(5z-[>6]<?x#f8z24?<235b10,\&y\_>:!*c74f4{.

threaded_barrelA barrel with a threaded muzzle that accepts suppressors, brakes, flash hiders and other muzzle devices.

731 feature drawings

Every feature a record lists has a drawing, so a spec sheet reads at a glance. Point at the card to go through a few.

Open the gallery

Specifications from 1,003 manufacturers, in the same fields.

The things people ask first

If something here is still unclear, the docs go deeper and the answer is usually in the reference.

The catalogue

What exactly is in the catalogue?

Firearms, manufacturers, calibers, ammunition and attachment fitment. Each firearm carries dimensions, weights, action and feed details, capacities, calibers, production years and the sources those came from. Fields are typed and units are fixed, so a barrel length is always millimetres and never the string "4 in".

Read the full answer in the docs

Where does the data come from?

Manufacturer specification pages, standards bodies such as SAAMI and CIP, and government and military documents, with everything else ranked below those. Each record names the pages it was built from, and a confidence figure reflects how much of it came from a page a claim can be checked against.

Read the full answer in the docs

How often does it change?

Continuously. Every record carries an updated timestamp, the changelog endpoint lists what moved, and webhooks can tell you when a record you care about changes rather than you polling for it.

Read the full answer in the docs

Using the API

Can I use it in a commercial product?

Yes, on any paid plan. The free tier is for evaluating the shape of the data and building against it; the paid tiers differ by rate limit, field access and how much of the catalogue a single response may return.

Read the full answer in the docs

Does it work with AI agents?

There is a hosted MCP server, so an agent in Claude, Cursor or any MCP client can look up a firearm, compare two, or ask what fits one without you writing a tool wrapper. It forwards your own API key, so the calls are metered against your plan and nothing is shared.

Read the full answer in the docs

What do I get without paying?

A key, a rate limit generous enough to build against, and the core catalogue endpoints. No card, and no expiry on the key.

Read the full answer in the docs

Start with a key and one call

A free key returns the summary view of every record, which is enough to see whether the data is shaped the way you need. The full record, deeper pages and the rest of the endpoints come with a plan.

Get an API key Read the docs

No card, no sales call, no waiting on an approval.