Model Context Protocol Integration

Connect AI coding assistants directly to HEIR's estate planning tools through the Model Context Protocol (MCP).

What is MCP?

The Model Context Protocol (MCP) is an open standard that enables AI assistants to securely connect to external services. HEIR's MCP server allows AI coding tools like Cursor, VS Code, and Claude Desktop to access our estate planning and legal intelligence capabilities.

Quick Start

For Cursor IDE

📲 Configure in Cursor

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

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

For VS Code

Install the MCP extension and then configure HEIR:

{
  "mcp.servers": {
    "heir": {
      "url": "https://mcp.heir.es"
    }
  }
}

For Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "heir": {
      "command": "npx",
      "args": ["-y", "@heir/mcp", "--tools=all"],
      "env": {
        "HEIR_API_KEY": "<<YOUR_API_KEY>>"
      }
    }
  }
}

Available Tools

Tool	Description	Use Case
get_jurisdiction	Get legal system information for any country	Research inheritance laws
list_jurisdictions	List all supported legal jurisdictions	Explore global coverage
generate_contract	Generate inheritance smart contracts	Create blockchain wills
estimate_gas	Calculate deployment costs	Budget contract deployment
search_heir_documentation	Search HEIR knowledge base	Find answers about estate planning

Authentication

All MCP tools require authentication using your HEIR API key. Get your API key here.

export HEIR_API_KEY="heir_pk_..."

Example Usage

Once connected, you can ask your AI assistant questions like:

• "What are the inheritance laws in Germany?"
• "Generate a smart contract for my crypto estate"
• "How much will it cost to deploy a contract on Ethereum?"
• "Show me estate planning options for Islamic law"

The AI assistant will automatically use the appropriate HEIR tools to provide accurate, up-to-date information.

Benefits

For Developers

• Seamless Integration: No manual API calls or documentation lookup
• Real-time Data: Always current legal information and gas prices
• Multi-chain Support: Ethereum, Polygon, Base, Avalanche, and Solana
• Legal Intelligence: 11 legal frameworks across 195+ jurisdictions

For Legal Professionals

• AI-Powered Research: Instant access to global inheritance laws
• Client Solutions: Generate contracts and documents on demand
• Compliance: Up-to-date regulatory information
• Efficiency: Reduce manual research time by 90%

Next Steps

1. Set up authentication
2. Explore available tools
3. Configure your IDE

Support

• Documentation: This site
• Community: Telegram
• Issues: GitHub
• Email: support@heir.es