openEHR Assistant MCP Server

Tool Support
,
10

Update: v0.15.0 - What’s new

Since the last update shared here (v0.11.0), the project has continued to evolve.
Here’s a short summary of the most relevant improvements:

MCP Server (openehr-assistant-mcp)

The most significant additions since v0.11.0:

  • New tools: guide_adl_idiom_lookup (quick ADL constraint pattern lookup without
    prompting from scratch), plus expanded type_specification_search/get coverage.
    The server now exposes 10 MCP tools in total.
  • Expanded prompts: 15 guided MCP prompts now cover the full modeling lifecycle,
    from archetype and template design/review, through composition building, AQL query
    authoring, terminology resolution, and language translation/syntax fixing.
  • 27 implementation guides (Markdown resources served via openehr://guides/...)
    covering archetypes, templates, AQL, simplified formats (FLAT/STRUCTURED/CANONICAL),
    and RM structural concepts, a substantial expansion over the initial guide set.
  • Improved guide adherence and workflow fidelity: the server now reliably fetches
    relevant guides at the right workflow steps, rather than relying solely on initialization.
  • Compatibility extended: the hosted server works reliably with Claude, Cursor, and
    LibreChat; ChatGPT compatibility was also explored.

Introducing two companion projects

Alongside the MCP server, two new repositories have been published that significantly
extend usability:

openehr-assistant-plugin

An AI plugin suite for Claude Code and Cursor that adds the workflow layer
on top of the MCP server. It provides:

  • Skills that instruct the AI when and how to load guides and invoke MCP tools
    (e.g. archetype-authoring, archetype-lint with 22 normative rules,
    template-authoring using the CGEM framework, composition-builder, aql-query,
    demographic-modeling, platform-design).
  • Slash commands for common tasks: /archetype-search, /archetype-lint,
    /archetype-review, /template-explain, /aql-designer, /format-data,
    /ehr-structure, /terminology, /type-spec, /adl-idiom, and more.
  • A clinical-modeler agent for working directly with local archetype/template files
    in your workspace.
  • Offline reference material (ADL/AQL syntax cheatsheets, RM type reference) for when
    the MCP server is not available.

plugin-marketplace

A registry/marketplace of reusable AI plugins (Claude Code skills, Cursor rules, MCP
configs), of which openehr-assistant-plugin is the first published entry. It provides
a discoverable, versioned catalog so the community can share and find AI workflow
plugins, with the openEHR plugin serving as the reference implementation.

As always, feedback, issues, and PRs are very welcome. The guides in particular are an
area where input from experienced modelers would be most valuable, if something doesn’t
reflect actual CKM modeling practice, please open an issue or PR on the repo.