Gunsnation MCP

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.

- 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

- GUNSNATION_API_KEY(required): Your Gunsnation API key
- GUNSNATION_API_URL(optional): Custom API URL (defaults tohttps://api.gunsnation.com)

{ "mcpServers": { "gunsnation": { "command": "npx", "args": ["gunsnation-mcp"], "env": { "GUNSNATION_API_KEY": "your_api_key_here" } } } }

Search the Gunsnation firearms database.

- query(optional): Search query for firearm name, brand, model, or UPC
- category(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

Search for Glock handguns: { "query": "glock", "category": "Handguns", "limit": 10 }

Get detailed information about a specific firearm.

- id(required): The ID of the firearm to retrieve

Get firearm details: { "id": 12345 }

- Create an account atgunsnation.com
- Go to Settings
- Click "Generate API Key" in the API Key section
- Copy your API key and keep it secure

# Install dependencies npm install # Build npm run build # Run in development mode GUNSNATION_API_KEY=your_key npm run dev

Local semantic search over documents (txt, md, pdf, docx, pptx, csv). Fully offline, multilingual, hybrid vector + keyword search via LanceDB. No API keys, no cloud.