{
  "info": {
    "name": "Icypeas — mcp.ai",
    "description": "REST API for the Icypeas 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/icypeas",
      "type": "string"
    },
    {
      "key": "apiKey",
      "value": "sk_live_...",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "icypeas_bulk_email_search",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/bulk/email/search",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "bulk",
            "email",
            "search"
          ]
        },
        "description": "Initiate a bulk email search job to find professional email addresses for multiple people at once. Use this tool when you need to find emails for more than one person. Provide names (first and/or last",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"data\": \"\",\n  \"name\": \"\",\n  \"task\": \"\",\n  \"custom\": {}\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "icypeas_bulk_find_profile_urls",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/bulk/find/profile/urls",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "bulk",
            "find",
            "profile",
            "urls"
          ]
        },
        "description": "Tool to perform bulk search for profile URLs based on firstname, lastname, and company/domain or job title. Use when you need to find LinkedIn or other social profile URLs for multiple prospects at on",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"data\": \"\",\n  \"type\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "icypeas_bulk_reverse_email_lookup",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/bulk/reverse/email/lookup",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "bulk",
            "reverse",
            "email",
            "lookup"
          ]
        },
        "description": "Tool to find LinkedIn profile URLs for multiple professional email addresses in a single request. Use when you need to reverse lookup 2-50 email addresses to find their associated LinkedIn profiles. E",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"data\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "icypeas_bulk_scrape",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/bulk/scrape",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "bulk",
            "scrape"
          ]
        },
        "description": "Tool to scrape multiple LinkedIn profiles or companies in bulk (up to 50 per request). Use when you need to scrape multiple LinkedIn URLs at once. Returns a job ID that can be used with check_progress",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"data\": \"\",\n  \"type\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "icypeas_check_progress",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/check/progress",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "check",
            "progress"
          ]
        },
        "description": "Check the processing progress of a search by its ID. Use this tool after initiating a single or bulk search to monitor its status. For mode='single': Checks progress of individual search items via /bu",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"id\": \"\",\n  \"mode\": \"\",\n  \"next\": false,\n  \"type\": \"\",\n  \"limit\": 0,\n  \"sorts\": \"\",\n  \"status\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "icypeas_count_companies",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/count/companies",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "count",
            "companies"
          ]
        },
        "description": "Tool to count companies in Icypeas database matching specified filters without returning data or being charged. Use when you need to know how many companies match specific criteria like industry, loca",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"query\": {}\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "icypeas_count_people",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/count/people",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "count",
            "people"
          ]
        },
        "description": "Tool to count people matching specified filters without retrieving data or consuming credits. Use when you need to assess the size of a people search result set before running the actual query.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"query\": {}\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "icypeas_domain_scan",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/domain/scan",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "domain",
            "scan"
          ]
        },
        "description": "Tool to scan a domain for role-based email addresses. Use when you need to discover all role-based emails for a specific domain.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"custom\": {},\n  \"domainOrCompany\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "icypeas_fetch_bulk_search_info",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/fetch/bulk/search/info",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "fetch",
            "bulk",
            "search",
            "info"
          ]
        },
        "description": "Retrieve bulk search files with their status and progress. Lists all bulk searches (email, profile, company searches) with pagination support. Use to monitor bulk operation progress, check completion ",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"file\": \"\",\n  \"next\": false,\n  \"limit\": 0,\n  \"sorts\": \"\",\n  \"status\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "icypeas_fetch_subscription_info",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/fetch/subscription/info",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "fetch",
            "subscription",
            "info"
          ]
        },
        "description": "Retrieves subscription details and remaining credits for an Icypeas account. Use this to check credit balances, subscription status, and user ID before performing searches. The email parameter must ma",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"email\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "icypeas_find_companies",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/find/companies",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "find",
            "companies"
          ]
        },
        "description": "Tool to search companies in Icypeas database. Use when you need to find companies matching filters like industry, location, or headcount.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"query\": {},\n  \"pagination\": {}\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "icypeas_find_company_url",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/find/company/url",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "find",
            "company",
            "url"
          ]
        },
        "description": "Tool to find a single company profile URL using a company name or domain. Use when you need to initiate a profile-URL search for a given company identifier.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"companyOrDomain\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "icypeas_find_linkedin_profile_by_email",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/find/linkedin/profile/by/email",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "find",
            "linkedin",
            "profile",
            "by",
            "email"
          ]
        },
        "description": "Find the LinkedIn profile URL behind a single professional email address. Use when you need to identify the person associated with an email address. Costs 10 credits per found profile.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"email\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "icypeas_find_people",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/find/people",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "find",
            "people"
          ]
        },
        "description": "Search for people/leads in the Icypeas database. Supports filtering by name, job title, company, location, skills, languages, school, and keywords. Each filter supports include/exclude lists. Returns ",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"query\": {},\n  \"pagination\": {}\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "icypeas_find_profile_url",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/find/profile/url",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "find",
            "profile",
            "url"
          ]
        },
        "description": "Finds a person's LinkedIn profile URL using their name and company or job title. Use this tool when you need to find someone's LinkedIn profile URL. Provide the person's first name, last name, and eit",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"jobTitle\": \"\",\n  \"lastname\": \"\",\n  \"firstname\": \"\",\n  \"companyOrDomain\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "icypeas_find_single_email",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/find/single/email",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "find",
            "single",
            "email"
          ]
        },
        "description": "Initiates an asynchronous email search to find a prospect's email address using their name and company. Returns a search item ID that can be used with ICYPEAS_RETRIEVE_SEARCH_RESULTS to get the actual",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"custom\": {},\n  \"lastname\": \"\",\n  \"firstname\": \"\",\n  \"domainOrCompany\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "icypeas_parse_bulk_search_statistics",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/parse/bulk/search/statistics",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "parse",
            "bulk",
            "search",
            "statistics"
          ]
        },
        "description": "Tool to parse bulk search statistics webhook. Use when processing the completion notification of a bulk search.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"data\": {},\n  \"signature\": \"\",\n  \"timestamp\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "icypeas_retrieve_search_results",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/retrieve/search/results",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "retrieve",
            "search",
            "results"
          ]
        },
        "description": "Tool to retrieve the results of a search by ID or to paginate through bulk search results. Use after initiating a search to fetch individual or multiple search results.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"id\": \"\",\n  \"file\": \"\",\n  \"mode\": \"\",\n  \"next\": false,\n  \"type\": \"\",\n  \"limit\": 0,\n  \"sorts\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "icypeas_scrape_company",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/scrape/company",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "scrape",
            "company"
          ]
        },
        "description": "Tool to initiate scraping of a LinkedIn company page. Use when you have a LinkedIn company URL and need to retrieve company profile data. Returns a job ID that can be used with check_progress to fetch",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"url\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "icypeas_scrape_profile",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/scrape/profile",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "scrape",
            "profile"
          ]
        },
        "description": "Tool to initiate scraping of a LinkedIn profile. Use when you have a public LinkedIn profile URL and need a job ID and status to later fetch full details.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"url\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "icypeas_setup_notifications",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/setup/notifications",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "setup",
            "notifications"
          ]
        },
        "description": "Provides instructions for setting up Icypeas push notifications/webhooks. Use this tool when you need to configure real-time notifications for bulk searches or single search updates. Note: Webhooks mu",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "icypeas_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 if a specific email address exists and is valid. Use when you need to check email deliverability. Returns a verification item ID that can be used with ICYPEAS_RETRIEVE_SEARCH_RESULTS to",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"email\": \"\",\n  \"custom\": {}\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    }
  ]
}