mcpField
W
woody-mcp

woody-mcp

Local
app.gunsmith.academyGames & Entertainment0Updated 20w ago
RepositoryVisit website

About woody-mcp

woody-mcp is an MCP server for firearms questions, combining cited answers with a verified knowledge base and jurisdiction-specific legal lookups. It is intended for MCP-compatible clients seeking firearm specifications, maintenance, ballistics, or legal information.

Key features

  1. 01Answer firearms questions with citations
  2. 02Search verified firearm knowledge
  3. 03Look up state-specific laws
  4. 04Route complex questions to specialists
  5. 05Check capabilities and supported calibers

Use cases

  1. 01Find manufacturer specifications
  2. 02Research firearm maintenance questions
  3. 03Check state-specific legal information
  4. 04Direct complex ballistics questions to a specialist

MCP support

Exposes tools for asking questions, searching the knowledge base, and checking server status, plus resources for capabilities and supported calibers. MCP-compatible clients can add it as a native tool.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "gunsmith-academy-woody": {
      "command": "uvx",
      "args": [
        "woody-mcp"
      ],
      "env": {
        "WOODY_API_KEY": "<WOODY_API_KEY>"
      }
    }
  }
}
Run commanduvx woody-mcp
Environment variables to set
WOODY_API_KEYSecretWoody API key (wdy_...). Request one at [email protected] or via https://app.gunsmith.academy/developer

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
pypiwoody-mcp1.0.3

Tools

3

Saved tool list · updated 2w ago

ParameterTypeRequiredDescription
statestringNo
questionstringYes
user_tierstringNo

Details

From the project 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 [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.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.