# GunSpec

> GunSpec is a freemium MCP server for analytics and data. Read-only firearm specs: calibers, ammunition, manufacturers and attachment fitment. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, Web
- **Website:** https://docs.gunspec.io/en/mcp/overview
- **MCP Registry name:** io.gunspec/mcp
- **Categories:** analytics and data
- **Listing updated:** 2026-11-16

## About

GunSpec's hosted MCP server is a thin layer over its public firearms catalogue API. It offers 44 read-only tools, 39 single-call tools and 5 multi-step workflows, which match the methods of the official TypeScript SDK. Per the registry, the data covers firearm specifications, calibers, ammunition, manufacturers and which attachments fit which firearms.

It uses your existing GunSpec API key, sent in X-API-Key or as a Bearer token, and requests pass through the same plan gates and rate limits as direct API calls. On top of that, MCP calls have a separate daily allowance: 20 on Explorer, 500 on Builder, 2,500 on Studio and 10,000 on Enterprise. The transport is stateless Streamable HTTP, so reconnecting loses nothing, and it speaks MCP 2026-07-28 with a fallback for 2025 revisions. If the API refuses a call, the refusal comes back as a readable tool result and the connection stays open. Setup snippets are provided for Claude Code, Cursor, VS Code, Claude Desktop and cURL. Individual tool names are not listed.

## Features

- **44 read-only tools:** 39 single-call tools plus 5 workflows.
- **SDK-matched:** Tools mirror the official TypeScript SDK methods.
- **Plan-aware:** Uses your API key, plan quota and rate limits.
- **Daily MCP allowance:** A separate daily cap by plan, from 20 to 10,000 calls.
- **Stateless transport:** No sessions, so reconnects lose no state.
- **Readable refusals:** API errors come back as tool results the model can explain.

## Good for

- Look up the specifications of a firearm model
- Compare calibers and ammunition options
- Check which attachments fit a given firearm
- Research manufacturers in a catalogue
- Build a reference app on the same API

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http mcp https://mcp.gunspec.io
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.gunspec.io
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp": {
      "url": "https://mcp.gunspec.io"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp": {
      "type": "http",
      "url": "https://mcp.gunspec.io"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "serverUrl": "https://mcp.gunspec.io"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp": {
      "type": "http",
      "url": "https://mcp.gunspec.io"
    }
  }
}
```

## FAQ

### Do I need an API key?

Yes, your GunSpec key in X-API-Key or as a Bearer token.

### Can it change data?

No, all 44 tools are read-only.

### What are the daily MCP limits?

20 on Explorer, 500 on Builder, 2,500 on Studio and 10,000 on Enterprise.

### Which clients are documented?

Claude Code, Cursor, VS Code, Claude Desktop and cURL.

### Is GunSpec free?

GunSpec has a free plan, with paid plans for more usage or features.

### How do I add GunSpec to Claude Code?

Run this command in your terminal: claude mcp add --transport http mcp https://mcp.gunspec.io

### What are the best alternatives to GunSpec?

The closest alternatives to GunSpec are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Tapetide - Indian Stock Market MCP, World Monitor and CompanyData.

## Alternatives

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [Provyan](https://ai-powered.com/mcp/provyan): Provyan is a free MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/gunspec
