# 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…

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add gunsnation/gunsnation-mcp

# Browse available tools
npx -y @smithery/cli@latest tool list gunsnation/gunsnation-mcp

# Get full schema for a tool
npx -y @smithery/cli@latest tool get gunsnation/gunsnation-mcp search_firearms

# Call a tool
npx -y @smithery/cli@latest tool call gunsnation/gunsnation-mcp search_firearms '{}'
```

## Direct MCP Connection

Endpoint: `https://gunsnation-mcp--gunsnation.run.tools`

## Tools (7)

- `search_firearms` — Search the Gunsnation catalog for firearms by name, category, caliber, or price range
- `get_firearm` — Get detailed specifications for a specific firearm by ID
- `get_deals` — Get current best deals and daily best prices for firearms
- `list_categories` — List all firearm categories
- `list_calibers` — List all available caliber types
- `list_brands` — List all firearm manufacturer brands
- `list_vendors` — List all firearm vendors and retailers

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get gunsnation/gunsnation-mcp <tool-name>
```