SOAPNoteAPI MCP server
com.soapnoteapi/soapnoteapi-mcp·v0.1.1Generate clinical SOAP notes, billing codes, and visit summaries from transcripts or audio.
0 stars53 downloads/wk
Reviews
Write oneNobody has reviewed SOAPNoteAPI yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
SOAPNoteAPI tools (6, 1 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
generate_soap_noteGenerate a structured SOAP note (Subjective, Objective, Assessment, Plan) from a clinical
get_audio_statusCheck the processing status of an asynchronous audio-to-SOAP job by noteId.
get_noteRetrieve a previously generated note by its noteId. Useful for fetching the result of an
list_specialtiesList the medical specialties (and template variants) supported by SOAPNoteAPI.
summarize_visitsConsolidate multiple past visits (SOAP notes and/or free-text summaries) into a longitudinal
transcribe_audio_to_soapwrite actionUpload a local audio recording of a clinical encounter and get back a SOAP note. Short
Public scan report
scanner v0.1.9 · 2026-09-26 · same rubric, same numbers if you re-run it
- Code scan6 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 102 days ago8/15
- Maintainer identitynamespace and repository owner differ; GitHub account older than a year; website matches verified namespace8/10
How SOAPNoteAPI compares
Against every graded Media MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 72/100
- higher than 40% of 1,337 Media servers
- Tools
- 6
- the typical Media server has 7
- Tools that change things
- 17%
- typical: 4%. Fewer write tools means less an agent can break
- Downloads a week
- 53
- more than 40% of 365 Media servers with a package
What its tools let an agent do: 4 read · 1 create · 1 change
Install SOAPNoteAPI in Claude Code, Cursor or VS Code
Runs npx -y soapnoteapi-mcp on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add soapnoteapi-mcp -- npx -y soapnoteapi-mcp
What the publisher says
From the SOAPNoteAPI repository's README, as published. We do not edit it. Read it on GitHub
soapnoteapi-mcp
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.
Tools
Setup
Get an API key at (free tier: $10 credit, first 20 notes free).
Claude Desktop / Cursor (mcp.json)
{
"mcpServers": {
"soapnoteapi": {
"command": "npx",
"args": ["-y", "soapnoteapi-mcp"],
"env": { "SOAPNOTEAPI_KEY": "snapi_sk_live_xxxxxxxx" }
}
}
}Claude Code
claude mcp add soapnoteapi --env SOAPNOTEAPI_KEY=snapi_sk_live_xxxxxxxx -- npx -y soapnoteapi-mcpEnvironment variables
Develop
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 testPublish
pnpm --filter soapnoteapi-mcp build
cd packages/mcp && npm publish # publishes soapnoteapi-mcp to npmLicense
MIT
Nothing above is checked by us. What we check is on the safety report.
SOAPNoteAPI: common questions
- Is SOAPNoteAPI MCP server safe?
- Mostly: it is graded B (72/100). Read the SOAPNoteAPI safety report
- How do I install SOAPNoteAPI?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does SOAPNoteAPI need an API key?
- Yes. The registry entry asks for
SOAPNOTEAPI_KEY. - Is SOAPNoteAPI maintained?
- The last commit was 141 days ago (2026-06-16). The latest release is v0.1.1.
- What can I use instead of SOAPNoteAPI?
- Servers from other publishers that do the same job: Transcription MCP server, PixelDojo MCP server and faktry MCP server.
- How does SOAPNoteAPI compare with other Media MCP servers?
- safety score 72/100 (higher than 40% of 1,337 Media servers); tools 6 (the typical Media server has 7); tools that change things 17% (typical: 4%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to SOAPNoteAPI
Same job from other publishers: the closest match first, then the best rated.
- TranscriptionTranscribe audio and video and work with your transcript library from any AI app. 119 languages.not reviewedGrowingA
PixelDojoGenerate images, video, audio and short films with 140+ AI models from any MCP client.not reviewedGrowingA- faktryOfficial faktry MCP server: generate and edit images, video, audio, and PDFs.not reviewedGrowingA
- VidofyGenerate video, images, audio and speech with Vidofy — Veo 3.1, Kling 3.0, Flux 2 and 570+ models.not reviewedGrowingA
RendobarTransform video, audio and images, and generate media from prompts. FFmpeg, captions, models.not reviewedGrowingA