{"id":50428227,"url":"https://github.com/archetech/materna-link-mcp","last_synced_at":"2026-05-31T12:01:31.526Z","repository":{"id":353345851,"uuid":"1218383003","full_name":"archetech/materna-link-mcp","owner":"archetech","description":"MaternaLink MCP — Healthcare identity verification server for AI agents. Verify patients, caregivers, and medical teams using Archon decentralized identity. HIPAA-aware, FHIR-ready, stateless by design.","archived":false,"fork":false,"pushed_at":"2026-04-23T14:42:32.000Z","size":58,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-23T15:07:41.493Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/archetech.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-22T20:26:04.000Z","updated_at":"2026-04-23T14:44:58.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/archetech/materna-link-mcp","commit_stats":null,"previous_names":["archetech/materna-link-mcp"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/archetech/materna-link-mcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/archetech%2Fmaterna-link-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/archetech%2Fmaterna-link-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/archetech%2Fmaterna-link-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/archetech%2Fmaterna-link-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/archetech","download_url":"https://codeload.github.com/archetech/materna-link-mcp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/archetech%2Fmaterna-link-mcp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33730241,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-31T02:00:06.040Z","response_time":95,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-05-31T12:01:30.561Z","updated_at":"2026-05-31T12:01:31.502Z","avatar_url":"https://github.com/archetech.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# MaternaLink MCP\n\n\u003e **Healthcare Identity Verification for AI Agents**\n\u003e\n\u003e Verify patients, caregivers, and medical teams using Archon decentralized identity. HIPAA-aware, FHIR-ready, stateless by design.\n\n---\n\n## What It Does\n\nMaternaLink MCP gives any AI agent the ability to **verify healthcare identities** through the Model Context Protocol — without ever touching private keys, wallets, or PII.\n\nBuilt for the maternal health vertical where the stakes are highest: every identity decision affects a mother and her unborn child.\n\n```\n┌───────────────────────────────────────────────────┐\n│   AI Agent (OB assistant, nurse bot, scheduler)  │\n│         via MCP stdio or SSE transport           │\n└──────────────────┬────────────────────────────────┘\n                   │\n                   ▼\n┌───────────────────────────────────────────────────┐\n│        MaternaLink MCP Server (stateless)         │\n│  ┌─────────────────────────────────────────────┐  │\n│  │  verify-patient-identity                    │  │\n│  │  verify-caregiver                           │  │\n│  │  verify-medical-team                        │  │\n│  │  verify-credential                          │  │\n│  │  verify-delegation                          │  │\n│  │  create-challenge / verify-signature        │  │\n│  └──────────────────┬──────────────────────────┘  │\n│                     │ REST (fetch)                 │\n├─────────────────────┼─────────────────────────────┤\n│  Archon Gatekeeper  │  DID resolution             │\n│  (public API)       │  VC verification            │\n│                     │  Delegation records         │\n└─────────────────────┴─────────────────────────────┘\n```\n\n**✅ No wallet. No passphrase. No private keys. No PII handled.**\n\nThe server resolves and verifies DIDs through the public Archon Gatekeeper REST API — stateless by design. Full cryptographic verification (ECDSA signatures, vault claims) requires the Archon Keymaster wallet and is available as a production upgrade.\n\n---\n\n## Quick Start\n\n### Install\n\n```bash\ngit clone https://github.com/archetech/materna-link-mcp.git\ncd materna-link-mcp\nnpm install\nnpm run build\n```\n\n### Configure your MCP client\n\nAdd to your `mcp.json` (Cursor, Claude Desktop, Windsurf, etc.):\n\n```json\n{\n  \"mcpServers\": {\n    \"maternalink\": {\n      \"command\": \"node\",\n      \"args\": [\"/absolute/path/to/materna-link-mcp/dist/index.js\"],\n      \"env\": {\n        \"GATEKEEPER_URL\": \"https://archon.technology\"\n      }\n    }\n  }\n}\n```\n\n### Try it\n\nAsk your AI agent:\n\n\u003e \"Verify this patient DID: did:cid:bafyreibz4...\"\n\n\u003e \"Check if caregiver did:cid:bafyreiay3... is authorized for medical:read on patient did:cid:bafyreibz4...\"\n\n\u003e \"Verify all 4 members of the OB team\"\n\n---\n\n## Tools\n\n| Tool | Description | Maternal Health Use Case |\n|------|-------------|------------------------|\n| `verify-identity` | Resolve any `did:cid:...` via the gatekeeper | Confirm patient, provider, or agent exists |\n| `verify-credential` | Validate a VC's structure + issuer DID | Insurance card, pregnancy confirmation, prescriptions |\n| `verify-delegation` | Check if delegate DID is authorized for a scope | Partner accessing records, AI agent refilling Rx |\n| `create-challenge` | Generate a nonce for DID ownership proof | Prove you control this identity |\n| `verify-signature` | Verify a signed nonce against DID public keys | Authenticate before sensitive action |\n| `verify-medical-team` | Batch-verify a team of provider DIDs | Trust score for OB + nurse + anesthesiologist + AI |\n| `verify-patient-identity` | Selective-disclosure identity proof | Prove pregnancy/insurance/age without full PII |\n| `verify-caregiver` | Verify caregiver authorization for patient data | Partner, doula, nurse, AI coordinator |\n\n---\n\n## The MaternaLink Vision\n\nMaternaLink is a maternal health AI companion that bridges **consumer wellness** and **clinical medicine** — using one identity wallet, two audiences:\n\n| For Community | For Medical Systems |\n|---------------|---------------------|\n| Anonymous participation | HIPAA-grade verification |\n| \"BabyMama2026\" | \"Jane Smith, DOB 1990-03-15\" |\n| Share symptoms freely | Request prescription refills |\n| Zero PII exposed | Insurance + pharmacy integration |\n\n**The patient controls what each audience sees — from a single identity wallet.**\n\nThis MCP server provides the **identity verification layer** that makes this possible. The app facilitates medical transactions without holding PII. Lower liability. Better privacy. Regulatory unlock.\n\n### Why This Matters for Healthcare\n\n- **HIPAA** requires verified identity for PHI access\n- **DEA** requires verified identity for controlled substances\n- **State pharmacy boards** require verified patient-pharmacist relationship\n\nArchon flips the model:\n- App never sees your real name\n- Pharmacy sees your verified credential\n- **App facilitates without liability**\n\n---\n\n## Architecture\n\n### Stateless by Design\n\n```\nPatient DID ──→ Gatekeeper REST API ──→ DID Document\n                                          │\n                                          ├── verificationMethod (public keys)\n                                          ├── service endpoints (vault, insurance)\n                                          └── assertionMethod (signing capability)\n```\n\nThe server makes **no assumptions about persistence**. Every call resolves fresh from the gatekeeper. This means:\n\n- No database to manage\n- No session state to leak\n- No PII cached anywhere\n- Horizontally scalable\n\n### Production Upgrade Path\n\nFor deployments requiring **full cryptographic verification**:\n\n1. Add wallet initialization (`KeymasterClient.createWallet`)\n2. Unlock vault with `ARCHON_PASSPHRASE`\n3. Use `cipher.verify()` for ECDSA signature verification\n4. Use `vault.getCredential()` for claim verification\n\nThese layer into `MaternaLinkIdentityService` as a `FullStackIdentityService` without breaking the stateless interface.\n\n---\n\n## Demo Scripts\n\n| Script | What It Shows |\n|--------|---------------|\n| `demos/demo-patient.ts` | Verify a patient DID with selective disclosure |\n| `demos/demo-delegation.ts` | Verify caregiver authorization for patient data |\n| `demos/demo-team.ts` | Batch-verify an OB medical team |\n\nRun with:\n```bash\nnpm run dev -- demos/demo-patient.ts\nnpm run dev -- demos/demo-delegation.ts\nnpm run dev -- demos/demo-team.ts\n```\n\n---\n\n## File Structure\n\n```\nmaterna-link-mcp/\n├── src/\n│   ├── index.ts              # MCP server (stdio), tool definitions, handler routing\n│   ├── server-http.ts        # MCP server (HTTP/SSE), dual transport\n│   └── identity-service.ts   # Stateless service — all gatekeeper REST calls\n├── demos/\n│   ├── demo-patient.ts       # Patient identity verification demo\n│   ├── demo-delegation.ts    # Caregiver delegation verification demo\n│   └── demo-team.ts          # Medical team batch verification demo\n├── docs/\n│   ├── ARCHITECTURE.md       # Detailed architecture and data flow\n│   └── FHIR-INTEGRATION.md   # FHIR mapping and healthcare standards\n├── package.json\n├── tsconfig.json\n├── .gitignore\n└── README.md\n```\n\n---\n\n## Built On\n\n- **Archon Protocol** — W3C-compliant `did:cid` DID method with multi-registry architecture\n- **Model Context Protocol (MCP)** — Standard for AI tool integration\n- **Archon Gatekeeper** — Public REST API for DID resolution and verification\n\nKey Archon advantages for healthcare:\n- ✅ **P2P architecture** — No centralized identity provider\n- ✅ **Registry agnostic** — Bitcoin, Hyperswarm, Signet — choose your security/cost trade-off\n- ✅ **Open source** — Auditable, no vendor lock-in\n- ✅ **Selective disclosure** — Prove claims without exposing PII\n- ✅ **Verifiable delegation** — AI agents act with patient consent\n- ✅ **Audit trail** — Cryptographically signed for HIPAA compliance\n\n---\n\n## License\n\nApache-2.0 © 2026 Archetech\n\n---\n\n## Links\n\n- **Archon Protocol:** https://archon.technology\n- **Whitepaper:** https://github.com/archetech/archon/blob/main/docs/WHITEPAPER.md\n- **Archon MCP (generic):** https://github.com/archetech/archon-identity-mcp\n- **Gatekeeper MCP:** https://github.com/archetech/gatekeeper-mcp-server\n- **Issues:** https://github.com/archetech/materna-link-mcp/issues","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Farchetech%2Fmaterna-link-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Farchetech%2Fmaterna-link-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Farchetech%2Fmaterna-link-mcp/lists"}