Config is the same across clients — only the file and path differ.
{
"mcpServers": {
"soapnoteapi": {
"env": {
"SOAPNOTEAPI_KEY": "snapi_sk_live_xxxxxxxx"
},
"args": [
"-y",
"soapnoteapi-mcp"
],
"command": "npx"
}
}
}Are you the author?
Add this badge to your README to show your security score and help users find safe servers.
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.
Run this in your terminal to verify the server starts. Then let us know if it worked — your result helps other developers.
npx -y 'soapnoteapi-mcp' 2>&1 | head -1 && echo "✓ Server started successfully"
After testing, let us know if it worked:
Five weighted categories — click any category to see the underlying evidence.
No known CVEs.
Checked soapnoteapi-mcp against OSV.dev.
Be the first to review
Have you used this server?
Share your experience — it helps other developers decide.
Sign in to write a review.
Others in finance / health
MCP server for the ClinicalTrials.gov v2 API. Search trials, retrieve study details and results, and match patients to eligible trials.
MCP server for QuickBooks Online — accounts, customers, invoices, bills, and reports.
Let AI agents create, discover, and track tokens across chains via Printr.
Real-time financial market data: stocks, forex, crypto, commodities, and economic indicators
MCP Security Weekly
Get CVE alerts and security updates for com.soapnoteapi/soapnoteapi-mcp and similar servers.
Start a conversation
Ask a question, share a tip, or report an issue.
Sign in to join the discussion.
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){
"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-mcp
| 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) |
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 test
pnpm --filter soapnoteapi-mcp build
cd packages/mcp && npm publish # publishes soapnoteapi-mcp to npm
MIT