# LinkedIn Email Finder — how to use (mcp.ai)

Find the work email of the people you found on LinkedIn. From a name and a company, it finds and verifies the address, locates the profile and the company page, extracts the profile's public data and also searches a lead database by job title, industry and size. Accepts lists in a single call. Hosted by the platform, no credentials, you pay per delivered result.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_linkedin_email?ms=1788152160000`
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. `linkedin_email_company_url`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/linkedin_email`
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/linkedin_email/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/linkedin_email/company/url` — Encontra a URL da página no LinkedIn de uma ou mais empresas a partir do nome ou do domínio. Aceita até 100 empresas por chamada. Cobrado só pelas URLs encontradas.
  - body: { companies: string[] }
- `POST https://api.mcp.ai/api/linkedin_email/count/companies` — Conta quantas empresas batem com um conjunto de filtros, sem trazer os dados e sem gastar crédito. Use antes de linkedin_email_search_companies para dimensionar a busca de graça.
  - body: { query: object }
- `POST https://api.mcp.ai/api/linkedin_email/count/people` — Conta quantas pessoas batem com um conjunto de filtros, sem trazer os dados e sem gastar crédito. Use sempre antes de linkedin_email_search_people para dimensionar a busca e ajustar os filtros de graç
  - body: { query: object }
- `POST https://api.mcp.ai/api/linkedin_email/find` — Descobre o e-mail profissional de uma ou mais pessoas a partir do nome e do domínio (ou nome) da empresa. Aceita até 100 pessoas por chamada e devolve o resultado item a item, com o nível de certeza. 
  - body: { people: object[], wait_seconds?: integer }
- `POST https://api.mcp.ai/api/linkedin_email/profile/url` — Encontra a URL do perfil no LinkedIn de uma ou mais pessoas a partir do nome mais a empresa ou o cargo. Use quando você tem o nome e quer chegar no perfil. Aceita até 100 pessoas por chamada. Cobrado 
  - body: { people: object[] }
- `POST https://api.mcp.ai/api/linkedin_email/reverse` — Descobre quem está por trás de um e-mail profissional, devolvendo a URL do perfil no LinkedIn. É o caminho inverso do linkedin_email_find. Aceita até 50 e-mails por chamada. É a tool mais cara do MCP,
  - body: { emails: string[] }
- `POST https://api.mcp.ai/api/linkedin_email/scan/domain` — Varre um domínio atrás dos e-mails de função, tipo contato@, comercial@ ou admin@. Aceita até 50 domínios por chamada. Cobrado só pelos domínios em que achou algum endereço.
  - body: { domains: string[], wait_seconds?: integer }
- `POST https://api.mcp.ai/api/linkedin_email/scrape/company` — Extrai os dados públicos de páginas de empresa no LinkedIn a partir da URL: setor, tamanho, sede, descrição. Precisa ser URL de empresa (linkedin.com/company/...). Aceita até 100 URLs por chamada. Cob
  - body: { urls: string[] }
- `POST https://api.mcp.ai/api/linkedin_email/scrape/profile` — Extrai os dados públicos de perfis do LinkedIn a partir da URL: cargo, empresa, experiência, formação. Precisa ser URL de perfil (linkedin.com/in/...). Aceita até 100 URLs por chamada. Cobrado só pelo
  - body: { urls: string[] }
- `POST https://api.mcp.ai/api/linkedin_email/search/companies` — Busca empresas na base de leads por setor, tamanho, faturamento, localização, crescimento de headcount e mais. Cobrado por resultado devolvido, então conte antes com linkedin_email_count_companies. Pa
  - body: { query: object, page_size?: integer, page_token?: string }
- `POST https://api.mcp.ai/api/linkedin_email/search/people` — Busca pessoas na base de leads por cargo, empresa, setor, localização, tempo de experiência e mais de 30 outros filtros. Cobrado por resultado devolvido, então conte antes com linkedin_email_count_peo
  - body: { query: object, page_size?: integer, page_token?: string }
- `POST https://api.mcp.ai/api/linkedin_email/verify` — Verifica se endereços de e-mail existem e entregam, com nível de certeza. Aceita até 100 e-mails por chamada. Cobrado por e-mail testado, mesmo quando o veredito é que o endereço não existe.
  - body: { emails: string[], wait_seconds?: integer }

## Example prompts
- "Find the work email of these 10 people (name + company) and tell me which are reliable"
- "Get the data of this profile: https://www.linkedin.com/in/example"
- "How many CTOs at software companies in Brazil are in the database?"

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