# Findymail — MCP server on 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.

By: mcp.ai · official
Page: https://mcp.ai/findymail

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_findymail?ms=1787293560000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/findymail/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/findymail/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/findymail/skill.md
Postman collection (v2.1): https://mcp.ai/findymail/postman.json

## Tools
- findymail_add_excluded_domain(domains: string[], excluded_domain_list_id?: integer) — Tool to add domains to an exclusion list in Findymail. Use when you need to prevent email searches or verification for specific domains.
- findymail_create_exclusion_list(name: string) — Tool to create a new exclusion list for Intellimatch searches. Use when you need to filter out specific companies or contacts from search results.
- findymail_create_list(name: string) — Tool to create a new contact list. Use when you need to organize contacts into a named list before adding them.
- findymail_delete_exclusion_list(exclusion_list_id: integer) — 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.
- findymail_delete_list(id: integer) — 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.
- findymail_find_email_by_name(name: string, domain: string, webhook_url?: string) — 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.
- findymail_get_contact_lists() — Tool to retrieve all contact lists. Use when you need an overview of your existing Findymail lists.
- findymail_get_credits() — Tool to check available API credits for your Findymail account. Use when you need to verify remaining credits before performing operations.
- 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.
- 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.
- findymail_get_exclusion_list(exclusion_list_id: string) — Tool to retrieve a specific exclusion list by ID. Use when you need details about a particular exclusion list.
- findymail_get_intellimatch_data(hash: string) — 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.
- findymail_get_intellimatch_status(hash: string) — 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.
- findymail_list_contacts(id: integer, start?: integer, length?: integer) — Tool to retrieve contacts from a specified list (paginated). Use after selecting a list to fetch its contacts.
- findymail_list_excluded_domains(page?: integer) — Tool to retrieve domains excluded from Intellimatch searches. Use when you need to view the current domain exclusion list.
- 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.
- findymail_remove_excluded_domain(ids: integer[]) — Tool to remove domains from the exclusion list. Use when you need to stop excluding specific domains from email search results.
- findymail_search_intellimatch(limit?: integer, query: string, config?: object) — 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.
- findymail_update_exclusion_list(name: string, excluded_domain_list_id: string) — Tool to update an existing exclusion list. Use when you need to rename or modify an exclusion list's properties.
- findymail_update_list(id: integer, name: string, isShared: boolean) — Tool to update an existing contact list. Use when you need to rename a list or change its sharing settings.
- findymail_verify_email(email: string) — Tool to verify the deliverability of an email address. Use when you need to confirm an email can receive messages before outreach.

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

## Links
Docs: https://mcp.ai/docs/mcps/findymail
Website: https://mcp.ai/mcps/findymail