npm package: @morbidcorp/heir
Description: HEIR Estate Planning MCP Server - AI-powered estate planning tools
Author: HEIR Labs
Latest version: 2.0.1

# @morbidcorp/heir

Model Context Protocol (MCP) server for the HEIR digital inheritance platform. Let AI coding assistants help you build estate planning solutions.

## Features

- **Contract Generation**: Generate inheritance smart contracts for EVM, Solana, and TON
- **Vault Management**: Create and manage secure inheritance vaults
- **Legal Documents**: Generate wills, trusts, and power of attorney documents
- **Jurisdiction Info**: Query inheritance laws for 100+ countries
- **AI Assistant**: Get estate planning guidance and recommendations

## Quick Start

### Cursor

[Install in Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=heir&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBtb3JiaWRjb3JwL2hlaXIiLCItLXRvb2xzPWFsbCJdLCJlbnYiOnsiSEVJUl9BUElfS0VZIjoiIn19)

Or manually add to `~/.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "heir": {
      "command": "npx",
      "args": ["-y", "@morbidcorp/heir", "--tools=all"],
      "env": {
        "HEIR_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}
```

### VS Code

Add to `.vscode/mcp.json`:

```json
{
  "servers": {
    "heir": {
      "command": "npx",
      "args": ["-y", "@morbidcorp/heir", "--tools=all"],
      "env": {
        "HEIR_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}
```

### Claude Desktop

Add to `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "heir": {
      "command": "npx",
      "args": ["-y", "@morbidcorp/heir", "--tools=all"],
      "env": {
        "HEIR_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}
```

### Claude Code

```bash
claude mcp add heir -- npx -y @morbidcorp/heir --tools=all
```

### Remote Server

Connect directly to our hosted MCP server (no install required):

```json
{
  "mcpServers": {
    "heir": {
      "url": "https://mcp.heir.es"
    }
  }
}
```

## Available Tools

### Contracts
- `heir_contract_list_templates` - List available inheritance templates
- `heir_contract_generate` - Generate a smart contract
- `heir_contract_estimate_gas` - Estimate deployment costs

### Vaults
- `heir_vault_list` - List your vaults
- `heir_vault_get` - Get vault details
- `heir_vault_create` - Create a new vault
- `heir_vault_update` - Update vault configuration

### Jurisdictions
- `heir_jurisdiction_list` - List supported countries
- `heir_jurisdiction_get` - Get country details
- `heir_jurisdiction_compare` - Compare jurisdictions
- `heir_jurisdiction_search` - Search by features

### Legal Documents
- `heir_legal_generate_will` - Generate a will
- `heir_legal_generate_trust` - Generate a trust document
- `heir_legal_generate_poa` - Generate power of attorney
- `heir_legal_list_templates` - List document templates

### AI Chat
- `heir_chat_estate_planning` - Ask estate planning questions
- `heir_chat_explain_template` - Explain legal frameworks
- `heir_chat_recommend_plan` - Get personalized recommendations

## Authentication

Get your API key at [heir.es/developers](https://heir.es/developers).

```bash
# Via environment variable
export HEIR_API_KEY=heir_pk_xxx
npx @morbidcorp/heir --tools=all

# Via command line
npx @morbidcorp/heir --tools=all --api-key=heir_pk_xxx
```

## Selective Tools

Enable only specific tool categories:

```bash
# Only contracts and jurisdictions
npx @morbidcorp/heir --tools=contracts,jurisdictions

# Everything
npx @morbidcorp/heir --tools=all
```

## Documentation

- [Full Documentation](https://docs.heir.es/mcp)
- [API Reference](https://docs.heir.es/api)
- [Tutorials](https://docs.heir.es/tutorials)

## Support

- Email: support@heir.es
- Telegram: [@heir_es](https://t.me/heir_es)
- GitHub: [heirlabs/heir-mcp](https://github.com/heirlabs/heir-mcp)

## License

MIT