# HeirPros MCP Server

> For AI agents: a documentation index is available at [https://heirpros.com/llms.txt](https://heirpros.com/llms.txt). This page is also available as markdown at [https://heirpros.com/developers/mcp.md](https://heirpros.com/developers/mcp.md).

The HeirPros MCP server lets AI assistants estimate the research hours for a probate heir search. It is free, needs no API key, returns hours only (no pricing) and does not email or store anything you send.

## Server URL

```
https://heirpros.com/mcp
```

Transport: Streamable HTTP. Authentication: none.

## Tools

| Tool | What it does |
| --- | --- |
| `estimate_heir_search_hours` | Estimates the research hours for a probate heir search from the number of known heirs (1 to 100) and estimated unknown heirs (1 to 25). Hours only, no pricing. |
| `about_heirpros` | What HeirPros does, who it serves, how the research is done and how to request a search. |

**Formula:** estimated hours = 1.5 + known heirs + estimated unknown heirs. It matches our [heir search quote calculator](https://heirpros.com/heir-search-quote-calculator/).

## Setup

### Hermes Agent

```bash
hermes plugins install heirpros
hermes plugins enable heirpros
```

### Claude Code

```bash
claude mcp add --transport http heirpros https://heirpros.com/mcp
```

### Claude (web and desktop)

Go to Settings, then Connectors, then Add custom connector. Name it HeirPros and paste the server URL.

### Cursor, Windsurf and other MCP clients

```json
{
  "mcpServers": {
    "heirpros": {
      "type": "http",
      "url": "https://heirpros.com/mcp"
    }
  }
}
```

## Example

```
Ask your assistant:
"Estimate the hours for an heir search with 4 known heirs
 and about 3 unknown heirs."

Answer from the tool:
{
  "estimated_hours": 8.5,
  "total_heirs": 7,
  "known_heirs": 4,
  "unknown_heirs": 3,
  "method": "1.5 base hours plus 1 hour per known and estimated unknown heir.",
  "note": "This is an estimate. Final hours are confirmed by HeirPros before work starts."
}
```

## Source and plugin

The plugin files (plugin.json, mcp.json and skill) are on GitHub: [github.com/nbandan/heirpros-mcp](https://github.com/nbandan/heirpros-mcp).

## Privacy

The server does not store or email anything. Each request is answered and discarded. See our [privacy policy](https://heirpros.com/privacy-policy/).

## Related

Need a REST API with an API key instead? See the [Quickstart](https://heirpros.com/developers/quickstart/).
