Verity MCP Server

Instructions

Implementation Reference

• src/index.ts:422-485 (handler)

  Handler function that executes the compare_policies tool logic: POSTs to Verity API /policies/compare, formats national and jurisdictional policy comparisons, handles errors.
  async ({ procedure_codes, policy_type, jurisdictions }) => { try { const result = await verityRequest<any>("/policies/compare", { method: "POST", body: { procedure_codes, policy_type, jurisdictions }, }); const lines: string[] = []; const summary = result.data.summary; lines.push(`Coverage Comparison for: ${summary.queried_codes.join(", ")}`); lines.push(`Jurisdictions analyzed: ${summary.total_jurisdictions}`); lines.push(`With coverage: ${summary.jurisdictions_with_coverage}`); lines.push(`National policies: ${summary.national_policies_count}`); lines.push(`Regional variation: ${summary.has_variation ? "YES" : "NO"}`); // National policies if (result.data.national_policies?.length > 0) { lines.push("\n--- NATIONAL POLICIES ---"); result.data.national_policies.forEach((p: any) => { lines.push(`\n${p.policy_id}: ${p.title}`); lines.push(`Type: ${p.policy_type}`); if (p.codes?.length > 0) { p.codes.forEach((c: any) => { lines.push(` - ${c.code}: ${c.disposition}`); }); } }); } // Jurisdiction comparison if (result.data.comparison?.length > 0) { lines.push("\n--- BY JURISDICTION ---"); result.data.comparison.forEach((jur: any) => { lines.push(`\n[${jur.jurisdiction}] ${jur.mac?.name || ""}`); if (jur.mac?.states) lines.push(`States: ${jur.mac.states.join(", ")}`); if (jur.coverage_summary) { const cs = jur.coverage_summary; lines.push(`Coverage: ${cs.covered} covered, ${cs.not_covered} not covered, ${cs.requires_pa} require PA, ${cs.conditional} conditional`); } if (jur.policies?.length > 0) { jur.policies.forEach((p: any) => { lines.push(` ${p.policy_id}: ${p.title}`); }); } else { lines.push(" No local policies found"); } }); } return { content: [{ type: "text", text: lines.join("\n") }], }; } catch (error) { return { content: [{ type: "text", text: `Error comparing policies: ${error instanceof Error ? error.message : String(error)}` }], }; } } ); // 5. get_policy_changes - Track policy updates
• src/index.ts:408-421 (schema)

  Zod input schema validating procedure_codes array (1-10 strings), optional policy_type enum, optional jurisdictions array.
  inputSchema: { procedure_codes: z .array(z.string()) .min(1) .max(10) .describe("CPT/HCPCS codes to compare (1-10 codes)"), policy_type: z.enum(["LCD", "Article", "NCD"]).optional().describe("Filter by policy type"), jurisdictions: z .array(z.string()) .max(10) .optional() .describe("Specific jurisdictions to compare (e.g., ['JM', 'JH'])"), }, },
• src/index.ts:398-486 (registration)

  MCP server registration of the compare_policies tool, including description, input schema, and handler function.
  server.registerTool( "compare_policies", { description: `Compare coverage policies across different MAC jurisdictions for specific procedure codes. Useful to understand regional coverage differences for the same procedures. Shows national vs. jurisdiction-specific policies. Examples: - compare_policies(["76942"]) - compare ultrasound guidance coverage nationally - compare_policies(["76942", "76937"], { jurisdictions: ["JM", "JH"] }) - compare specific regions`, inputSchema: { procedure_codes: z .array(z.string()) .min(1) .max(10) .describe("CPT/HCPCS codes to compare (1-10 codes)"), policy_type: z.enum(["LCD", "Article", "NCD"]).optional().describe("Filter by policy type"), jurisdictions: z .array(z.string()) .max(10) .optional() .describe("Specific jurisdictions to compare (e.g., ['JM', 'JH'])"), }, }, async ({ procedure_codes, policy_type, jurisdictions }) => { try { const result = await verityRequest<any>("/policies/compare", { method: "POST", body: { procedure_codes, policy_type, jurisdictions }, }); const lines: string[] = []; const summary = result.data.summary; lines.push(`Coverage Comparison for: ${summary.queried_codes.join(", ")}`); lines.push(`Jurisdictions analyzed: ${summary.total_jurisdictions}`); lines.push(`With coverage: ${summary.jurisdictions_with_coverage}`); lines.push(`National policies: ${summary.national_policies_count}`); lines.push(`Regional variation: ${summary.has_variation ? "YES" : "NO"}`); // National policies if (result.data.national_policies?.length > 0) { lines.push("\n--- NATIONAL POLICIES ---"); result.data.national_policies.forEach((p: any) => { lines.push(`\n${p.policy_id}: ${p.title}`); lines.push(`Type: ${p.policy_type}`); if (p.codes?.length > 0) { p.codes.forEach((c: any) => { lines.push(` - ${c.code}: ${c.disposition}`); }); } }); } // Jurisdiction comparison if (result.data.comparison?.length > 0) { lines.push("\n--- BY JURISDICTION ---"); result.data.comparison.forEach((jur: any) => { lines.push(`\n[${jur.jurisdiction}] ${jur.mac?.name || ""}`); if (jur.mac?.states) lines.push(`States: ${jur.mac.states.join(", ")}`); if (jur.coverage_summary) { const cs = jur.coverage_summary; lines.push(`Coverage: ${cs.covered} covered, ${cs.not_covered} not covered, ${cs.requires_pa} require PA, ${cs.conditional} conditional`); } if (jur.policies?.length > 0) { jur.policies.forEach((p: any) => { lines.push(` ${p.policy_id}: ${p.title}`); }); } else { lines.push(" No local policies found"); } }); } return { content: [{ type: "text", text: lines.join("\n") }], }; } catch (error) { return { content: [{ type: "text", text: `Error comparing policies: ${error instanceof Error ? error.message : String(error)}` }], }; } } ); // 5. get_policy_changes - Track policy updates server.registerTool(