# Tools (/docs/api/mcp/tools)



Seven tools are exposed over MCP. The model decides when to call them based on the user's request. All tools are team-scoped.

dm_find_email [#dm_find_email]

Find an executive email at a company. Starts an AI-powered search, waits for completion, returns validated results.

**Inputs**

* `url` (string): company domain or URL
* `role` (string): one of 17 supported executive roles, see [Supported roles](/docs/api/endpoints/find-email#supported-roles)
* `forceRefresh` (boolean, optional): skip the team cache and run a fresh search

**Credit cost**: 1 credit. Refunded on failure or zero results. Cached searches are free. `forceRefresh: true` always costs 1 credit.

dm_get_search_status [#dm_get_search_status]

Check the current status of a specific email search by ID.

**Inputs**

* `searchId` (string)

**Credit cost**: free.

dm_search_history [#dm_search_history]

View recent email search history for the team.

**Inputs**

* `limit` (number, default 10, max 50)

**Credit cost**: free.

dm_get_results_by_domain [#dm_get_results_by_domain]

Get all previously found emails for a specific company domain.

**Inputs**

* `domain` (string)

**Credit cost**: free.

dm_get_credits [#dm_get_credits]

Check the team's credit balance.

**Inputs**: none.

**Credit cost**: free.

dm_get_unique_emails [#dm_get_unique_emails]

List all unique email addresses found across past searches on the team.

**Inputs**

* `limit` (number, default 20, max 50)

**Credit cost**: free.

dm_get_stats [#dm_get_stats]

Team stats in a single call: total searches, total unique emails found, and current credit balance.

**Inputs**: none.

**Credit cost**: free.