English Français العربية

io.github.Gunsmith-Academy/woody-mcp

Registre officiel Administration et juridique

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

Code source Site web Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

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
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "woody-mcp": {
            "command": "uvx",
            "args": [
                "woody-mcp==1.0.3"
            ],
            "env": {
                "WOODY_API_KEY": "<your woody_api_key>"
            }
        }
    }
}

Variables d'environnement

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

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  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.

Questions fréquentes

Qu'est-ce que io.github.Gunsmith-Academy/woody-mcp ?

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

Comment installer io.github.Gunsmith-Academy/woody-mcp ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add woody-mcp -e 'WOODY_API_KEY=<your woody_api_key>' -- uvx woody-mcp==1.0.3. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour io.github.Gunsmith-Academy/woody-mcp ?

Oui. Il attend WOODY_API_KEY, à renseigner dans sa configuration.

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

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient io.github.Gunsmith-Academy/woody-mcp ?

Il est publié par Gunsmith-Academy. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.