English Français العربية

EasyDocForms

Registre officiel Santé

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

Code source Site web Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « 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
Configuration 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>"
            }
        }
    }
}

Variables d'environnement

  • EASYDOCFORMS_API_KEY obligatoire secret EasyDocForms Partner API key (edfk_live_*), created under Settings → Integrations → Partner API
  • EASYDOCFORMS_BASE_URL Optional API base URL override

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  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

Questions fréquentes

Qu'est-ce que EasyDocForms ?

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

Comment installer EasyDocForms ?

Il s'exécute sur votre machine. Dans 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. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour EasyDocForms ?

Oui. Il attend EASYDOCFORMS_API_KEY, à renseigner dans sa configuration.

EasyDocForms est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient EasyDocForms ?

Il est publié par easydocforms. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.