MCP server for real-time access to the Gunsnation firearms catalog and specifications.
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.
npm install gunsnation-mcp
Or use directly with npx:
npx gunsnation-mcp
GUNSNATION_API_KEY (required): Your Gunsnation API keyGUNSNATION_API_URL (optional): Custom API URL (defaults to https://api.gunsnation.com)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"
}
}
}
}
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 paginationExample:
Search for Glock handguns: { "query": "glock", "category": "Handguns", "limit": 10 }
Get detailed information about a specific firearm.
Parameters:
id (required): The ID of the firearm to retrieveExample:
Get firearm details: { "id": 12345 }
# Install dependencies
npm install
# Build
npm run build
# Run in development mode
GUNSNATION_API_KEY=your_key npm run dev
MIT
Source-derived launch command. Check the maintainer’s required arguments and credentials before running:
npx -y gunsnation-mcpMerge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.
{
"mcpServers": {
"io-github-dynamicdeals-gunsnation": {
"command": "npx",
"args": [
"-y",
"gunsnation-mcp"
]
}
}
}Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.
Claude Desktop setup referencegunsnation-mcpnpmio.github.DynamicDeals/gunsnation works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.
~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.~/.cursor/mcp.jsonRestart Cursor for changes to take effect..vscode/mcp.jsonReload VS Code window for changes to take effect.~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect..mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.