@morbidcorp/heir

Model Context Protocol (MCP) server for the HEIR digital inheritance platform.

Latest: 2.0.4 — self-contained stdio client (dist/cli.js) calling https://api.heir.es.

Install

npx -y @morbidcorp/[email protected]
# or
npm i -g @morbidcorp/[email protected]
heir-mcp

Node.js ≥ 18.

IDE config

{
  "mcpServers": {
    "heir": {
      "command": "npx",
      "args": ["-y", "@morbidcorp/[email protected]"],
      "env": {
        "HEIR_API_KEY": "heir_pk_..."
      }
    }
  }
}

| Env / flag | Purpose | |------------|---------| | HEIR_API_KEY / --api-key= | Developer API key (heir.es/developers) | | HEIR_API_URL / --api-url= | API base (default https://api.heir.es) | | --tools= | all or contracts,vaults,jurisdictions,legal,chat |

Tools (18)

| Category | Tools | HTTP | |----------|-------|------| | Contracts | heir_contract_* | /api/v1/contracts/* | | Estates | heir_vault_* | /api/v1/user/estates | | Jurisdictions | heir_jurisdiction_* | /api/v1/jurisdictions (public list/get) | | Legal | heir_legal_* | /api/v1/legal/generate, /types/:j | | Chat | heir_chat_* | /api/v1/chat with { messages: [...] } |

Docs: https://docs.heir.es/mcp/tools

Logging

All process logs go to stderr as JSON lines (level, message, tool, …). Stdout is reserved for the MCP protocol.

Rollback

npm install -g @morbidcorp/[email protected]   # previous
# or
npm deprecate @morbidcorp/[email protected] "reason"

Monorepo note

index.js in this directory is the Railway-hosted monorepo MCP (calculators + corpus). It is not the npm bin entry. npm consumers only get dist/.

Development

npm install
npm test          # unit + live integration against api.heir.es
npm run audit:prod

License

MIT