# Overview (/docs/api/mcp)



DecisionMaker.Email ships a [Model Context Protocol](https://modelcontextprotocol.io) server at `mcp.decisionmaker.email/mcp`. Connect it to Claude, Cursor, Claude Code, or any MCP-compatible AI client and look up executive emails without leaving the chat.

What you get [#what-you-get]

* **No API key management.** The client authorizes via OAuth 2.1. Sign in once with the same account you use on decisionmaker.email.
* **Seven tools exposed to the model.** Find email, check search status, list history, get cached results, check credits and stats.
* **Team-scoped.** Everything respects your team, credit balance, and plan.
* **No extra cost.** Credits are deducted the same way as direct API use.

How it works [#how-it-works]

1. Add the MCP URL (`https://mcp.decisionmaker.email/mcp`) to your AI client.
2. The client pops an OAuth consent screen. Sign in and approve.
3. The model can now call `dm_find_email` and the other six tools as needed.

Comparison with the API [#comparison-with-the-api]

Both paths talk to the same Convex backend and share credits, rate limits, and search history.

|             | MCP                                         | HTTP API                           |
| ----------- | ------------------------------------------- | ---------------------------------- |
| Auth        | OAuth 2.1 (browser sign-in)                 | Bearer API key                     |
| Who uses it | AI assistants (Claude, Cursor, Claude Code) | Your code, scripts, integrations   |
| URL         | `mcp.decisionmaker.email/mcp`               | `api.decisionmaker.email/api/v1/*` |
| Webhooks    | Not applicable (synchronous tool calls)     | Supported                          |

Next [#next]

* [Setup](/docs/mcp/setup): add the server to your AI client.
* [Tools](/docs/mcp/tools): full list of what the model can call.
