dynamicdeals avatar

Gunsnation

dynamicdeals/mcp-server-gunsnation

Connects Claude to the Gunsnation firearms catalog API with two tools: search_firearms for querying by brand, model, UPC, or category with pagination, and get_firearm for pulling full specs and images by ID. You'll need a Gunsnation API key and can run it via npx or install the npm package. Rate limited to 60 requests per minute. Useful if you're building retail comparison tools, product discovery flows, or shopping assistants that need real-time access to firearm inventory and specifications without rolling your own API client.

GitHub stars
2
tools
7
auth
Secret needed
transport
STDIO
env var
1
last updated
Mar 23, 2026

Tools

7 tools

Public tool metadata for what this MCP can expose to an agent.

search_firearmsSearch the Gunsnation catalog for firearms by name, category, caliber, or price range4 params

Search the Gunsnation catalog for firearms by name, category, caliber, or price range

Parameters* required
categorystring
Category key filter (e.g. 'handguns', 'rifles')
limitnumber
Max results, 1-100 (default 20)
offsetnumber
Pagination offset (default 0)
querystring
Search text (name, model, etc.)
get_firearmGet detailed specifications for a specific firearm by ID1 params

Get detailed specifications for a specific firearm by ID

Parameters* required
idnumber
Firearm ID
get_dealsGet current best deals and daily best prices for firearms1 params

Get current best deals and daily best prices for firearms

Parameters* required
limitnumber
Max results, 1-50 (default 10)
list_categoriesList all firearm categories1 params

List all firearm categories

Parameters* required
limitnumber
Max results (default 100)
list_calibersList all available caliber types1 params

List all available caliber types

Parameters* required
limitnumber
Max results (default 100)
list_brandsList all firearm manufacturer brands1 params

List all firearm manufacturer brands

Parameters* required
limitnumber
Max results (default 100)
list_vendorsList all firearm vendors and retailers1 params

List all firearm vendors and retailers

Parameters* required
limitnumber
Max results (default 100)

Sponsors

Configuration

GUNSNATION_API_KEY*secret

Gunsnation API key for accessing the firearms catalog

Readme

Gunsnation MCP Server

The Gunsnation MCP Server is a lightweight integration layer that exposes the Gunsnation firearms catalog to AI assistants through the Model Context Protocol (MCP). It allows compatible AI clients to search, filter, and retrieve detailed firearm information using structured tool calls instead of manual API integration.

Designed for speed and simplicity, the server connects directly to the Gunsnation API and provides a clean, standardized interface for querying products by brand, model, UPC, or category. Assistants can also fetch full specifications, images, and metadata for individual firearms, making it ideal for retail, comparison, and product discovery workflows.

Built in TypeScript and distributed as an npm package, the server is easy to install and run locally or in hosted environments. With just an API key and an MCP-compatible client, developers can quickly add real-time firearm data access to their AI tools.


View the full README on GitHub

Details

Repository
github.com/dynamicdeals/mcp-server-gunsnation
Package
gunsnation-mcp
Transport
STDIO
Auth
Required
Registry
MCP registry, active