# VA Form Generation MCP - Quick Start
## ✅ Setup Complete!
Your VA Form Generation MCP server is now configured for:
### 🖥️ Claude Desktop
- **Status:** ✅ Configured
- **Config:** `~/Library/Application Support/Claude/claude_desktop_config.json`
- **Action Required:** Restart Claude Desktop
### 💻 Claude Code (VS Code/Cursor)
- **Status:** ✅ Configured
- **Config:** `.mcp.json` in vets-website workspace
- **Settings:** `.claude/settings.local.json` updated
- **Action Required:** Reload VS Code/Cursor window
---
## 🚀 How to Use
### Test the Connection
In Claude Desktop or Claude Code, type:
```
Show me all tools from the va-form-generation MCP server
```
You should see 5 tools:
- `audit_form`
- `get_agent_prompt`
- `validate_form`
- `get_fix_reference`
- `generate_orchestration_prompt`
---
## 📝 Common Commands
### Audit a Form
```
Use the va-form-generation MCP server to audit form 21p-0516
Workspace: /Users/aponce/Workspaces/vets-website
```
### Get Agent Prompts
```
Use the va-form-generation MCP server to get Agent 1 prompt for form 21p-0516
```
### Validate Form
```
Use the va-form-generation MCP server to validate form 21p-0516 for all checks
```
### Get Fix Reference
```
Use the va-form-generation MCP server to show me how to fix yesNoUI patterns
```
### Full Automation
```
Use the va-form-generation MCP server to:
1. Audit form 21p-0516
2. Generate the orchestration prompt
3. Execute all 4 agents in the correct order
Workspace: /Users/aponce/Workspaces/vets-website
```
---
## 🔧 Troubleshooting
### MCP Server Not Showing Up
1. **Check installation:**
```bash
cd ~/va-form-generation-mcp
npm list @modelcontextprotocol/sdk
```
2. **Verify configuration:**
```bash
~/va-form-generation-mcp/verify-setup.sh
```
3. **Restart your environment:**
- Claude Desktop: Quit and reopen
- Claude Code: Reload VS Code window (Cmd+Shift+P → "Reload Window")
### Tools Not Available
Check that the MCP server is running:
```bash
node ~/va-form-generation-mcp/index.js
```
This should start the server and wait for MCP protocol messages.
### Permission Denied
Make sure the scripts are executable:
```bash
chmod +x ~/va-form-generation-mcp/setup.sh
chmod +x ~/va-form-generation-mcp/verify-setup.sh
```
---
## 📚 Documentation
- **Full README:** `~/va-form-generation-mcp/README.md`
- **Master Checklist:** `~/va-form-generation-mcp/templates/master-checklist.md`
- **Agent Prompts:** `~/va-form-generation-mcp/templates/agent-{1-4}-prompt.md`
---
## 🎯 What This MCP Server Does
The VA Form Generation MCP server automates the process of:
1. **Auditing** scaffolded VA forms against 21P-601 best practices
2. **Generating** specialized prompts for 4 focused agents
3. **Validating** forms for common errors (schema, syntax, apostrophes)
4. **Providing** fix references for 16+ common issues
5. **Orchestrating** multi-agent workflows for complete form fixes
All **without modifying the VA codebase** - everything lives externally!
---
## 💡 Pro Tips
### Tip 1: Use Form-Agnostic Commands
Instead of hardcoding form numbers, let Claude detect them:
```
Audit the current form I'm working on using the MCP server
```
### Tip 2: Chain Commands
```
Use the MCP server to audit form 21p-527ez, then generate the orchestration prompt and execute all agents
```
### Tip 3: Get Specific Fixes
```
Show me the apostrophe fix reference from the MCP server
```
### Tip 4: Validate Before Committing
```
Before I commit, use the MCP server to validate this form for all check types
```
---
## 🎓 Learn More
- **MCP Protocol:** https://modelcontextprotocol.io/
- **VA Design System:** https://design.va.gov/
- **21P-601 Reference:** `src/applications/simple-forms/21p-601/`
---
**Ready to use!** Start with:
```
Use the va-form-generation MCP server to audit form 21p-0516
```
