The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the SOAPNoteAPI listing page.
A Model Context Protocol (MCP) server for SOAPNoteAPI. It lets AI agents (Claude Desktop/Code, Cursor, Windsurf, VS Code + Copilot, etc.) turn clinical transcripts or audio recordings into structured SOAP notes, ICD-10/CPT billing-code suggestions, patient summaries, and visit summaries.
⚕️ All clinical content and billing codes are AI-generated decision support and must be reviewed by a qualified clinician/coder before use. HIPAA: this server only transits PHI to the API over TLS and never logs note content.
| Tool | What it does | API |
|---|---|---|
list_specialties | List supported specialties (no key needed) | GET /v1/specialties |
generate_soap_note | Transcript → SOAP note (+ optional billing codes, patient summary) | POST /v1/note |
get_note | Fetch a note by noteId | GET /v1/note/{id} |
summarize_visits | Consolidate visits into a longitudinal summary | POST /v1/visit-summary |
transcribe_audio_to_soap | Local audio file → SOAP note (waits for async jobs) | PUT /v1/note/audio |
get_audio_status | Poll an async audio job | GET /v1/audio/status/{id} |
Get an API key at https://app.soapnoteapi.com (free tier: $10 credit, first 20 notes free).
mcp.json)| Variable | Required | Notes |
|---|---|---|
SOAPNOTEAPI_KEY | yes (for all tools except list_specialties) | Bearer key, snapi_sk_live_… or snapi_sk_test_… |
SOAPNOTEAPI_BASE_URL | no | Override API base (default https://api.soapnoteapi.com) |
MIT