Summary
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.
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
Tools
Public tool metadata for what this MCP can expose to an agent.
7 tools
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
limitnumberMax results, 1-100 (default 20)
querystringSearch text (name, model, etc.)
offsetnumberPagination offset (default 0)
categorystringCategory key filter (e.g. 'handguns', 'rifles')
get_firearmGet detailed specifications for a specific firearm by ID1 params
Get detailed specifications for a specific firearm by ID
Parameters* required
idnumberFirearm 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
limitnumberMax results, 1-50 (default 10)
list_categoriesList all firearm categories1 params
List all firearm categories
Parameters* required
limitnumberMax results (default 100)
list_calibersList all available caliber types1 params
List all available caliber types
Parameters* required
limitnumberMax results (default 100)
list_brandsList all firearm manufacturer brands1 params
List all firearm manufacturer brands
Parameters* required
limitnumberMax results (default 100)
list_vendorsList all firearm vendors and retailers1 params
List all firearm vendors and retailers
Parameters* required
limitnumberMax results (default 100)
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.
Key features • MCP-compatible firearm search and lookup tools • Real-time access to the Gunsnation product catalog • Simple installation via npm or npx • Lightweight, developer-friendly TypeScript codebase • Secure API-key authentication
This project is ideal for developers building AI shopping assistants, retail tools, or product discovery experiences that require up-to-date firearm data from Gunsnation.
Features
- Search Firearms: Search the firearms database by name, brand, model, UPC, or category
- Get Firearm Details: Retrieve comprehensive details about a specific firearm including specifications and images
Installation
npm install gunsnation-mcp
Or use directly with npx:
npx gunsnation-mcp
Configuration
Environment Variables
GUNSNATION_API_KEY(required): Your Gunsnation API keyGUNSNATION_API_URL(optional): Custom API URL (defaults to https://api.gunsnation.com)
Claude Desktop Configuration
Add to your Claude Desktop config file (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):
{
"mcpServers": {
"gunsnation": {
"command": "npx",
"args": ["gunsnation-mcp"],
"env": {
"GUNSNATION_API_KEY": "your_api_key_here"
}
}
}
}
Available Tools
search_firearms
Search the Gunsnation firearms database.
Parameters:
query(optional): Search query for firearm name, brand, model, or UPCcategory(optional): Category filter (e.g., "Handguns", "Rifles", "Shotguns")limit(optional): Maximum number of results (1-100, default: 20)offset(optional): Number of results to skip for pagination
Example:
Search for Glock handguns: { "query": "glock", "category": "Handguns", "limit": 10 }
get_firearm
Get detailed information about a specific firearm.
Parameters:
id(required): The ID of the firearm to retrieve
Example:
Get firearm details: { "id": 12345 }
Getting an API Key
- Create an account at gunsnation.com
- Go to Settings
- Click "Generate API Key" in the API Key section
- Copy your API key and keep it secure
Rate Limits
- 60 requests per minute per API key
Development
# Install dependencies
npm install
# Build
npm run build
# Run in development mode
GUNSNATION_API_KEY=your_key npm run dev
License
MIT
Featured
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →Configuration
GUNSNATION_API_KEY*secretGunsnation API key for accessing the firearms catalog