{
  "markdown": "# soapnoteapi-mcp\n\nA [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**.\n\n> ⚕️ 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.\n\n## Tools\n\n| Tool | What it does | API |\n|------|--------------|-----|\n| `list_specialties` | List supported specialties (no key needed) | `GET /v1/specialties` |\n| `generate_soap_note` | Transcript → SOAP note (+ optional billing codes, patient summary) | `POST /v1/note` |\n| `get_note` | Fetch a note by `noteId` | `GET /v1/note/{id}` |\n| `summarize_visits` | Consolidate visits into a longitudinal summary | `POST /v1/visit-summary` |\n| `transcribe_audio_to_soap` | Local audio file → SOAP note (waits for async jobs) | `PUT /v1/note/audio` |\n| `get_audio_status` | Poll an async audio job | `GET /v1/audio/status/{id}` |\n\n## Setup\n\nGet an API key at <https://app.soapnoteapi.com> (free tier: $10 credit, first 20 notes free).\n\n### Claude Desktop / Cursor (`mcp.json`)\n\n```json\n{\n  \"mcpServers\": {\n    \"soapnoteapi\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"soapnoteapi-mcp\"],\n      \"env\": { \"SOAPNOTEAPI_KEY\": \"snapi_sk_live_xxxxxxxx\" }\n    }\n  }\n}\n```\n\n### Claude Code\n\n```bash\nclaude mcp add soapnoteapi --env SOAPNOTEAPI_KEY=snapi_sk_live_xxxxxxxx -- npx -y soapnoteapi-mcp\n```\n\n## Environment variables\n\n| Variable | Required | Notes |\n|----------|----------|-------|\n| `SOAPNOTEAPI_KEY` | yes (for all tools except `list_specialties`) | Bearer key, `snapi_sk_live_…` or `snapi_sk_test_…` |\n| `SOAPNOTEAPI_BASE_URL` | no | Override API base (default `https://api.soapnoteapi.com`) |\n\n## Develop\n\n```bash\npnpm install\npnpm --filter soapnoteapi-mcp dev     # run from source (tsx)\npnpm --filter soapnoteapi-mcp build   # compile to dist/\nnpx @modelcontextprotocol/inspector node dist/index.js   # interactive test\n```\n\n## Publish\n\n```bash\npnpm --filter soapnoteapi-mcp build\ncd packages/mcp && npm publish        # publishes soapnoteapi-mcp to npm\n```\n\n## License\n\nMIT\n",
  "bytes": 2409,
  "sha": "457922e294be2ba1038b51d768d241493d794edb931dbf70374e3fa4c422432e",
  "repo_slug": "soapnoteaicom/soapnoteapi-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_com_soapnoteapi_soapnoteapi_mcp_eecd9af8/readme"
}