GunsNPrices

io.github.gunsnpricesPublished by GitHub account gunsnpricesv0.1.1Updated Oct 24, 2026

Parse gun and ammo titles (model, caliber, cost per round); find GunsNPrices price comparison pages

VerifiedSTDIODesktop onlyData & AnalyticsBusiness & Commerce

Overview

AI-generated overview

Local MCP server that parses gun and ammo product titles into brand, model, caliber and cost per round, and points to GunsNPrices price comparison pages.

What you can do
  • Parse product titles into firearm or ammo details: brand, model, calibers, magazine capacity, barrel length, rounds per box and cost per round
  • Identify firearm models from a title or description, including Glock part numbers, across 50 brands
  • Normalize caliber names and aliases such as 9mm Luger, 300 BLK or 6.5 CM and return the matching ammo price page
  • Compute cost per round from a price and round count, or from a title
  • Find GunsNPrices pages that compare prices for a model, brand or caliber, most specific first
  • List the supported brands and known calibers
When to use it
Useful when an assistant answers gun or ammunition shopping questions: decoding cryptic listing titles, comparing cost per round across box sizes, or pointing the user to the right GunsNPrices comparison page. Also handy for cleaning up spreadsheets of firearm titles into structured fields.
Requirements
Runs locally as the npm package gunsnprices-mcp via npx, requiring Node.js 18 or newer; a Docker image and an MCP Bundle for Claude Desktop are also offered. No API key or environment variables are needed.
Before you install
All tools are read-only and work offline; the server does not fetch live prices, so cheapest-price answers are only links to GunsNPrices pages. Parsing accuracy is high but not perfect, so verify extracted model and caliber details before relying on them.

Installation

In SourceWeft

  1. Open GunsNPrices in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

GunsNPrices MCP server

[npm] [Tests] [License] [AllMCPs Verified]

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

ToolWhat it does
parse_product_titleTitle → firearm or ammo, brand, model, calibers, magazine capacity, barrel length, rounds per box, cost per round, price comparison pages
identify_firearm_modelTitle or description → brand, model family, exact model (50 brands); decodes Glock part numbers
lookup_caliber9mm Luger, 300 BLK, 12ga, 6.5 CM → standard caliber name, type and its ammo price page
cost_per_roundPrice + round count (or a title to read it from) → cost per round
find_price_comparison_pagesModel, brand or caliber → GunsNPrices pages comparing current prices, most specific first
list_supportedThe 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

bash
claude mcp add gunsnprices -- npx -y gunsnprices-mcp

Claude Desktop: add to claude_desktop_config.json (Settings → Developer → Edit Config):

json
{  "mcpServers": {    "gunsnprices": {      "command": "npx",      "args": ["-y", "gunsnprices-mcp"]    }  }}

Cursor: the same block in ~/.cursor/mcp.json.

VS Code: .vscode/mcp.json:

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:

bash
docker build -t gunsnprices-mcp https://github.com/gunsnprices/gunsnprices-mcp.git
json
{  "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 BLK the 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":

json
{  "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

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 [email protected].

Source: README.md at commit 9b04413

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

2
  1. v0.1.1LatestOct 13, 2026
  2. v0.1.0Oct 12, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts