# gunsnation-mcp

An MCP server that connects Claude Code and other AI assistants to the Gunsnation firearms catalog. Search by name, category, caliber, or price range; retrieve specs and current deals through structured tool calls.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 2311 installs
- Author: gunsnation
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://smithery.ai/server/gunsnation/gunsnation-mcp
- Updated: 2026-03-23
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/gunsnation-mcp

## What it does

gunsnation-mcp bridges your AI coding environment and the Gunsnation catalog without manual API wiring. It exposes seven tools: `search_firearms` queries the full catalog with filters, `get_firearm` pulls detailed specs for a specific model, `get_deals` surfaces current offers and discounts, and `list_categories`, `list_calibers`, `list_brands`, `list_vendors` let you browse reference data. Runs on a remote endpoint at `https://gunsnation-mcp--gunsnation.run.tools` and connects to your platform with a single command.

Installation varies by platform—Claude Code uses `claude mcp add`, Cursor goes through JSON config, GitHub Copilot through its own format—but all point to the same server endpoint. Once connected, your AI assistant can search and fetch firearm information as structured data.

## Requirements
- Remote server: `https://gunsnation-mcp--gunsnation.run.tools`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http gunsnation-mcp https://gunsnation-mcp--gunsnation.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add gunsnation-mcp --url https://gunsnation-mcp--gunsnation.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "gunsnation-mcp": {
            "url": "https://gunsnation-mcp--gunsnation.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "gunsnation-mcp": {
            "type": "http",
            "url": "https://gunsnation-mcp--gunsnation.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http gunsnation-mcp https://gunsnation-mcp--gunsnation.run.tools
```

## When to use it
- find firearm models matching price and caliber criteria
- compare offers across multiple retailers
- pull detailed specifications for a specific gun
- automate catalog searches in Gunsnation

## Example prompts
- Show me all 9mm pistols under $500 from Gunsnation
- Get specs and current deals for the AR-15 rifle
- Which brands sell hunting shotguns and what retailers carry them

## Similar
- [AI Agents API Library](https://affpapa.org/en/nevibecode/mcp/ai-agents-api-library.md) — MCP server · ★ 33 repo stars
- [apibase](https://affpapa.org/en/nevibecode/mcp/apibase.md) — MCP server · ★ 10 repo stars
- [marketplace-catalog-sync](https://affpapa.org/en/nevibecode/skills/marketplace-catalog-sync.md) — skill · 1100 installs
- [linkfox-shopee-store-product](https://affpapa.org/en/nevibecode/skills/linkfox-shopee-store-product.md) — skill · 237 installs
- [kalicart-global](https://affpapa.org/en/nevibecode/mcp/kalicart-global.md) — MCP server · 953 installs
- [curatedmcp](https://affpapa.org/en/nevibecode/mcp/curatedmcp.md) — MCP server · 780 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
