List hygieneFree

extract_emails

Extract email addresses from text

Pull every email address out of a block of free-form text, optionally deduped and lowercased. Free.

Get an API key + 100 free credits Connect the MCP server

When an agent uses extract_emails

Use extract_emails when an agent has unstructured text — a pasted document, a web page, an email signature, a chat log — and needs the addresses out of it as clean data. It returns the unique addresses plus a domain breakdown, which is a natural input to clean_email_list and then verification. Costs no credits.

REST endpoint

POST /api/v1/extract

Credit cost

Free

Input schema

Field	Type	Required	Description
`text`	string	required	Free-form text to scan for email addresses.
`deduplicate`	boolean	optional	Remove duplicate addresses. Default true.
`lowercase`	boolean	optional	Lowercase all extracted addresses. Default true.

Call it over MCP

An MCP client invokes the tool with a tools/call request. Hosted clients send this to https://verifly.email/mcp with your Authorization: Bearer vf_… header; the verifly-mcp-server package does the same with VERIFLY_API_KEY set.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "extract_emails",
    "arguments": {
      "text": "Reach us at john@example.com or jane@test.com.",
      "deduplicate": true
    }
  }
}

Posting that same call straight to the hosted endpoint:

curl -s -X POST "https://verifly.email/mcp" \
  -H "Authorization: Bearer vf_your_api_key" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"extract_emails","arguments":{"text":"Reach us at john@example.com or jane@test.com.","deduplicate":true}}}'

Equivalent raw REST call

Under the hood this tool calls POST /api/v1/extract. If you are not using MCP, hit the REST API directly:

curl -s -X POST "https://verifly.email/api/v1/extract" \
  -H "Authorization: Bearer vf_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"text":"Reach us at john@example.com or jane@test.com.","options":{"deduplicate":true}}'

What you get back

A JSON object with count, the emails array, and a stats block (total_matches, unique_count, domains_found, top_domains).

Required input: text.

Related tools

clean_email_list

Dedupe, drop invalid syntax, and optionally strip disposable and role accounts — no verification, free.

Open verify_batch

Synchronously verify a small list (up to a few hundred) and get a verdict per address in one call.

Open verify_email

Real-time deliverability verdict for one email — valid / invalid / risky / unknown with detailed flags.

Open

Use extract_emails in your agent

Verifly is the only email verifier with a hosted MCP server plus autonomous agent self-registration. An agent can call register_account for an instant key and 100 free credits, then start calling extract_emails — no human, no dashboard.

Connect the MCP server Read the agent guide