English Français العربية

SOAPNoteAPI

السجل الرسمي الصحة

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

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package soapnoteapi-mcp
Claude Code 
claude mcp add soapnoteapi -e 'SOAPNOTEAPI_KEY=<your soapnoteapi_key>' -- npx -y soapnoteapi-mcp@0.1.1
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "soapnoteapi": {
            "command": "npx",
            "args": [
                "-y",
                "soapnoteapi-mcp@0.1.1"
            ],
            "env": {
                "SOAPNOTEAPI_KEY": "<your soapnoteapi_key>"
            }
        }
    }
}

متغيرات البيئة

  • SOAPNOTEAPI_KEY إلزامي سري SOAPNoteAPI Bearer key (snapi_sk_...). Get one at https://app.soapnoteapi.com

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. soapnoteapi-mcp
  2. Tools
  3. Setup
  4. Environment variables
  5. Develop
  6. Publish
  7. License

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)
{
  "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

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

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

الأسئلة الشائعة

ما هو SOAPNoteAPI؟

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

كيف أثبّت SOAPNoteAPI؟

يعمل على جهازك. في Claude Code: claude mcp add soapnoteapi -e 'SOAPNOTEAPI_KEY=<your soapnoteapi_key>' -- npx -y soapnoteapi-mcp@0.1.1. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج SOAPNoteAPI إلى مفتاح API؟

نعم. يتطلب SOAPNOTEAPI_KEY، وتضبطها في إعداداته.

هل SOAPNoteAPI مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون SOAPNoteAPI؟

ينشره soapnoteaicom. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.