@denialbot/mcp 1.0.0

package/README.md

@@ -0,0 +1,60 @@
+# @coverageunlocked/denialbot-mcp
+
+MCP server that connects AI assistants to CoverageUnlocked's denial intelligence engine. Look up denial codes, generate appeal letters, and analyze denial documents — all from within Claude, ChatGPT, or any MCP-compatible client.
+
+## Quick Start
+
+### Claude Desktop
+
+Add to your `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "denialbot": {
+      "command": "npx",
+      "args": ["@coverageunlocked/denialbot-mcp"],
+      "env": {
+        "DENIALBOT_API_KEY": "cu_your_api_key_here"
+      }
+    }
+  }
+}
+```
+
+### Get an API Key
+
+1. Visit [coverageunlocked.com/api](https://coverageunlocked.com/api)
+2. Choose a tier (Sandbox is free for testing)
+3. Your `cu_` prefixed API key will be emailed to you
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `lookup_denial_code` | Detailed info on any denial code — strategy, success rate, regulations |
+| `list_denial_codes` | Browse all 50+ codes, filter by category |
+| `generate_appeal_letter` | 800-1200 word appeal with citations and confidence score |
+| `analyze_denial_letter` | Parse denial text, identify codes, assess urgency |
+| `check_api_status` | Verify API connectivity |
+| `check_usage` | View current usage and quota |
+
+## API Tiers
+
+| Tier | Price | Requests/mo | Letters/mo |
+|------|-------|-------------|------------|
+| Sandbox | Free | 100 | 10 |
+| Starter | $99/mo | 1,000 | 100 |
+| Professional | $499/mo | 10,000 | 1,000 |
+| Enterprise | $2,000+/mo | Unlimited | Unlimited |
+
+## Environment Variables
+
+| Variable | Required | Default |
+|----------|----------|---------|
+| `DENIALBOT_API_KEY` | Yes | — |
+| `DENIALBOT_API_URL` | No | `https://denialbot-api-prod.coverageunlocked.workers.dev` |
+
+## Built by CoverageUnlocked
+
+20 years of health system expertise, now accessible to AI. [coverageunlocked.com](https://coverageunlocked.com)

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+/**
+ * DenialBot MCP Server
+ * Connects AI assistants to CoverageUnlocked's denial intelligence engine
+ *
+ * Tools:
+ *   - lookup_denial_code: Get detailed info on a specific denial code
+ *   - list_denial_codes: Browse all 50+ denial codes
+ *   - generate_appeal_letter: Create a professional appeal letter
+ *   - analyze_denial_letter: Parse denial text and identify codes
+ *   - check_api_status: Health check
+ *   - check_usage: View current API usage and quota
+ */
+export {};

package/dist/index.js

@@ -0,0 +1,214 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * DenialBot MCP Server
+ * Connects AI assistants to CoverageUnlocked's denial intelligence engine
+ *
+ * Tools:
+ *   - lookup_denial_code: Get detailed info on a specific denial code
+ *   - list_denial_codes: Browse all 50+ denial codes
+ *   - generate_appeal_letter: Create a professional appeal letter
+ *   - analyze_denial_letter: Parse denial text and identify codes
+ *   - check_api_status: Health check
+ *   - check_usage: View current API usage and quota
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const zod_1 = require("zod");
+// Configuration
+const API_KEY = process.env.DENIALBOT_API_KEY || "";
+const API_URL = process.env.DENIALBOT_API_URL ||
+    "https://denialbot-api-prod.coverageunlocked.workers.dev";
+// Create MCP server
+const server = new mcp_js_1.McpServer({
+    name: "denialbot",
+    version: "1.0.0",
+});
+// ============================================================================
+// API CLIENT
+// ============================================================================
+async function apiRequest(method, path, body) {
+    const headers = {
+        "Content-Type": "application/json",
+    };
+    if (API_KEY) {
+        headers["Authorization"] = `Bearer ${API_KEY}`;
+    }
+    const url = `${API_URL}${path}`;
+    const response = await fetch(url, {
+        method,
+        headers,
+        body: body ? JSON.stringify(body) : undefined,
+    });
+    if (!response.ok) {
+        const errorBody = await response.text();
+        let errorMessage;
+        try {
+            const errorJson = JSON.parse(errorBody);
+            errorMessage = errorJson.message || errorJson.error || response.statusText;
+        }
+        catch {
+            errorMessage = errorBody || response.statusText;
+        }
+        if (response.status === 401) {
+            throw new Error(`Authentication failed: ${errorMessage}. Set DENIALBOT_API_KEY environment variable with your cu_ prefixed API key. Get one at coverageunlocked.com/api`);
+        }
+        if (response.status === 429) {
+            throw new Error(`Rate limit or quota exceeded: ${errorMessage}. Upgrade your tier at coverageunlocked.com/api#pricing`);
+        }
+        throw new Error(`API error (${response.status}): ${errorMessage}`);
+    }
+    return response.json();
+}
+function formatResponse(data) {
+    return JSON.stringify(data, null, 2);
+}
+// ============================================================================
+// MCP TOOLS
+// ============================================================================
+// Tool 1: Lookup denial code
+server.tool("lookup_denial_code", "Look up detailed information about an insurance denial code including description, category, appeal strategy, success rate, recommended actions, and supporting regulations. Use when a user mentions a specific denial code or asks about a denial reason.", {
+    code: zod_1.z
+        .string()
+        .describe("The denial code to look up (e.g., 'CO-18', 'PR-1', 'OA-23', 'MA-04'). Supports all standard CARC/RARC denial code formats."),
+}, async ({ code }) => {
+    const result = await apiRequest("POST", "/v1/denial-code/lookup", {
+        code,
+    });
+    return {
+        content: [
+            {
+                type: "text",
+                text: formatResponse(result),
+            },
+        ],
+    };
+});
+// Tool 2: List denial codes
+server.tool("list_denial_codes", "List all 50+ insurance denial codes in the database. Returns code, description, and category for each. Optionally filter by category. Use when a user wants to browse codes, find the right code for their situation, or asks 'what are the common denial codes'.", {
+    category: zod_1.z
+        .string()
+        .optional()
+        .describe("Optional filter by category: 'Coverage', 'Medical Necessity', 'Procedure Related', 'Cost-Sharing', 'Administrative', 'Patient Issues', 'Other Adjudication', 'Frequency Limits'. Omit to list all codes."),
+}, async ({ category }) => {
+    let path = "/v1/denial-codes";
+    if (category) {
+        path += `?category=${encodeURIComponent(category)}`;
+    }
+    const result = await apiRequest("GET", path);
+    // If category filter was applied and result is an array, filter client-side too
+    let filtered = result;
+    if (category && Array.isArray(result)) {
+        filtered = result.filter((code) => code.category?.toLowerCase() === category.toLowerCase());
+    }
+    return {
+        content: [
+            {
+                type: "text",
+                text: formatResponse(filtered),
+            },
+        ],
+    };
+});
+// Tool 3: Generate appeal letter
+server.tool("generate_appeal_letter", "Generate a professional 800-1200 word insurance appeal letter with regulatory citations (ACA, ERISA), clinical evidence references, confidence score, and estimated success rate. Use when a user wants help writing an appeal, has been denied coverage, or needs a template appeal letter.", {
+    denial_code: zod_1.z
+        .string()
+        .describe("The denial code from the insurance company (e.g., 'CO-18')"),
+    diagnosis: zod_1.z
+        .string()
+        .describe("The patient's medical diagnosis (e.g., 'Type 2 Diabetes Mellitus with peripheral neuropathy')"),
+    procedure: zod_1.z
+        .string()
+        .describe("The denied medical procedure or service (e.g., 'Advanced continuous glucose monitoring system')"),
+    insurance_company: zod_1.z
+        .string()
+        .optional()
+        .describe("The insurance company name (e.g., 'Blue Cross Blue Shield of Illinois')"),
+    patient_summary: zod_1.z
+        .string()
+        .optional()
+        .describe("Brief clinical summary of the patient's situation, relevant history, and why the procedure is needed"),
+    denial_reason: zod_1.z
+        .string()
+        .optional()
+        .describe("The stated reason for denial from the insurance company's explanation of benefits (EOB)"),
+}, async (params) => {
+    const result = await apiRequest("POST", "/v1/appeal/generate", params);
+    return {
+        content: [
+            {
+                type: "text",
+                text: formatResponse(result),
+            },
+        ],
+    };
+});
+// Tool 4: Analyze denial letter
+server.tool("analyze_denial_letter", "Analyze raw denial letter text to identify denial codes, classify the denial type, assess urgency, and recommend next steps. Use when a user has received a denial letter and wants to understand it, or needs help identifying what codes apply.", {
+    denial_text: zod_1.z
+        .string()
+        .describe("The full text of the insurance denial letter or Explanation of Benefits (EOB). Can be pasted directly from the document."),
+}, async ({ denial_text }) => {
+    const result = await apiRequest("POST", "/v1/appeal/analyze", {
+        denial_text,
+    });
+    return {
+        content: [
+            {
+                type: "text",
+                text: formatResponse(result),
+            },
+        ],
+    };
+});
+// Tool 5: Check API status
+server.tool("check_api_status", "Check the operational status of the DenialBot API. Use to verify connectivity before making other calls.", {}, async () => {
+    const result = await apiRequest("GET", "/v1/status");
+    return {
+        content: [
+            {
+                type: "text",
+                text: formatResponse(result),
+            },
+        ],
+    };
+});
+// Tool 6: Check usage
+server.tool("check_usage", "Check current API usage, quota remaining, and tier information for the authenticated API key.", {}, async () => {
+    if (!API_KEY) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: "No API key configured. Set DENIALBOT_API_KEY to check usage.",
+                },
+            ],
+        };
+    }
+    const result = await apiRequest("GET", "/v1/usage");
+    return {
+        content: [
+            {
+                type: "text",
+                text: formatResponse(result),
+            },
+        ],
+    };
+});
+// ============================================================================
+// SERVER STARTUP
+// ============================================================================
+async function main() {
+    const transport = new stdio_js_1.StdioServerTransport();
+    await server.connect(transport);
+    console.error("DenialBot MCP server running on stdio");
+    console.error(`API URL: ${API_URL}`);
+    console.error(`API Key: ${API_KEY ? API_KEY.substring(0, 8) + "..." : "NOT SET"}`);
+}
+main().catch((error) => {
+    console.error("Failed to start DenialBot MCP server:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@denialbot/mcp",
+  "version": "1.0.0",
+  "description": "MCP server for CoverageUnlocked DenialBot API — Insurance denial code intelligence, appeal letter generation, and denial analysis for Claude and other AI assistants",
+  "main": "dist/index.js",
+  "bin": {
+    "denialbot-mcp": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsx src/index.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "zod": "^3.22.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.3.0",
+    "tsx": "^4.7.0",
+    "@types/node": "^20.0.0"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "insurance",
+    "denial",
+    "appeal",
+    "healthcare",
+    "coverageunlocked",
+    "denialbot",
+    "claude",
+    "ai-tools",
+    "health-insurance",
+    "appeal-letter"
+  ],
+  "author": "CoverageUnlocked <api@coverageunlocked.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/edgeedgehq/denialbot-mcp"
+  },
+  "homepage": "https://coverageunlocked.com/api",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ]
+}