feat(mcp): dental + ABA tool surface for agentic orchestration

Adds 4 new MCP tools so agents (Claude, OpenClaw) can drive the launch-
priority packs end-to-end:

Dental (3 new):
- query_dental_fee_schedule: per-payer+CDT rate, network status, drift
- score_dental_claim_denial_risk: CatBoost denial risk with SHAP factors,
  heuristic fallback
- get_dental_payer_drift: 90-day reimbursement/denial/silent-PPO patterns

ABA (1 new, alongside existing get_aba_session_tracker):
- get_aba_payer_comparison: payer-side approval rates for 97151-97158

All tools call existing /api/v1/dental/ and /api/v1/aba/ endpoints; no new
backend surface required. Registered in src/index.ts tools array.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: byteworthy

src/index.ts

@@ -19,7 +19,11 @@ import { getIndustrySignals } from './tools/get_industry_signals.js';
 import { checkPriorAuthReadiness } from './tools/check_prior_auth_readiness.js';
 import { getDenialClusters } from './tools/get_denial_clusters.js';
 import { getAbaSessionTracker } from './tools/get_aba_session_tracker.js';
+import { getAbaPayerComparison } from './tools/get_aba_payer_comparison.js';
 import { getPatientPropensity } from './tools/get_patient_propensity.js';
+import { queryDentalFeeSchedule } from './tools/query_dental_fee_schedule.js';
+import { scoreDentalClaimDenialRisk } from './tools/score_dental_claim_denial_risk.js';
+import { getDentalPayerDrift } from './tools/get_dental_payer_drift.js';
 
 const tools = [
   checkNcciEdits,
@@ -33,7 +37,11 @@ const tools = [
   checkPriorAuthReadiness,
   getDenialClusters,
   getAbaSessionTracker,
+  getAbaPayerComparison,
   getPatientPropensity,
+  queryDentalFeeSchedule,
+  scoreDentalClaimDenialRisk,
+  getDentalPayerDrift,
 ];
 
 const server = new Server(

src/tools/get_aba_payer_comparison.ts

@@ -0,0 +1,17 @@
+import { UpstreamAPIClient } from '../client.js';
+
+export const getAbaPayerComparison = {
+  name: 'get_aba_payer_comparison',
+  description:
+    'Returns payer-side approval rates for the seven ABA CPT codes (97151-97158) across active payers. ' +
+    'Use to identify which payers are denying the highest-revenue ABA codes, ' +
+    'so you can target appeals, escalations, and contract renegotiations.',
+  inputSchema: {
+    type: 'object',
+    properties: {},
+    required: [],
+  },
+  async execute(client: UpstreamAPIClient) {
+    return client.get(`/api/v1/aba/payer-comparison/`);
+  },
+};

src/tools/get_dental_payer_drift.ts

@@ -0,0 +1,24 @@
+import { UpstreamAPIClient } from '../client.js';
+
+export const getDentalPayerDrift = {
+  name: 'get_dental_payer_drift',
+  description:
+    'Returns dental payer behavioral drift: reimbursement ratio drops, denial rate spikes, ' +
+    'silent PPO indicators, and downcoding patterns over the last 90 days. ' +
+    'Used to detect payers quietly changing their dental contracts before they cost you revenue.',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      payer: {
+        type: 'string',
+        description: 'Optional payer filter; omit to get all payers',
+      },
+    },
+    required: [],
+  },
+  async execute(client: UpstreamAPIClient, args: { payer?: string }) {
+    const qs = new URLSearchParams();
+    if (args.payer) qs.set('payer', args.payer);
+    return client.get(`/api/v1/dental/payer-drift/?${qs.toString()}`);
+  },
+};

src/tools/query_dental_fee_schedule.ts

@@ -0,0 +1,27 @@
+import { UpstreamAPIClient } from '../client.js';
+
+export const queryDentalFeeSchedule = {
+  name: 'query_dental_fee_schedule',
+  description:
+    'Returns the current Upstream-tracked dental fee schedule for a given payer + CDT code. ' +
+    'Includes posted rate, network status, last drift event, and reimbursement ratio versus UCR. ' +
+    'Use to detect silent PPO leases, downcoding, and reimbursement drift before submitting claims.',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      payer: {
+        type: 'string',
+        description: 'Payer name as it appears in the dental fee schedule (e.g. "Delta Dental of Texas")',
+      },
+      cdt_code: {
+        type: 'string',
+        description: 'CDT procedure code (e.g. "D2740")',
+      },
+    },
+    required: ['payer', 'cdt_code'],
+  },
+  async execute(client: UpstreamAPIClient, args: { payer: string; cdt_code: string }) {
+    const qs = new URLSearchParams({ payer: args.payer, cdt: args.cdt_code });
+    return client.get(`/api/v1/dental/fee-schedule/?${qs.toString()}`);
+  },
+};

src/tools/score_dental_claim_denial_risk.ts

@@ -0,0 +1,30 @@
+import { UpstreamAPIClient } from '../client.js';
+
+export const scoreDentalClaimDenialRisk = {
+  name: 'score_dental_claim_denial_risk',
+  description:
+    'Scores pending/recent dental claims for denial risk using the trained CatBoost model. ' +
+    'Returns per-claim risk score (0-100), risk band, top contributing factors (SHAP attribution), ' +
+    'and recommended pre-submission actions. Falls back to heuristic when CatBoost model is not trained.',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      limit: {
+        type: 'integer',
+        description: 'Maximum claims to score (default 25, max 100)',
+        default: 25,
+      },
+      status_filter: {
+        type: 'string',
+        description: 'Optional filter: "pending" or "recent". Default returns both.',
+      },
+    },
+    required: [],
+  },
+  async execute(client: UpstreamAPIClient, args: { limit?: number; status_filter?: string }) {
+    const qs = new URLSearchParams();
+    if (args.limit) qs.set('limit', String(args.limit));
+    if (args.status_filter) qs.set('status', args.status_filter);
+    return client.get(`/api/v1/dental/claims-intelligence/?${qs.toString()}`);
+  },
+};