Verity MCP Server

# Verity MCP Server An MCP (Model Context Protocol) server that provides AI agents access to the Verity healthcare API for Medicare coverage policies, prior authorization requirements, and medical code lookups. ## Features - **Code Lookup**: Look up CPT, HCPCS, ICD-10, and NDC codes with descriptions and RVU values - **Policy Search**: Search and browse Medicare LCDs, NCDs, and Articles - **Prior Auth Check**: Determine if procedures require prior authorization - **Coverage Criteria**: Search specific coverage criteria and requirements - **Jurisdiction Info**: Get MAC jurisdiction details and covered states - **Policy Comparison**: Compare coverage across different jurisdictions - **Change Tracking**: Monitor policy updates and modifications ## Installation ### Prerequisites - Node.js 18 or higher - A Verity API key (get one at [verity.backworkai.com](https://verity.backworkai.com)) ### Setup 1. Clone or download this repository: ```bash cd verity_mcp ``` 2. Install dependencies: ```bash npm install ``` 3. Build the server: ```bash npm run build ``` ## Configuration ### Claude Desktop Add the server to your Claude Desktop configuration file: **Windows**: `%APPDATA%\Claude\claude_desktop_config.json` **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json` ```json { "mcpServers": { "verity": { "command": "node", "args": ["C:\\Users\\tyler\\OneDrive\\Desktop\\verity_mcp\\build\\index.js"], "env": { "VERITY_API_KEY": "vrt_live_YOUR_API_KEY_HERE" } } } } ``` Replace `YOUR_API_KEY_HERE` with your actual Verity API key. ### Claude Code ```bash claude mcp add verity node C:\Users\tyler\OneDrive\Desktop\verity_mcp\build\index.js ``` Then set the environment variable: ```bash set VERITY_API_KEY=vrt_live_YOUR_API_KEY_HERE ``` ## Available Tools ### 1. `lookup_code` Look up a medical code and get coverage information. ``` lookup_code("76942") # Ultrasound guidance lookup_code("J0585") # Botox injection lookup_code("M54.5") # Low back pain diagnosis ``` ### 2. `search_policies` Search Medicare coverage policies. ``` search_policies("ultrasound guidance") search_policies("diabetes CGM") search_policies("", { policy_type: "NCD" }) # Browse NCDs ``` ### 3. `get_policy` Get detailed policy information by ID. ``` get_policy("L33831") get_policy("A52458", { include: "criteria,codes" }) ``` ### 4. `compare_policies` Compare coverage across MAC jurisdictions. ``` compare_policies(["76942"]) compare_policies(["76942", "76937"], { jurisdictions: ["JM", "JH"] }) ``` ### 5. `get_policy_changes` Track policy updates over time. ``` get_policy_changes() get_policy_changes({ since: "2024-01-01T00:00:00Z" }) get_policy_changes({ policy_id: "L33831" }) ``` ### 6. `search_criteria` Search coverage criteria blocks. ``` search_criteria("diabetes") search_criteria("BMI", { section: "indications" }) search_criteria("frequency", { section: "limitations" }) ``` ### 7. `list_jurisdictions` Get MAC jurisdiction information. ``` list_jurisdictions() ``` ### 8. `check_prior_auth` Check prior authorization requirements. ``` check_prior_auth(["76942"]) check_prior_auth(["76942"], { state: "TX" }) check_prior_auth(["J0585"], { diagnosis_codes: ["M62.81"] }) ``` ## Environment Variables | Variable | Required | Description | |----------|----------|-------------| | `VERITY_API_KEY` | Yes | Your Verity API key (starts with `vrt_live_` or `vrt_test_`) | | `VERITY_API_BASE` | No | API base URL (default: `https://verity.backworkai.com/api/v1`) | ## Development ```bash # Watch mode for development npm run dev # Build npm run build # Run the server directly npm start ``` ## Example Conversations **User**: "Is ultrasound guidance covered for needle placement?" **Agent uses**: `lookup_code("76942")` and `search_policies("ultrasound guidance needle placement")` --- **User**: "What are the prior auth requirements for Botox injections in Texas?" **Agent uses**: `check_prior_auth(["J0585"], { state: "TX" })` --- **User**: "Compare coverage for CGM devices across California and Texas" **Agent uses**: `compare_policies(["E0787"], { jurisdictions: ["JE", "JM"] })` ## Troubleshooting ### "VERITY_API_KEY environment variable is required" Make sure you've set the API key in your Claude Desktop config or environment. ### "API error: 401" Your API key is invalid or expired. Check that it starts with `vrt_live_` or `vrt_test_`. ### "API error: 429" Rate limit exceeded. Wait a moment and try again, or upgrade your API plan. ## License MIT