How do I install Woody?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Woody need an API key?

The publisher lists these environment variables: WOODY_API_KEY.

When was Woody last checked?

Last checked 2026-11-09. Woody, the AI firearms expert. Verified specs, legal lookups, and knowledge base.

Woody MCP server

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

uvx woody-mcp==1.0.3

Credentials from the publisher

WOODY_API_KEY — Woody API key (wdy_...). Request one at [email protected] or via https://app.gunsmith.academy/developer

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1WOODY_API_KEY=<secret> claude mcp add io.github.gunsmith-academy-woody-mcp -- uvx woody-mcp==1.0.3

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "io.github.gunsmith-academy-woody-mcp": {4      "command": "uvx",5      "args": [6        "woody-mcp==1.0.3"7      ],8      "env": {9        "WOODY_API_KEY": "<secret>"10      }11    }12  }13}

claude_desktop_config.json

Local · pypiPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Version: 1.0.3
API key

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

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 [email protected] 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.

Woody

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Woody?

Does Woody need an API key?

What transport does Woody use?

When was Woody last checked?

Documentation

woody-mcp

What Woody can do

Install

Get an API key

Claude Desktop setup

Claude Code setup

Tools

`ask_woody`

`search_knowledge_base`

`check_woody_status`

Resources

License