{
  "info": {
    "name": "Findymail — mcp.ai",
    "description": "REST API for the Findymail MCP. Set {{apiKey}} to a workspace key (sk_live_…) created at https://mcp.ai/settings/api-keys.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{apiKey}}",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://api.mcp.ai/api/findymail",
      "type": "string"
    },
    {
      "key": "apiKey",
      "value": "sk_live_...",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "findymail_add_excluded_domain",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/add/excluded/domain",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "add",
            "excluded",
            "domain"
          ]
        },
        "description": "Tool to add domains to an exclusion list in Findymail. Use when you need to prevent email searches or verification for specific domains.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"domains\": \"\",\n  \"excluded_domain_list_id\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "findymail_create_exclusion_list",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/exclusion/list",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "exclusion",
            "list"
          ]
        },
        "description": "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": {
          "mode": "raw",
          "raw": "{\n  \"name\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "findymail_create_list",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/create/list",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "create",
            "list"
          ]
        },
        "description": "Tool to create a new contact list. Use when you need to organize contacts into a named list before adding them.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"name\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "findymail_delete_exclusion_list",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/delete/exclusion/list",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "delete",
            "exclusion",
            "list"
          ]
        },
        "description": "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": {
          "mode": "raw",
          "raw": "{\n  \"exclusion_list_id\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "findymail_delete_list",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/delete/list",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "delete",
            "list"
          ]
        },
        "description": "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": {
          "mode": "raw",
          "raw": "{\n  \"id\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "findymail_find_email_by_name",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/find/email/by/name",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "find",
            "email",
            "by",
            "name"
          ]
        },
        "description": "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": {
          "mode": "raw",
          "raw": "{\n  \"name\": \"\",\n  \"domain\": \"\",\n  \"webhook_url\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "findymail_get_contact_lists",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/contact/lists",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "contact",
            "lists"
          ]
        },
        "description": "Tool to retrieve all contact lists. Use when you need an overview of your existing Findymail lists.",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "findymail_get_credits",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/credits",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "credits"
          ]
        },
        "description": "Tool to check available API credits for your Findymail account. Use when you need to verify remaining credits before performing operations.",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "findymail_get_credits_summary",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/credits/summary",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "credits",
            "summary"
          ]
        },
        "description": "Tool to retrieve credits usage summary report for the authenticated account. Use when you need to check credits consumption over time.",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "findymail_get_credits_team_summary",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/credits/team/summary",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "credits",
            "team",
            "summary"
          ]
        },
        "description": "Tool to retrieve team credits usage summary report. Use when you need an overview of credit consumption across team members.",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "findymail_get_exclusion_list",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/exclusion/list",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "exclusion",
            "list"
          ]
        },
        "description": "Tool to retrieve a specific exclusion list by ID. Use when you need details about a particular exclusion list.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"exclusion_list_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "findymail_get_intellimatch_data",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/intellimatch/data",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "intellimatch",
            "data"
          ]
        },
        "description": "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": {
          "mode": "raw",
          "raw": "{\n  \"hash\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "findymail_get_intellimatch_status",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/intellimatch/status",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "intellimatch",
            "status"
          ]
        },
        "description": "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": {
          "mode": "raw",
          "raw": "{\n  \"hash\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "findymail_list_contacts",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/contacts",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "contacts"
          ]
        },
        "description": "Tool to retrieve contacts from a specified list (paginated). Use after selecting a list to fetch its contacts.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"id\": 0,\n  \"start\": 0,\n  \"length\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "findymail_list_excluded_domains",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/excluded/domains",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "excluded",
            "domains"
          ]
        },
        "description": "Tool to retrieve domains excluded from Intellimatch searches. Use when you need to view the current domain exclusion list.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"page\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "findymail_list_exclusion_lists",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/exclusion/lists",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "exclusion",
            "lists"
          ]
        },
        "description": "Tool to retrieve all exclusion lists for managing excluded websites from Intellimatch searches. Use when you need to view configured website exclusions.",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "findymail_remove_excluded_domain",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/remove/excluded/domain",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "remove",
            "excluded",
            "domain"
          ]
        },
        "description": "Tool to remove domains from the exclusion list. Use when you need to stop excluding specific domains from email search results.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"ids\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "findymail_search_intellimatch",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/search/intellimatch",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "search",
            "intellimatch"
          ]
        },
        "description": "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": {
          "mode": "raw",
          "raw": "{\n  \"limit\": 0,\n  \"query\": \"\",\n  \"config\": {}\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "findymail_update_exclusion_list",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/update/exclusion/list",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "update",
            "exclusion",
            "list"
          ]
        },
        "description": "Tool to update an existing exclusion list. Use when you need to rename or modify an exclusion list's properties.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"name\": \"\",\n  \"excluded_domain_list_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "findymail_update_list",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/update/list",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "update",
            "list"
          ]
        },
        "description": "Tool to update an existing contact list. Use when you need to rename a list or change its sharing settings.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"id\": 0,\n  \"name\": \"\",\n  \"isShared\": false\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "findymail_verify_email",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/verify/email",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "verify",
            "email"
          ]
        },
        "description": "Tool to verify the deliverability of an email address. Use when you need to confirm an email can receive messages before outreach.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"email\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    }
  ]
}