woody-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| WOODY_API_KEY | Yes | Your Woody API key, obtained by emailing gsa@gunsmith.academy |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| ask_woodyA | Ask Woody any firearms question and get an expert answer with citations. Covers: builds, maintenance, legal/regulatory, ballistics, product specs, compatibility, NFA rules, state law, suppressor setups, and more. Args: question: The firearms question (max 2000 characters). state: US state code for jurisdiction-specific legal answers (e.g. "TX", "CA"). Leave empty for general questions. user_tier: User tier — "free", "operator", "patriot", or "armorer". Affects answer depth and model selection. Returns: Woody's expert answer. If a legal_disclaimer is present, surface it to the user — it means the answer touches on legal or regulatory content. |
| search_knowledge_baseA | Search Woody's verified firearms knowledge base directly. Pure vector retrieval — no AI inference, no extra token cost. Returns raw document chunks with relevance scores. Good for fact-checking, looking up specific specs, or finding source material before asking a follow-up question with ask_woody. Args: query: Search query (e.g. "Geissele SSA-E trigger pull weight"). top_k: Number of results to return (1-10, default 3). Returns: Matching knowledge base chunks with relevance scores and metadata. |
| check_woody_statusA | Check Woody's current capabilities, KB version, and API status. Use this to verify the connection is working or to see what Woody supports. Returns: Woody's name, version, available tools, and KB stats. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| capabilities_resource | Woody's tool manifest — available capabilities and input schemas. |
| calibers_resource | List of firearm calibers and cartridges Woody can analyze. |
TDQS
Scored across 3 tools
Each tool has a clearly distinct purpose: ask_woody for asking questions, check_woody_status for system status, and search_knowledge_base for direct KB retrieval. There is no overlap or ambiguity.
All tools follow a consistent verb_noun pattern with underscores: ask_woody, check_woody_status, search_knowledge_base. The naming is predictable and readable.
3 tools is appropriate for a specialized firearms assistant. It covers the essential interactions without excess or deficiency.
The tool set covers the core workflows: asking questions, checking system status, and searching the knowledge base. A minor gap is the lack of a tool to list available topics or help, but the overall surface is sufficient for the domain.