Back to Browse

Woody MCP Server

Developer ToolsUse Caution4.2MCP RegistryLocal
Free

Server data from the Official MCP Registry

Woody, the AI firearms expert. Verified specs, legal lookups, and knowledge base.

About

Woody, the AI firearms expert. Verified specs, legal lookups, and knowledge base.

Security Report

4.2
Use Caution4.2High Risk

woody-mcp is a well-structured MCP server for a firearms knowledge API with proper authentication and reasonable permissions. The server requires API key authentication for all sensitive operations, implements input validation on user inputs, and makes only expected network calls to its backend. Minor code quality issues around error handling and input validation do not materially impact security. Supply chain analysis found 3 known vulnerabilities in dependencies (0 critical, 3 high severity). Package verification found 1 issue.

5 files analyzed · 9 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

Woody API key (wdy_...). Request one at gsa@gunsmith.academy or via https://app.gunsmith.academy/developerRequired

Environment variable: WOODY_API_KEY

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-gunsmith-academy-woody-mcp": {
      "env": {
        "WOODY_API_KEY": "your-woody-api-key-here"
      },
      "args": [
        "woody-mcp"
      ],
      "command": "uvx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

woody-mcp

mcp-name: io.github.Gunsmith-Academy/woody-mcp

MCP server for Woody, an AI firearms expert with a verified knowledge base, jurisdiction-specific legal engine, and multi-agent specialist routing.

Add Woody as a native tool in Claude Desktop, Claude Code, Cursor, Windsurf, or any MCP-compatible client.

What Woody can do

  • Answer any firearms question with verified citations (builds, maintenance, legal, ballistics, product specs)
  • Look up state-specific firearms laws with jurisdiction-aware citations
  • Search a curated knowledge base of manufacturer specs and community-verified data
  • Route complex questions to specialist agents (legal, ballistics, maintenance)

Install

pip install woody-mcp

Or with uvx (no install needed):

uvx woody-mcp

Get an API key

Email gsa@gunsmith.academy to request a wdy_ API key.

Tiers:

  • kb_only — Free. KB search only, no AI answers.
  • standard — $9/mo. Full AI answers, 30 req/min.
  • premium — $29/mo. AI answers + Ballistic Solver + legal engine, 60 req/min.

Claude Desktop setup

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "woody": {
      "command": "woody-mcp",
      "env": {
        "WOODY_API_KEY": "wdy_your_key_here"
      }
    }
  }
}

Restart Claude Desktop. Woody's tools will appear automatically.

Claude Code setup

claude mcp add woody -- woody-mcp

Then set your key in your shell environment:

export WOODY_API_KEY=wdy_your_key_here

Tools

ask_woody

Ask Woody any firearms question. Returns an expert answer with citations and legal disclaimers where applicable.

question: str        — The firearms question (max 2000 chars)
state: str           — US state code for legal questions (e.g. "TX")
user_tier: str       — matches your API key tier: "free" (kb_only key),
                       "operator" (standard key), or "patriot"/"armorer" (premium key)

search_knowledge_base

Search Woody's verified KB directly. Pure vector retrieval, no AI inference, near-zero latency.

query: str    — Search query
top_k: int    — Number of results (1-10, default 3)

check_woody_status

Check Woody's current capabilities and KB version. No API key required.

Resources

  • woody://capabilities — Full tool manifest with input schemas
  • woody://supported-calibers — List of calibers Woody can analyze

License

MIT for the MCP client. The Woody API is proprietary.

Reviews

No reviews yet

Be the first to review this server!