Skip to main content
Glama
soapnoteaicom

soapnoteapi-mcp

Official

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

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}

Related MCP server: Medikode Medical Coding MCP Server

Setup

Get an API key at https://app.soapnoteapi.com (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-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

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

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

License

MIT

A
license - permissive license
-
quality - not tested
B
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • F
    license
    B
    quality
    D
    maintenance
    Enables AI-powered clinical decision support by integrating with athenahealth's API to access patient data, manage prescriptions, check drug interactions, and generate clinical assessments. Provides HIPAA-compliant healthcare workflows with comprehensive audit logging and data sanitization.
    Last updated
    14
    2
  • A
    license
    A
    quality
    B
    maintenance
    Healthcare billing AI for agents — 12 tools for ICD-10/CPT/HCPCS code lookup (80K+ codes), prior auth prediction, medical NER, claims validation, HIPAA compliance auditing, and provider/drug enrichment. Pay-per-call via credits or USDC.
    Last updated
    20
    212
    2
    MIT
  • F
    license
    -
    quality
    B
    maintenance
    Appendix turns any AI health conversation into a board-certified physician's opinion — with a real prescription when clinically appropriate. Search medical literature and submit a clinical encounter for review, all from your agent.
    Last updated
    1

View all related MCP servers

Related MCP Connectors

  • Physician-reviewed medical opinions and prescriptions for AI agents.

  • SaaS intelligence for AI agents. 5 unified tools cover 1,000+ services with 91-96% token savings.

  • Stripe-native marketplace where AI agents discover and pay per call for API services.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/soapnoteaicom/soapnoteapi-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server