# Findymail — how to use (mcp.ai)

Connect your Findymail account and use 21 tools for email straight from your AI agent. Connect with your own API key. Findymail is a B2B email and phone data provider offering verified contact information, email verification, automated exports, and CRM enrichment to enhance sales prospecting and outreach efforts.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_findymail?ms=1787295960000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `findymail_add_excluded_domain`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/findymail`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/findymail/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/findymail/add/excluded/domain` — Tool to add domains to an exclusion list in Findymail. Use when you need to prevent email searches or verification for specific domains.
  - body: { domains: string[], excluded_domain_list_id?: integer }
- `POST https://api.mcp.ai/api/findymail/create/exclusion/list` — Tool to create a new exclusion list for Intellimatch searches. Use when you need to filter out specific companies or contacts from search results.
  - body: { name: string }
- `POST https://api.mcp.ai/api/findymail/create/list` — Tool to create a new contact list. Use when you need to organize contacts into a named list before adding them.
  - body: { name: string }
- `POST https://api.mcp.ai/api/findymail/delete/exclusion/list` — Tool to permanently delete an exclusion list by its ID. Use when you need to remove an exclusion list from Intellimatch. This action is irreversible.
  - body: { exclusion_list_id: integer }
- `POST https://api.mcp.ai/api/findymail/delete/list` — Permanently deletes a contact list by its ID. This action is irreversible and will also remove all contacts in the list. Returns 404 if the list does not exist.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/findymail/find/email/by/name` — Tool to find someone's email using their full name and company domain. Use when you have a person's name and domain and need their email address. Supports asynchronous search via webhook_url.
  - body: { name: string, domain: string, webhook_url?: string }
- `POST https://api.mcp.ai/api/findymail/get/contact/lists` — Tool to retrieve all contact lists. Use when you need an overview of your existing Findymail lists.
- `POST https://api.mcp.ai/api/findymail/get/credits` — Tool to check available API credits for your Findymail account. Use when you need to verify remaining credits before performing operations.
- `POST https://api.mcp.ai/api/findymail/get/credits/summary` — Tool to retrieve credits usage summary report for the authenticated account. Use when you need to check credits consumption over time.
- `POST https://api.mcp.ai/api/findymail/get/credits/team/summary` — Tool to retrieve team credits usage summary report. Use when you need an overview of credit consumption across team members.
- `POST https://api.mcp.ai/api/findymail/get/exclusion/list` — Tool to retrieve a specific exclusion list by ID. Use when you need details about a particular exclusion list.
  - body: { exclusion_list_id: string }
- `POST https://api.mcp.ai/api/findymail/get/intellimatch/data` — Tool to retrieve data from an Intellimatch search. Use after initiating a search with POST /api/intellimatch/search and confirming completion with GET /api/intellimatch/status.
  - body: { hash: string }
- `POST https://api.mcp.ai/api/findymail/get/intellimatch/status` — Tool to check the status of an Intellimatch search job. Use when you need to verify if an Intellimatch search has completed after initiating it.
  - body: { hash: string }
- `POST https://api.mcp.ai/api/findymail/list/contacts` — Tool to retrieve contacts from a specified list (paginated). Use after selecting a list to fetch its contacts.
  - body: { id: integer, start?: integer, length?: integer }
- `POST https://api.mcp.ai/api/findymail/list/excluded/domains` — Tool to retrieve domains excluded from Intellimatch searches. Use when you need to view the current domain exclusion list.
  - body: { page?: integer }
- `POST https://api.mcp.ai/api/findymail/list/exclusion/lists` — Tool to retrieve all exclusion lists for managing excluded websites from Intellimatch searches. Use when you need to view configured website exclusions.
- `POST https://api.mcp.ai/api/findymail/remove/excluded/domain` — Tool to remove domains from the exclusion list. Use when you need to stop excluding specific domains from email search results.
  - body: { ids: integer[] }
- `POST https://api.mcp.ai/api/findymail/search/intellimatch` — Tool to find companies and contacts using natural language queries. Use when you need to build targeted lead lists automatically by describing your ideal customer profile in plain language.
  - body: { limit?: integer, query: string, config?: object }
- `POST https://api.mcp.ai/api/findymail/update/exclusion/list` — Tool to update an existing exclusion list. Use when you need to rename or modify an exclusion list's properties.
  - body: { name: string, excluded_domain_list_id: string }
- `POST https://api.mcp.ai/api/findymail/update/list` — Tool to update an existing contact list. Use when you need to rename a list or change its sharing settings.
  - body: { id: integer, name: string, isShared: boolean }
- `POST https://api.mcp.ai/api/findymail/verify/email` — Tool to verify the deliverability of an email address. Use when you need to confirm an email can receive messages before outreach.
  - body: { email: string }

## Example prompts
- "What can I do in Findymail?"
- "Show me a summary of my Findymail account"

## More
- Page: https://mcp.ai/findymail
- Agent spec (llms.txt): https://mcp.ai/findymail/llms.txt
- Postman collection: https://mcp.ai/findymail/postman.json