English Français العربية

EasyDocForms

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

Healthcare intake for agents: import blank PDFs, create patient fill links, fetch completed PDFs.

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

التثبيت

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

OCI package ghcr.io/easydocforms/easydocforms-mcp:0.1.2
Claude Code 
claude mcp add easydocforms -e 'EASYDOCFORMS_API_KEY=<your easydocforms_api_key>' -e 'EASYDOCFORMS_BASE_URL=<EASYDOCFORMS_BASE_URL>' -- docker run -i --rm ghcr.io/easydocforms/easydocforms-mcp:0.1.2
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "easydocforms": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "ghcr.io/easydocforms/easydocforms-mcp:0.1.2"
            ],
            "env": {
                "EASYDOCFORMS_API_KEY": "<your easydocforms_api_key>",
                "EASYDOCFORMS_BASE_URL": "<EASYDOCFORMS_BASE_URL>"
            }
        }
    }
}

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

  • EASYDOCFORMS_API_KEY إلزامي سري EasyDocForms Partner API key (edfk_live_*), created under Settings → Integrations → Partner API
  • EASYDOCFORMS_BASE_URL Optional API base URL override

التوثيق

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

المحتويات
  1. easydocforms-mcp
  2. The PHI boundary (read this first)
  3. Tools
  4. Install
  5. Try it
  6. Transport
  7. Development
  8. License

easydocforms-mcp

An MCP server for healthcare intake forms: give an AI agent the ability to turn a blank PDF intake packet into a hosted, mobile-friendly fillable form, hand the patient a link, and retrieve the completed, pixel-exact PDF — without any PHI ever entering the agent's context.

Built on EasyDocForms, whose document-understanding pipeline (field detection, checkbox semantics, consent blocks, signature models) runs healthcare intake in production. This server wraps the Partner API via the easydocforms-go SDK.

The PHI boundary (read this first)

This server is designed so protected health information never passes through the model:

  • Imports are blank forms only. import_pdf_from_url requires blank_form_attestation: true and takes a URL, never document bytes.
  • get_submission returns metadata and an answer count — never the patient's answers. Answers stay server-side, behind your API key.
  • get_completed_pdf_link returns a ~10-minute signed URL the agent can hand to a human or an EMR without exposing your API key. Treat it like a fax.
  • external_ref must never contain PHI — it's an opaque correlation id (your visit or order number).

Tools

ToolWhat it does
import_pdf_from_urlImport a blank PDF intake form (async; requires blank-form attestation)
get_import_statusPoll an import until its template is ready
list_templatesList the organization's active form templates
create_fill_linkMint a hosted URL where a patient fills the form
get_submissionSubmission metadata + answer count — never answers
get_completed_pdf_linkShort-lived signed download URL for the completed PDF

Install

go install github.com/easydocforms/easydocforms-mcp/cmd/easydocforms-mcp@latest

You'll need an API key from the EasyDocForms app: Settings → Integrations → Partner API (shown exactly once).

Or run the Docker image (no Go toolchain needed):

docker run -i --rm -e EASYDOCFORMS_API_KEY=edfk_live_... ghcr.io/easydocforms/easydocforms-mcp:latest
Claude Code
claude mcp add easydocforms --env EASYDOCFORMS_API_KEY=edfk_live_... -- easydocforms-mcp
Claude Desktop (or any MCP client)
{
  "mcpServers": {
    "easydocforms": {
      "command": "easydocforms-mcp",
      "env": { "EASYDOCFORMS_API_KEY": "edfk_live_..." }
    }
  }
}
Environment
VariableRequiredPurpose
EASYDOCFORMS_API_KEYyesedfk_live_* Partner API key
EASYDOCFORMS_BASE_URLnoAPI base URL override

Try it

With MCP Inspector:

EASYDOCFORMS_API_KEY=edfk_live_... npx @modelcontextprotocol/inspector easydocforms-mcp

A typical agent session: "Import the intake form at https://clinic.example.com/forms/new-patient.pdf (it's blank), then give me a fill link for visit 8675309." The agent imports, polls, mints a link with external_ref: "visit-8675309", and hands back a URL. After the patient submits, "Is the PDF for that visit ready?" → get_submission + get_completed_pdf_link.

Transport

stdio only, credentials from the environment — per the MCP spec's guidance for locally-run servers. A hosted remote variant (Streamable HTTP + OAuth 2.1) is planned as a second wave.

Development

go test ./... -race

License

MIT

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

ما هو EasyDocForms؟

Healthcare intake for agents: import blank PDFs, create patient fill links, fetch completed PDFs.

كيف أثبّت EasyDocForms؟

يعمل على جهازك. في Claude Code: claude mcp add easydocforms -e 'EASYDOCFORMS_API_KEY=<your easydocforms_api_key>' -e 'EASYDOCFORMS_BASE_URL=<EASYDOCFORMS_BASE_URL>' -- docker run -i --rm ghcr.io/easydocforms/easydocforms-mcp:0.1.2. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

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

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

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

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

من يصون EasyDocForms؟

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

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