# FindLeadEmails

> Find and verify B2B work emails, single or bulk. OAuth sign-in or API key; pay per verified email.

- name: com.findleademails/mcp
- version: 1.1.0
- connection class: R0 (autonomous)
- trust: 100/100
- quality: 94/100 (new)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/com.findleademails%2Fmcp
- tools: https://api.protogrid.dev/v1/servers/com.findleademails%2Fmcp/tools

**An agent can connect right now, no human step.** Remote endpoint, no authentication, reachable on the last probe.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "findleademails": {
      "type": "http",
      "url": "https://www.findleademails.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${api_key}"
      }
    }
  }
}
```

Placeholders to fill: `${api_key}`.

## Trust

- hygiene: 100
- liveness: 100
- freshness: 100
- provenance: 100
- drivers: +repository +namespace-matches-repo +dns-namespace +website +reachable +uptime-100% +updated-1d-ago
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 94/100 (new)

### protocol: 88 (weight 25)

- pass `protocol.modern`: supports 2026-07-28 (server/discover)
- pass `protocol.stateless`: answers without a session
- pass `protocol.transport`: streamable HTTP
- warn `protocol.list_ttl`: tools/list declares ttlMs 0, so clients re-fetch it on every use

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 100 (weight 30)

- pass `tools.descriptions`: every tool has a description
- pass `tools.description_length`: descriptions are concise
- pass `tools.schemas`: every tool has an object input schema
- pass `tools.annotations`: 6 of 6 tools declare readOnlyHint or destructiveHint
- pass `tools.directory_hints`: every tool declares readOnlyHint, destructiveHint, idempotentHint and openWorldHint
- pass `tools.token_cost`: about 1,383 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump

### stability: n/a (weight 15)

- n/a `stability.changes`, `stability.rug_pull`: tool history recorded for 1 of the 7 days needed

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package

- tools: 6, about 1,383 tokens to load them all
- tool set hash: 4db3cd28b62d40dc7d9070136f02877a
- tools last changed: 2026-10-19T14:08:38.305Z
- badge: [![protogrid quality](https://protogrid.dev/badge/com.findleademails/mcp.svg)](https://protogrid.dev/servers/com.findleademails/mcp)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

- 2026-10-19 `create_job` changed (description) **meaning changed**
  - before: Queue a large list for background processing and return a job id. This creates a job and reserves one credit per row up front. Unused credits are refunded as rows resolve. Poll get_job_status, then page get_job_results (results are readable while the job is still running). Each call creates a new job. It does not delete existing data.
  - after: Queue a large list and return a job id. Reserves one credit per row up front and refunds what rows do not use. If the wallet cannot cover every row, the job is refused up front (no partial queue) with insufficient_credits and https://www.findleademails.com/pricing. Poll get_job_status, then page get_job_results. Each call creates a new job.
- 2026-10-19 `find_emails_bulk` changed (description) **meaning changed**
  - before: Find and verify emails for a batch of people in one synchronous call. Capped at 100 rows. Use create_job for a larger list. Rows are grouped by domain so each company is resolved once. Billing matches find_email: 1 credit per verified result, and misses, catch-alls, and repeats are free. This spends workspace credits and stores the lookups. It does not delete data.
  - after: Find and verify emails for up to 100 people. Use create_job for a larger list. 1 credit per verified result. Free outcomes still return at 0 credits. Rows run until a billable result cannot be paid for; later rows are skipped with insufficient_credits and https://www.findleademails.com/pricing. This stores the lookups. It does not delete data.
- 2026-10-19 `verify_email` changed (description)
  - before: Check whether one email address is a real mailbox. Use this when you already have the address. Same mailbox check as find_email. Costs 1 credit only when the mailbox is confirmed valid. Invalid, catch-all, unknown, and a repeat check of the same address are free. The credit is spent after a valid result, not reserved up front. This does not delete or modify the mailbox.
  - after: Check whether one email address is a real mailbox. Costs 1 credit only when the mailbox is confirmed valid. Invalid, catch-all, unknown, and repeats are free and still return at 0 credits. A new valid mailbox fails at 0 balance; the error includes https://www.findleademails.com/pricing. The credit is spent after a valid result. This does not modify the mailbox.
- 2026-10-19 `find_email` changed (description)
  - before: Find and verify one person's work email from their name and company domain, or from a LinkedIn company page URL when you do not have the domain. The server checks likely addresses and confirms a mailbox before returning it. Costs 1 credit only when the result is verified. Misses, catch-all domains, and a repeat lookup of someone already found are free. This spends workspace credits and stores the lookup. It does not delete or modify the person's data.
  - after: Find and verify one person's work email from their name and company domain, or from a LinkedIn company page URL when you do not have the domain. Costs 1 credit only when the result is verified. Misses, catch-alls, and cached repeats are free and still return at 0 credits. A billable result fails at 0 balance; the error includes https://www.findleademails.com/pricing. This stores the lookup. It does not delete or modify the person's data.

Full history: https://api.protogrid.dev/v1/servers/com.findleademails%2Fmcp/changes

## Remotes

- https://www.findleademails.com/api/mcp (streamable-http, auth none, reachable true, uptime30d 1)

## Packages

_none_

## Tools (6)

- `create_job`: Queue a large list and return a job id. Reserves one credit per row up front and refunds what rows do not use. If the wallet cannot cover every row, the job is refused up front (no partial queue) with insufficient_credits and https://www.findleademails.com/pricing. Poll get_job_status, then page get_job_results. Each call creates a new job.
- `find_email`: Find and verify one person's work email from their name and company domain, or from a LinkedIn company page URL when you do not have the domain. Costs 1 credit only when the result is verified. Misses, catch-alls, and cached repeats are free and still return at 0 credits. A billable result fails at 0 balance; the error includes https://www.findleademails.com/pricing. This stores the lookup. It does not delete or modify the person's data.
- `find_emails_bulk`: Find and verify emails for up to 100 people. Use create_job for a larger list. 1 credit per verified result. Free outcomes still return at 0 credits. Rows run until a billable result cannot be paid for; later rows are skipped with insufficient_credits and https://www.findleademails.com/pricing. This stores the lookups. It does not delete data.
- `get_job_results`: Read one page of a job's per-row results. Readable while the job is still running. Pass cursor back as the next cursor until next_cursor is null. Does not spend credits and does not change the job.
- `get_job_status`: Read progress and per-outcome counters for a job created with create_job. Does not spend credits and does not change the job.
- `verify_email`: Check whether one email address is a real mailbox. Costs 1 credit only when the mailbox is confirmed valid. Invalid, catch-all, unknown, and repeats are free and still return at 0 credits. A new valid mailbox fails at 0 balance; the error includes https://www.findleademails.com/pricing. The credit is spent after a valid result. This does not modify the mailbox.
