painprep-mcp-server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| PAINPREP_TIER | No | Force 'premium' or 'free' (self-hosted / enterprise override). | |
| PAINPREP_VALID_KEYS | No | Comma-separated allowlist of keys treated as valid premium (manual provisioning / testing). | |
| PAINPREP_LICENSE_KEY | No | The customer's license key. Format: PP-XXXX-XXXX-XXXX | |
| PAINPREP_LICENSE_VERIFY_URL | No | Optional HTTP endpoint for remote key verification. When set, keys are validated against this service instead of locally. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_procedure_listA | Returns the full catalog of interventional pain medicine procedures, grouped by category. Each entry includes the procedure id (used by other tools), display name, short name, and headline CPT code(s). Optionally filter by a category id or name. FREE tier. |
| get_cpt_codesA | Given a procedure (name, id, or CPT code), returns the primary CPT code(s), add-on codes, work RVUs, typical facility setting (office/ASC/hospital), and billing notes. FREE tier. |
| get_medicare_checklistA | Given a procedure, returns the full Medicare/LCD documentation checklist: required documentation items with rationale and suggested chart wording, top denial triggers, and pre-submission admin checks. Flags items that are commonly missed. PREMIUM tier. |
| get_icd10_codesA | Given a procedure, returns the approved/supportive ICD-10 diagnosis codes, codes to AVOID (common denial triggers), and coding tips for medical-necessity support. PREMIUM tier. |
| get_contraindicationsA | Given a procedure, returns its bleeding-risk level and the ASRA-aligned anticoagulant/antiplatelet stop-and-restart guidance (per agent), special considerations, and general pre-procedure safety checks. Always verify against the current ASRA guidelines and institutional policy. PREMIUM tier. |
| get_prior_auth_letterB | Generates a formal, payer-ready prior-authorization / medical-necessity letter for a procedure, merging supplied patient and clinical details with the procedure’s CPT codes, recommended primary ICD-10 code, evidence grade, and necessity rationale. Any field left unspecified is rendered as a clearly-marked fill-in blank. The structured medical-necessity worksheet is appended when available. PREMIUM tier. |
| get_denial_reasonsA | Given a procedure, returns the common payer denial reasons with their relative frequency, the concrete fix/remedy for each, and a ready-to-adapt appeal letter snippet. PREMIUM tier. |
| get_research_evidenceA | Given a procedure, returns the overall evidence grade, a summary of the evidence base, and the key supporting studies (title, journal, year, and headline finding) for use in notes and appeals. PREMIUM tier. |
| check_documentation_completenessA | Given a procedure and the list of items already documented in the chart, audits the note against the Medicare required-documentation checklist and returns what is satisfied, what is still missing (with rationale and suggested wording), a spotlight on commonly-missed gaps, and an overall completeness score. PREMIUM tier. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 9 tools
Each tool has a clearly distinct purpose: CPT codes, procedure list, Medicare checklist, ICD-10 codes, contraindications, prior authorization letter, denial reasons, research evidence, and documentation completeness audit. No two tools overlap in functionality.
The majority of tools follow a 'get_' + noun pattern (e.g., get_cpt_codes, get_procedure_list). The only exception is check_documentation_completeness, which uses a different verb. This is a minor inconsistency but still readable.
With 9 tools, the surface is well-scoped for the domain of interventional pain medicine procedure preparation. Each tool addresses a specific clinical or administrative need without being overwhelming.
The tool set covers key workflow steps: coding, documentation requirements, contraindications, prior authorization, denial management, and evidence. Minor gaps exist (e.g., no tool for payer-specific policies or patient education materials), but core operations are present.