SOAPNoteAPI

com.soapnoteapiPublished by soapnoteapi.comv0.1.1Updated Oct 27, 2026

Generate clinical SOAP notes, billing codes, and visit summaries from transcripts or audio.

VerifiedSTDIODesktop onlyLocation & LifestyleAI & ML

Overview

AI-generated overview

Turns clinical transcripts or audio into SOAP notes, billing-code suggestions and visit summaries through the SOAPNoteAPI service.

What you can do
  • List supported medical specialties
  • Generate a SOAP note from a transcript, optionally with billing codes and a patient summary
  • Fetch a previously created note by its ID
  • Consolidate multiple visits into a longitudinal summary
  • Transcribe a local audio file into a SOAP note and poll the status of asynchronous audio jobs
When to use it
Useful for clinicians, scribes or health-tech developers who want an assistant to draft structured SOAP notes, ICD-10/CPT code suggestions and visit summaries from recorded or transcribed encounters.
Requirements
Runs locally over stdio via npx (Node.js). Requires a SOAPNoteAPI key in the SOAPNOTEAPI_KEY environment variable for all tools except listing specialties; an optional SOAPNOTEAPI_BASE_URL can override the API endpoint. Network access to the SOAPNoteAPI service is needed, and a paid or free-tier account is required.
Before you install
Clinical notes and billing codes are AI-generated decision support and must be reviewed by a qualified clinician or coder. Audio and transcripts, which may contain protected health information, are sent to the SOAPNoteAPI service over TLS. The key is a billable credential (free tier includes credit, then paid), so keep it out of shared configs. Notes are created and stored on the remote service.

Installation

In SourceWeft

  1. Open SOAPNoteAPI in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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

ToolWhat it doesAPI
list_specialtiesList supported specialties (no key needed)GET /v1/specialties
generate_soap_noteTranscript → SOAP note (+ optional billing codes, patient summary)POST /v1/note
get_noteFetch a note by noteIdGET /v1/note/{id}
summarize_visitsConsolidate visits into a longitudinal summaryPOST /v1/visit-summary
transcribe_audio_to_soapLocal audio file → SOAP note (waits for async jobs)PUT /v1/note/audio
get_audio_statusPoll an async audio jobGET /v1/audio/status/{id}

Setup

Get an API key at https://app.soapnoteapi.com (free tier: $10 credit, first 20 notes free).

Claude Desktop / Cursor (mcp.json)

json
{  "mcpServers": {    "soapnoteapi": {      "command": "npx",      "args": ["-y", "soapnoteapi-mcp"],      "env": { "SOAPNOTEAPI_KEY": "snapi_sk_live_xxxxxxxx" }    }  }}

Claude Code

bash
claude mcp add soapnoteapi --env SOAPNOTEAPI_KEY=snapi_sk_live_xxxxxxxx -- npx -y soapnoteapi-mcp

Environment variables

VariableRequiredNotes
SOAPNOTEAPI_KEYyes (for all tools except list_specialties)Bearer key, snapi_sk_live_… or snapi_sk_test_…
SOAPNOTEAPI_BASE_URLnoOverride API base (default https://api.soapnoteapi.com)

Develop

bash
pnpm installpnpm --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

Publish

bash
pnpm --filter soapnoteapi-mcp buildcd packages/mcp && npm publish        # publishes soapnoteapi-mcp to npm

License

MIT

Source: README.md at commit 2cd548b

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.1LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts