# goaimoat-decision-maker-lookup-mcp

Find the person to contact at a company, then get a verified work email.

Built for agents doing B2B outreach: a model can name a company, but it cannot look up
who works there or reach a deliverable address.

- **Hosted (no install):** `https://contacts.mcp.goaimoat.com/mcp`
- **Registry name:** `com.goaimoat/decision-maker-lookup`
- **Free:** 3 calls per email. Then a $29/yr license.

## The two-step design

| Step | Tool | Cost |
|---|---|---|
| 1. Search | `find_decision_makers(company)` | **Free** — returns people with `decision_maker` / `phone_number_exists` / `linkedin_exists` flags, addresses masked |
| 2. Reveal | `reveal_work_email(reveal_handle)` | **Paid** — turns one selected row into a verified address |

You size the job before spending anything: search first, filter to the decision-makers you
actually want, then reveal only those rows. `get_balance()` shows remaining credit.

## Use the hosted endpoint

```json
{
  "mcpServers": {
    "decision-maker-lookup": {
      "type": "streamable-http",
      "url": "https://contacts.mcp.goaimoat.com/mcp"
    }
  }
}
```

Then call `find_decision_makers` with your `email` — no key, no signup for the first 3 calls.

## Run it yourself

Requires a `MONID_API_KEY` (the upstream data provider). Get one at [monid.ai](https://monid.ai).

### Docker

```bash
docker build -t goaimoat-decision-maker-lookup-mcp .
docker run --rm -i -e MONID_API_KEY=your_key goaimoat-decision-maker-lookup-mcp
```

Runs on **stdio** by default — what directory scanners (Glama and similar) use for introspection.

### Local

```bash
pip install -r requirements.txt
MONID_API_KEY=your_key python server.py
```

Without `MONID_API_KEY` the server still starts and answers introspection; tool calls return a
clear "no credential configured" error rather than fabricating a result.

## Note on parameters

Upstream parameter names were verified live with
`monid inspect -p hunterio -e /multi-domain-search` — the field is **`company_name`**, not
`company`. Guessing parameter names against an undocumented endpoint is how this kind of
server silently returns HTTP 400, so this repo pins the verified ones.

## Part of GoAI Moat

A suite of MCP servers giving agents data they cannot reach themselves: verified work
emails, company records, Google search, and web scraping.

- Catalog: https://goaimoat.com/mcp-catalog.html
- All servers (monorepo): https://github.com/jayniebingyu-cyber/goaimoat-mcp

## License

MIT