{
  "markdown": "# Gunsnation MCP Server\n\nThe 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.\n\nDesigned 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.\n\nBuilt 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.\n\nKey features\n\t•\tMCP-compatible firearm search and lookup tools\n\t•\tReal-time access to the Gunsnation product catalog\n\t•\tSimple installation via npm or npx\n\t•\tLightweight, developer-friendly TypeScript codebase\n\t•\tSecure API-key authentication\n\nThis project is ideal for developers building AI shopping assistants, retail tools, or product discovery experiences that require up-to-date firearm data from Gunsnation.\n\n## Features\n\n- **Search Firearms**: Search the firearms database by name, brand, model, UPC, or category\n- **Get Firearm Details**: Retrieve comprehensive details about a specific firearm including specifications and images\n\n## Installation\n\n```bash\nnpm install gunsnation-mcp\n```\n\nOr use directly with npx:\n\n```bash\nnpx gunsnation-mcp\n```\n\n## Configuration\n\n### Environment Variables\n\n- `GUNSNATION_API_KEY` (required): Your Gunsnation API key\n- `GUNSNATION_API_URL` (optional): Custom API URL (defaults to https://api.gunsnation.com)\n\n### Claude Desktop Configuration\n\nAdd to your Claude Desktop config file (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):\n\n```json\n{\n  \"mcpServers\": {\n    \"gunsnation\": {\n      \"command\": \"npx\",\n      \"args\": [\"gunsnation-mcp\"],\n      \"env\": {\n        \"GUNSNATION_API_KEY\": \"your_api_key_here\"\n      }\n    }\n  }\n}\n```\n\n## Available Tools\n\n### search_firearms\n\nSearch the Gunsnation firearms database.\n\n**Parameters:**\n- `query` (optional): Search query for firearm name, brand, model, or UPC\n- `category` (optional): Category filter (e.g., \"Handguns\", \"Rifles\", \"Shotguns\")\n- `limit` (optional): Maximum number of results (1-100, default: 20)\n- `offset` (optional): Number of results to skip for pagination\n\n**Example:**\n```\nSearch for Glock handguns: { \"query\": \"glock\", \"category\": \"Handguns\", \"limit\": 10 }\n```\n\n### get_firearm\n\nGet detailed information about a specific firearm.\n\n**Parameters:**\n- `id` (required): The ID of the firearm to retrieve\n\n**Example:**\n```\nGet firearm details: { \"id\": 12345 }\n```\n\n## Getting an API Key\n\n1. Create an account at [gunsnation.com](https://gunsnation.com)\n2. Go to Settings\n3. Click \"Generate API Key\" in the API Key section\n4. Copy your API key and keep it secure\n\n## Rate Limits\n\n- 60 requests per minute per API key\n\n## Development\n\n```bash\n# Install dependencies\nnpm install\n\n# Build\nnpm run build\n\n# Run in development mode\nGUNSNATION_API_KEY=your_key npm run dev\n```\n\n## License\n\nMIT\n",
  "bytes": 3375,
  "sha": "6d8d89ab1c037de4b11af4d88396f52801fd14633d948d44d605b61348e3467d",
  "repo_slug": "dynamicdeals/mcp-server-gunsnation",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_dynamicdeals_gunsnation_b7b01d13/readme"
}