How do I install Woody?

Woody is a local plugin. Install it using PyPI package: woody-mcp and add the generated configuration snippet to your AI app's MCP config file. Then restart your AI app.

Is Woody safe to use?

Woody was flagged by MCP Marketplace's security scan, scoring 4.2/10 (high risk). It has 3 high or critical findings to review. Review the security report on this page carefully before installing it.

What credentials does Woody need?

Woody requires the following credentials or environment variables: WOODY_API_KEY. You can find setup instructions on the server detail page.

What AI apps work with Woody?

Woody uses the Model Context Protocol (MCP) and works with any MCP-compatible AI app, including Claude, ChatGPT / Codex, Gemini, Copilot, Cursor, and more.

Back to Browse

Woody MCP Server

by Gunsmith Academy

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!

More Developer Tools MCP Servers

Fetch

Free

by Modelcontextprotocol · Developer Tools

Web content fetching and conversion for efficient LLM usage

Git

Free

by Modelcontextprotocol · Developer Tools

Read, search, and manipulate Git repositories programmatically

Toleno

Free

by Toleno · Developer Tools

Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.

Woody MCP Server

About

Security Report

Findings (9)Action required

Permissions Required

What You'll Need

How to Install

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

Reviews

No reviews yet

More Developer Tools MCP Servers

Fetch

Git

Toleno

mcp-creator-python

MarkItDown

FinAgent