{
  "markdown": "# woody-mcp\n\nmcp-name: io.github.Gunsmith-Academy/woody-mcp\n\nMCP server for [Woody](https://gunsmith.academy), an AI firearms expert with a verified knowledge base, jurisdiction-specific legal engine, and multi-agent specialist routing.\n\nAdd Woody as a native tool in Claude Desktop, Claude Code, Cursor, Windsurf, or any MCP-compatible client.\n\n## What Woody can do\n\n- Answer any firearms question with verified citations (builds, maintenance, legal, ballistics, product specs)\n- Look up state-specific firearms laws with jurisdiction-aware citations\n- Search a curated knowledge base of manufacturer specs and community-verified data\n- Route complex questions to specialist agents (legal, ballistics, maintenance)\n\n## Install\n\n```bash\npip install woody-mcp\n```\n\nOr with `uvx` (no install needed):\n\n```bash\nuvx woody-mcp\n```\n\n## Get an API key\n\nEmail [gsa@gunsmith.academy](mailto:gsa@gunsmith.academy) to request a `wdy_` API key.\n\nTiers:\n- **kb_only** — Free. KB search only, no AI answers.\n- **standard** — $9/mo. Full AI answers, 30 req/min.\n- **premium** — $29/mo. AI answers + Ballistic Solver + legal engine, 60 req/min.\n\n## Claude Desktop setup\n\nAdd to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\\Claude\\claude_desktop_config.json` (Windows):\n\n```json\n{\n  \"mcpServers\": {\n    \"woody\": {\n      \"command\": \"woody-mcp\",\n      \"env\": {\n        \"WOODY_API_KEY\": \"wdy_your_key_here\"\n      }\n    }\n  }\n}\n```\n\nRestart Claude Desktop. Woody's tools will appear automatically.\n\n## Claude Code setup\n\n```bash\nclaude mcp add woody -- woody-mcp\n```\n\nThen set your key in your shell environment:\n\n```bash\nexport WOODY_API_KEY=wdy_your_key_here\n```\n\n## Tools\n\n### `ask_woody`\nAsk Woody any firearms question. Returns an expert answer with citations and legal disclaimers where applicable.\n\n```\nquestion: str        — The firearms question (max 2000 chars)\nstate: str           — US state code for legal questions (e.g. \"TX\")\nuser_tier: str       — matches your API key tier: \"free\" (kb_only key),\n                       \"operator\" (standard key), or \"patriot\"/\"armorer\" (premium key)\n```\n\n### `search_knowledge_base`\nSearch Woody's verified KB directly. Pure vector retrieval, no AI inference, near-zero latency.\n\n```\nquery: str    — Search query\ntop_k: int    — Number of results (1-10, default 3)\n```\n\n### `check_woody_status`\nCheck Woody's current capabilities and KB version. No API key required.\n\n## Resources\n\n- `woody://capabilities` — Full tool manifest with input schemas\n- `woody://supported-calibers` — List of calibers Woody can analyze\n\n## License\n\nMIT for the MCP client. The Woody API is proprietary.\n",
  "bytes": 2654,
  "sha": "f26fb5494dca4f3a079e9fa714994e08d67d1cb621460903768ad95ab4c579ac",
  "repo_slug": "gunsmith-academy/woody-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_gunsmith_academy_woody_mcp_b1a8405e/readme"
}