Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@soapnoteapi-mcp Create a SOAP note from this transcript."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 supported specialties (no key needed) |
|
| Transcript → SOAP note (+ optional billing codes, patient summary) |
|
| Fetch a note by |
|
| Consolidate visits into a longitudinal summary |
|
| Local audio file → SOAP note (waits for async jobs) |
|
| Poll an async audio job |
|
Related MCP server: mymedi-ai-mcp-server
Get an API key at https://app.soapnoteapi.com (free tier: $10 credit, first 20 notes free).
mcp.json){
"mcpServers": {
"soapnoteapi": {
"command": "npx",
"args": ["-y", "soapnoteapi-mcp"],
"env": { "SOAPNOTEAPI_KEY": "snapi_sk_live_xxxxxxxx" }
}
}
}claude mcp add soapnoteapi --env SOAPNOTEAPI_KEY=snapi_sk_live_xxxxxxxx -- npx -y soapnoteapi-mcpVariable | Required | Notes |
| yes (for all tools except | Bearer key, |
| no | Override API base (default |
pnpm install
pnpm --filter soapnoteapi-mcp dev # run from source (tsx)
pnpm --filter soapnoteapi-mcp build # compile to dist/
npx @modelcontextprotocol/inspector node dist/index.js # interactive testpnpm --filter soapnoteapi-mcp build
cd packages/mcp && npm publish # publishes soapnoteapi-mcp to npmMIT
Generate a structured SOAP note (Subjective, Objective, Assessment, Plan) from a clinical transcript or shorthand. Optionally returns ICD-10/CPT/HCPCS billing-code suggestions and a plain-language patient summary. Billing codes are AI decision support and require clinician review.
Inputs: specialty (required), transcript (required), patient, template, +5 more.
Check the processing status of an asynchronous audio-to-SOAP job by noteId.
Inputs: noteId (required).
Retrieve a previously generated note by its noteId. Useful for fetching the result of an asynchronous audio job once status is 'completed'. Notes auto-expire (see expires_at).
Inputs: noteId (required).
List the medical specialties (and template variants) supported by SOAPNoteAPI. Use the returned specialty IDs as the specialty argument for note generation. No API key required.
Inputs: no named parameters.
Consolidate multiple past visits (SOAP notes and/or free-text summaries) into a longitudinal summary with key findings and active diagnoses. Useful for care coordination and chart prep.
Inputs: visits (required), focus, patient.
Upload a local audio recording of a clinical encounter and get back a SOAP note. Short recordings return immediately; long ones process asynchronously — by default this tool waits and returns the finished note. Supported: mp3, m4a, wav, ogg, webm, flac.
Inputs: specialty (required), audio_path (required), patient, template, +8 more.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 6 tools
Each tool has a clearly distinct purpose: listing specialties, generating notes from text, transcribing audio, retrieving notes, checking status, and summarizing visits. No overlap or ambiguity.
All tool names follow a consistent verb_noun pattern in snake_case (e.g., list_specialties, generate_soap_note), making them predictable and easy to understand.
6 tools is well-scoped for a clinical note generation server. Each tool provides essential functionality without redundancy, covering the core workflow.
Covers the full lifecycle: specialty listing, note generation (text/audio), retrieval, status checking, and visit summarization. Minor gaps like lack of update/delete are acceptable given auto-expiration.
Transcribe audio & video to text for AI agents: 100+ languages, speaker labels, webhooks.
AI transcription API: turn voice memos, meetings and audio URLs into text and SRT subtitles.
Turn any recording or document into notes, flashcards and quizzes your agent can read and act on
Podcast intelligence for agents: transcripts, clips, speaker diarization, mention tracking.
