# SOAPNoteAPI

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

- **Type:** MCP server
- **Install:** `agentstack add mcp-soapnoteaicom-soapnoteapi-mcp`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [soapnoteaicom](https://agentstack.voostack.com/s/soapnoteaicom)
- **Installs:** 0
- **Category:** [Content & Media](https://agentstack.voostack.com/c/content-and-media)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [soapnoteaicom](https://github.com/soapnoteaicom)
- **Source:** https://github.com/soapnoteaicom/soapnoteapi-mcp

## Install

```sh
agentstack add mcp-soapnoteaicom-soapnoteapi-mcp
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# soapnoteapi-mcp

A [Model Context Protocol](https://modelcontextprotocol.io) (MCP) server for **[SOAPNoteAPI](https://www.soapnoteapi.com)**. 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

| 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}` |

## Setup

Get an API key at  (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

| 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`) |

## Develop

```bash
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
```

## Publish

```bash
pnpm --filter soapnoteapi-mcp build
cd packages/mcp && npm publish        # publishes soapnoteapi-mcp to npm
```

## License

MIT

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [soapnoteaicom](https://github.com/soapnoteaicom)
- **Source:** [soapnoteaicom/soapnoteapi-mcp](https://github.com/soapnoteaicom/soapnoteapi-mcp)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-soapnoteaicom-soapnoteapi-mcp
- Seller: https://agentstack.voostack.com/s/soapnoteaicom
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.