# openEHR Assistant MCP Server **Category:** [Tool Support](https://discourse.openehr.org/c/tool-support/29) **Created:** 2026-01-22 09:26 UTC **Views:** 119 **Replies:** 9 **URL:** https://discourse.openehr.org/t/openehr-assistant-mcp-server/11701 --- ## Post #1 by @sebastian.iancu Hi all, I’d like to share something I’ve been working on for a while: an **openEHR Assistant MCP Server**. As you all know, I am a very firm believer in what openEHR has to offer as a standard. However, I am very much aware of the fact that developing and modelling according to the openEHR Specifications is not easy... Which may discourage developers and modellers new to the openEHR Community. **What does it do?** The openEHR Assistant MCP Server exposes openEHR knowledge artefacts and modelling workflows to LLM-based assistants, using the Model Context Protocol. By combining deterministic tools, canonical resources, and guided prompts, it supports exploration, comparison, explanation, and early-stage archetype or template design, while remaining aligned with openEHR semantics and governance. I’ve written an article about it, which you can read here: https://www.cadasto.com/the-openehr-assistant-mcp-server/ I hope that this assistant may help those in need of a hand to get started. I have made the project available on [GitHub](https://github.com/cadasto/openehr-assistant-mcp). Do check it out and let me know what you think - thanks! --- ## Post #2 by @siljelb Thank you so much for publishing and hosting this very useful tool, Sebastian! :raising_hands: I'm wondering, and forgive me if it's actually already doing this, but could it be possible to incorporate the kind of information contained in the child pages of https://openehr.atlassian.net/wiki/x/AQAqEg? That could be very useful if using an LLM to model archetypes. If possible, which format would be the best for ingesting the information? --- ## Post #3 by @sebastian.iancu Thanks, good suggestion. It contains now a very small and compacted version of those pages but also others, in a form of "guides", in markdown format. Guides are exposed as resources an referred in system prompts - that's the way it gets used. I am often tweaking them and trying to measure impact or looking of improvements - but it is a slow going process, so it will take a bit more time a some versions. I already have prepare some new materials for upcoming versions, and I will reconsider also those you indicated. Also hoping some others will also help on this (hence open source state), as you know ...it is not always easy to review the modeling process internals when you are not doing modeling :slight_smile: ... --- ## Post #4 by @siljelb Thanks, that's good to hear! My thinking about those resources is that they are living documents and will continue receiving updates into the future. Is there a way to connect the MCP server directly to the documents (or a different version of them) so that you or someone else don't need to update things manually all the time? --- ## Post #5 by @sebastian.iancu That would be possible: - you can fork the repo, make you change and once you'll push on your github, out might have another docker image, which (if you have docker) you could run it locally - there is some doc about `--transport=stdio` in the readme.md file. - if you have docker locally, you can also just clone the repo locally, make your chnages, then build the image, then host it somewhere or run it with the same `--transport=stdio` - this is the way I tested and developed in the last week developing. Most of these MCP clients (Claude, cursor, Librechat) allows running it locally, sometime labelled as dev-mode. But I will be happy having feedback, PRs, etc. --- ## Post #6 by @pablo Hi, it’s nice to see the AI movement reached openEHR :) We are doing some tests with embeddings, but it’s for a different use case: to understand the models created (templates, archetypes) to derive other elements, like queries. --- ## Post #7 by @erik.sundvall [quote="sebastian.iancu, post:3, topic:11701"] . It contains now a very small and compacted version of those pages but also others, in a form of “guides”, in markdown format. [/quote] How were the guides under https://github.com/Cadasto/openehr-assistant-mcp/tree/main/resources/guides created? --- ## Post #8 by @sebastian.iancu Mostly by summarizing (using ChatGPT and Claude) the ADL/AOM Specifications, and then combining it with similar summarization (by Rovo) of the relevant Wiki pages we have. The initial structure (so the way I choose to organize it in files, folders etc) is mostly from me, aligned also how the application code is designed, trying to reuse some concepts and make them maintainable. Of course, not all of these went well right form the beginning, I had to try several prompts and tasks until I got something workable, and then I still need to read carefully and edit myself the texts, as sometimes is "not focused" let's put it that way. But nevertheless, the guides are still subject to my lack of knowledge/experience with the modeling process, so I would invite anyone more "connected" to review them and help improve them. --- ## Post #9 by @sebastian.iancu I’ve made some improvements, released a new version (0.11.0). It is now adhering much better to the guides in the repo : whatever the required workflow is, it will stick to relevant rules and workflow much better; you may also see some new tool calls to fetch the guides at certain moments. The output of tasks looks to me also generally better, but there might be some bias or perhaps the model itself inproved. I also manage to get it working with Chatgpt (yet it is still not used as easy as with Claude). In case you already have a previous version installed, I would suggest reinstalling or reconnecting, as some changes are related to the initialization and registration phase, besides the new tools provided. --- ## Post #10 by @sebastian.iancu ## 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](https://github.com/Cadasto/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](https://github.com/Cadasto/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](https://github.com/Cadasto/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. --- **Canonical:** https://discourse.openehr.org/t/openehr-assistant-mcp-server/11701 **Original content:** https://discourse.openehr.org/t/openehr-assistant-mcp-server/11701