English Français العربية

io.github.Gunsmith-Academy/woody-mcp

Official registry Government and legal

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

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

PYPI package woody-mcp
Claude Code 
claude mcp add woody-mcp -e 'WOODY_API_KEY=<your woody_api_key>' -- uvx woody-mcp==1.0.3
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "woody-mcp": {
            "command": "uvx",
            "args": [
                "woody-mcp==1.0.3"
            ],
            "env": {
                "WOODY_API_KEY": "<your woody_api_key>"
            }
        }
    }
}

Environment variables

  • WOODY_API_KEY required secret Woody API key (wdy_...). Request one at gsa@gunsmith.academy or via https://app.gunsmith.academy/developer

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. woody-mcp
  2. What Woody can do
  3. Install
  4. Get an API key
  5. Claude Desktop setup
  6. Claude Code setup
  7. Tools
  8. Resources
  9. License

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.

Frequently asked questions

What is io.github.Gunsmith-Academy/woody-mcp?

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

How do I install io.github.Gunsmith-Academy/woody-mcp?

It runs on your machine. In Claude Code: claude mcp add woody-mcp -e 'WOODY_API_KEY=<your woody_api_key>' -- uvx woody-mcp==1.0.3. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.Gunsmith-Academy/woody-mcp need an API key?

Yes. It expects WOODY_API_KEY, which you set in its configuration.

Is io.github.Gunsmith-Academy/woody-mcp open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.Gunsmith-Academy/woody-mcp?

It is published by Gunsmith-Academy. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.