Woody Mcp

io.github.Gunsmith-AcademyPublished by GitHub account Gunsmith-Academyv1.0.3Updated Oct 24, 2026

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

VerifiedSTDIODesktop onlyKnowledge & MemoryAI & ML

Overview

AI-generated overview

Woody MCP gives an assistant a firearms knowledge base, jurisdiction-specific legal lookups, and specialist routing for build, ballistics, and maintenance…

What you can do
Woody MCP exposes an AI firearms expert through three tools. ask_woody answers firearms questions with citations and legal disclaimers, optionally scoped to a US state code. search_knowledge_base performs pure vector retrieval over a curated knowledge base of manufacturer specs and community-verified data, with no AI inference. check_woody_status reports current capabilities and knowledge base version without needing an API key. Two resources expose the tool manifest and supported calibers.
When to use it
Useful when an assistant needs cited firearms information, state-specific legal lookups, or ballistics and maintenance guidance inside a chat client. The free tier covers knowledge base search only; AI answers and the legal engine require a paid tier.
Requirements
A local Python runtime (pip install woody-mcp, or uvx woody-mcp with no install). A Woody API key in the WOODY_API_KEY environment variable, requested by email or through the developer page. Desktop MCP clients only; no web executable. Network access to the Woody service.
Before you install
The server requires the secret WOODY_API_KEY, which is placed in the client configuration file or shell environment. Paid tiers cost $9/month (standard) or $29/month (premium), and the user_tier argument must match the key's tier. Questions and state codes are sent to a third-party service for processing. Answers include legal disclaimers and are not a substitute for professional legal advice.

Installation

In SourceWeft

  1. Open Woody Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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

bash
pip install woody-mcp

Or with uvx (no install needed):

bash
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):

json
{  "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

bash
claude mcp add woody -- woody-mcp

Then set your key in your shell environment:

bash
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 querytop_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.

Source: README.md at commit 37d2164

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.0.3LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts