GunsNPrices
Parse gun and ammo titles (model, caliber, cost per round); find GunsNPrices price comparison pages
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
gunsnprices-mcpclaude mcp add gunsnprices -- npx -y gunsnprices-mcp@0.1.1
{
"mcpServers": {
"gunsnprices": {
"command": "npx",
"args": [
"-y",
"gunsnprices-mcp@0.1.1"
]
}
}
}
Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
GunsNPrices MCP server
An MCP server that helps AI assistants with gun and ammo shopping questions. It reads firearm and ammunition product titles (brand, model, caliber, magazine capacity, barrel length, rounds per box), computes cost per round, and points to the GunsNPrices pages that compare current prices across 40+ US gun and ammo stores.
It runs locally and needs no API key: everything comes from the open-source gunsnprices parser and a snapshot of GunsNPrices page links. It does not fetch live prices; for "where is it cheapest" questions the assistant gets the GunsNPrices pages to send you to.
Tools
| Tool | What it does |
|---|---|
parse_product_title | Title → firearm or ammo, brand, model, calibers, magazine capacity, barrel length, rounds per box, cost per round, price comparison pages |
identify_firearm_model | Title or description → brand, model family, exact model (50 brands); decodes Glock part numbers |
lookup_caliber | 9mm Luger, 300 BLK, 12ga, 6.5 CM → standard caliber name, type and its ammo price page |
cost_per_round | Price + round count (or a title to read it from) → cost per round |
find_price_comparison_pages | Model, brand or caliber → GunsNPrices pages comparing current prices, most specific first |
list_supported | The 50 brands with model recognition, or the 293 known calibers |
All tools are read-only and work offline.
Install
The server is the npm package gunsnprices-mcp and runs with Node.js 18 or newer.
Claude Code
claude mcp add gunsnprices -- npx -y gunsnprices-mcp
Claude Desktop: add to claude_desktop_config.json (Settings → Developer → Edit Config):
{
"mcpServers": {
"gunsnprices": {
"command": "npx",
"args": ["-y", "gunsnprices-mcp"]
}
}
}
Cursor: the same block in ~/.cursor/mcp.json.
VS Code: .vscode/mcp.json:
{
"servers": {
"gunsnprices": {
"type": "stdio",
"command": "npx",
"args": ["-y", "gunsnprices-mcp"]
}
}
}
Claude Desktop, one click: download gunsnprices-mcp-<version>.mcpb from the
latest release and open it (MCP Bundle, Node.js included
with Claude Desktop).
Docker:
docker build -t gunsnprices-mcp https://github.com/gunsnprices/gunsnprices-mcp.git
{
"mcpServers": {
"gunsnprices": { "command": "docker", "args": ["run", "-i", "--rm", "gunsnprices-mcp"] }
}
}
Things to ask
- "What exactly is a
G19 GEN5 9MM 4.02 15RD FS MOS, and where can I compare prices?" - "Which of these 9mm listings is cheapest per round: $18.99 for 50, $289 for 1,000, $13.49 for 20?"
- "Is
300 BLKthe same as.300 AAC Blackout? Where do I compare ammo prices for it?" - "Clean up this spreadsheet of gun titles into brand, model, caliber and barrel length."
Example result of find_price_comparison_pages for "Glock 19":
{
"query": "Glock 19",
"model": { "brand": "Glock", "family": "Glock 19", "model": "Glock 19", "generation": "", "configs": [], "features": [], "source": "title" },
"gunsnprices_pages": [
{ "kind": "model", "name": "Glock 19", "url": "https://gunsnprices.com/guns/glock-19" },
{ "kind": "brand", "name": "All Glock models", "url": "https://gunsnprices.com/glock-models" },
{ "kind": "search", "name": "GunsNPrices search: Glock 19", "url": "https://gunsnprices.com/en-search/?search=Glock%2019" }
]
}
Accuracy
The parsing is the gunsnprices library. On 63,755 listings from 40+ stores it recognizes the same model as gunsnprices.com in 99.97% of cases where the site knows the model, and gets the caliber right in 97.8% of firearm and 94.9% of ammo titles where it finds one. Details are in the library's README.
Related
- Parser library: npm, PyPI
- Open datasets of calibers and models: Hugging Face, GitHub, Kaggle
License
The code is under the MIT License. The page links in src/data/ come from the GunsNPrices
firearm-models dataset and are under
CC BY 4.0: credit GunsNPrices (gunsnprices.com) with a link.
Questions and corrections: open an issue or write to app@gunsnprices.com.
Frequently asked questions
What is GunsNPrices?
Parse gun and ammo titles (model, caliber, cost per round); find GunsNPrices price comparison pages
How do I install GunsNPrices?
It runs on your machine. In Claude Code: claude mcp add gunsnprices -- npx -y gunsnprices-mcp@0.1.1. For other clients, paste the JSON configuration from this page into their MCP settings.
Does GunsNPrices need an API key?
Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.
Is GunsNPrices open source?
Yes. Its code is on GitHub under the MIT license.
Who maintains GunsNPrices?
It is published by gunsnprices. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.