@chrischall/myatriumhealth-mcp 0.0.0

package/.claude-plugin/marketplace.json

@@ -0,0 +1,35 @@
+{
+  "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
+  "name": "myatriumhealth-mcp",
+  "owner": {
+    "name": "Chris Hall",
+    "email": "chris.c.hall@gmail.com"
+  },
+  "metadata": {
+    "description": "MCP server for Angi \u2014 find home-service pros by trade and city, read ratings, reviews and pro profiles. Angi serves its pages only to a real browser, so requests route through the user's own angi.com tab via the fetchproxy browser extension, reusing their existing session. The trade/city taxonomy is read from Angi's public sitemaps directly.",
+    "version": "0.0.0"
+  },
+  "plugins": [
+    {
+      "name": "myatriumhealth-mcp",
+      "displayName": "MyAtriumHealth",
+      "source": "./",
+      "description": "Read MyAtriumHealth (Epic MyChart) records \u2014 test results, medications, allergies, immunizations, health issues, visits \u2014 by relaying requests through the user's signed-in browser tab via the fetchproxy bridge.",
+      "version": "0.0.0",
+      "author": {
+        "name": "Chris Hall"
+      },
+      "homepage": "https://github.com/chrischall/myatriumhealth-mcp",
+      "repository": "https://github.com/chrischall/myatriumhealth-mcp",
+      "license": "MIT",
+      "keywords": [
+        "mychart",
+        "epic",
+        "atrium-health",
+        "health-records",
+        "fetchproxy"
+      ],
+      "category": "productivity"
+    }
+  ]
+}

package/.claude-plugin/plugin.json

@@ -0,0 +1,22 @@
+{
+  "name": "myatriumhealth-mcp",
+  "displayName": "MyAtriumHealth",
+  "version": "0.0.0",
+  "description": "MyAtriumHealth (Epic MyChart) access for Claude \u2014 test results, medications, allergies, immunizations, visits",
+  "author": {
+    "name": "Chris Hall",
+    "email": "chris.c.hall@gmail.com"
+  },
+  "homepage": "https://github.com/chrischall/myatriumhealth-mcp",
+  "repository": "https://github.com/chrischall/myatriumhealth-mcp",
+  "license": "MIT",
+  "keywords": [
+    "angi",
+    "home-services",
+    "contractors",
+    "reviews",
+    "mcp"
+  ],
+  "skills": "./skills/",
+  "mcp": "./.mcp.json"
+}

package/.mcp.json

@@ -0,0 +1,14 @@
+{
+  "mcpServers": {
+    "myatriumhealth": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@chrischall/myatriumhealth-mcp"
+      ],
+      "env": {
+        "MAH_WS_PORT": "37149"
+      }
+    }
+  }
+}

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Chris Hall
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,97 @@
+# myatriumhealth-mcp
+
+MCP server for **MyAtriumHealth** — Atrium Health's [Epic MyChart](https://www.mychart.com/)
+patient portal at `my.atriumhealth.org`. Reads test results, medications, allergies,
+immunizations, health issues, goals and visits.
+
+> This project was developed and is maintained by AI. Use at your own discretion.
+> It reads personal health information, and only ever from the signed-in user's own account.
+
+## How it works
+
+Every MyChart cookie is `HttpOnly` and login is MFA-gated, so the session cannot be
+copied out of the browser and replayed from Node. Requests are therefore relayed
+through the user's own signed-in tab via the
+[fetchproxy](https://github.com/chrischall/fetchproxy) bridge and the Transporter
+extension, reusing their authenticated session. **The server never reads or stores the
+session cookie.**
+
+The portal's web app talks to a JSON API in two generations — modern
+`POST api/<area>/<Action>` and legacy form-encoded `POST <Area>/<Controller>/<Action>`.
+Both are documented, with live-captured shapes, in
+[`docs/MYATRIUMHEALTH-API.md`](docs/MYATRIUMHEALTH-API.md).
+
+## Install
+
+```jsonc
+{
+  "mcpServers": {
+    "myatriumhealth": {
+      "command": "npx",
+      "args": ["-y", "@chrischall/myatriumhealth-mcp"]
+    }
+  }
+}
+```
+
+Then sign in to `my.atriumhealth.org` in Chrome and call `mah_healthcheck`. The first
+call prints a pair code — approve it once in the Transporter popup.
+
+| Env | Default | Purpose |
+|---|---|---|
+| `MAH_WS_PORT` | `37149` | fetchproxy concentrator port. The whole fleet shares this one port; override only when hosting. |
+
+## Tools
+
+All read-only — this surface exposes no writes.
+
+| Tool | What it returns |
+|---|---|
+| `mah_list_allergies` | Allergies with reactions and severity |
+| `mah_list_health_issues` | The problem list |
+| `mah_list_immunizations` | Immunizations and dates, by organization |
+| `mah_list_medications` | Medications with dosing instructions (sig) and prescriber |
+| `mah_list_test_results` | Labs and imaging: name, abnormal flag, date, provider comments |
+| `mah_list_upcoming_visits` | Upcoming and in-progress appointments |
+| `mah_list_past_visits` | Past visits, grouped by organization |
+| `mah_list_goals` | Patient goals |
+| `mah_get_health_summary` | Health-summary header and action plans |
+| `mah_list_message_folders` | Message Center folders with unread counts |
+| `mah_get_menu` | Which portal features this account exposes |
+| `mah_healthcheck` | Bridge health, and whether the portal session is signed in |
+
+Listing tools take `compact` (default `false`). The raw envelopes are large — test
+results ~33 KB, medications ~30 KB — so pass `compact: true` when browsing. If the
+portal's shape drifts, the projection warns to stderr and returns the raw response
+rather than an empty list.
+
+## Sessions expire, and they do it quietly
+
+MyChart answers an **expired session with HTTP 200 whose body is the login page**, never
+a 401, and the JSON endpoints then return `{}`. Tools raise a "Not signed in" error with
+the remedy rather than reporting empty results. Sessions are short-lived; expect to sign
+in again between uses.
+
+## Without the MCP
+
+[`skills/myatriumhealth-fpx`](skills/myatriumhealth-fpx) does the same thing from a
+shell with the `fpx` CLI — no server to run. Its `references/endpoints.md` carries
+live-verified `jq` recipes for every endpoint here.
+
+## Known gap
+
+The message list (`api/conversations/GetConversationList`) is not yet reachable: it
+needs a page nonce plus organization handles that have not been pinned down. See
+`docs/MYATRIUMHEALTH-API.md`.
+
+## Development
+
+```sh
+npm install
+npm test          # typecheck + vitest
+npm run build
+```
+
+## License
+
+MIT