Skip to main content
Glama
mcp-company-contact-details-extractor

mcp-company-contact-details-extractor

Company Contact Details Extractor MCP Server

Glama score MCP Registry npm version npm downloads license mcpservers.org

An MCP server that finds a company contact page and extracts role emails, a phone number and a postal address. It wraps the Mamba Labs Company Role Email, Phone and Address Finder actor on Apify and returns a Clay-ready flat JSON row to any MCP client.

What's Inside

Related MCP server: mcp-github-organization-signal-scanner

What it does

Give it a company domain and it finds that company's contact page, then returns the role email addresses published on it, a main phone number in E.164 where the country resolves, and a postal address. One flat row per company.

Named individuals are never returned. An address is kept only when its domain belongs to the company and its local part is in the role vocabulary, so info@, support@, sales@ and privacy@ survive and a person's address is dropped by an allow list rather than by a name detector. The row reports how many addresses were found and how many were rejected and why, so a thin result is never mistaken for a site that publishes nothing.

All of the extraction runs on Apify. This package is a thin client that calls the actor and hands back the result unchanged.

Quick start

You need Node.js 18 or newer and an Apify account with an API token.

Add this to your Claude Desktop config:

{
  "mcpServers": {
    "mamba-company-contact-details-extractor": {
      "command": "npx",
      "args": ["-y", "@mambalabsdev/mcp-company-contact-details-extractor"],
      "env": {
        "APIFY_TOKEN": "your-apify-token"
      }
    }
  }
}

Get your token at https://console.apify.com/account/integrations, paste it in, and restart Claude Desktop. The extract_company_contact_details tool will be available.

Prerequisites

  • Node.js 18 or newer

  • An Apify account with an API token

Example prompts

  • "Find the contact details for stripe.com."

  • "Get the sales email for figma.com and skip the phone number."

  • "Pull contact details for this local plumbing company and allow free mailboxes."

  • "Extract the support address for notion.com, reading a second page if the contact page has nothing."

Inputs

  • company_domain (required by this tool): bare company domain, for example stripe.com. This is the lookup key and the join key for every other actor in the fleet. The tool returns an error naming the field when it is missing, before any run starts.

  • company_name (optional): used in the row and in logging. This tool gates addresses on the email domain rather than on the company name, so supplying a name does not change which addresses are kept.

  • emailTypes (optional): which classes of role address to return. One of all, general, support, sales, privacy, general_support or sales_only. all is the default and returns general, support, sales and privacy. The narrower settings return only what they name and leave the other columns null, which is a different answer from not finding one.

  • includePhones (optional): when true (the default) the contact page is scanned for a main phone number. Set false to skip phone extraction entirely.

  • includeAddress (optional): when true (the default) a postal address is read from JSON-LD first and from the footer second. Set false to skip it.

  • allowFreeMailboxes (optional): when false (the default) an address at Gmail, Outlook or another free provider is rejected, because it cannot be checked against the company domain. Set true for small business and local company lists, where a free mailbox on the contact page is often the real contact point.

  • crawlDepth (optional): how many pages to read after the homepage. 1 (the default) reads the contact page. 2 also reads a support or legal page when the contact page yielded nothing. This is a cost and thoroughness dial, not a change of answer.

  • skipCache (optional): when false (the default) a successful lookup is cached for seven days and reused. Set true to force a fresh fetch.

  • max_charge_usd (optional): a cost cap in USD for this run. The actor stops before an item that could take its charges past this amount. Omit it to rely on the maximum cost per run set in Apify.

How a call runs

The tool starts the actor run and polls it to a finished status, so a long run is not cut off at 300 seconds. The run is allowed 1,800 seconds. If it is still going two minutes after that, the call stops waiting and returns the run ID with a link to it in the Apify Console, where the results land when it finishes. A run that does not succeed comes back as an error with its run ID and status.

Output

The tool returns the actor's flat JSON row for the company, with 27 snake_case fields and no nested objects. emails_rejected_count and emails_rejected_reasons account for what was dropped, contact_page_method says how the contact page was found, and fetch_status says whether the read succeeded. See the Apify Store page for the full output schema.

Example output

{
  "degraded": false,
  "degradation_reason": null,
  "company_domain": "stripe.com",
  "company_name": "Stripe",
  "contact_page_url": "https://stripe.com/contact/sales",
  "contact_page_method": "footer_anchor",
  "contact_page_confidence": 0.85,
  "email_general": null,
  "email_support": null,
  "email_sales": "sales@stripe.com",
  "email_privacy": null,
  "emails_found_count": 7,
  "emails_rejected_count": 6,
  "emails_rejected_reasons": "foreign_domain=5, not_a_role_address=1",
  "phone_main": null,
  "phone_source": null,
  "phone_page": null,
  "address_line": null,
  "address_city": null,
  "address_country": null,
  "address_source": null,
  "address_page": null,
  "contact_form_url": null,
  "pages_read": 2,
  "coverage": 0.2,
  "fetch_status": "ok",
  "run_date": "2026-08-22T19:23:48.675Z"
}

Features

  • Role email addresses only, never a named individual

  • Main phone number and postal address when the company publishes them

  • Contact page URL, plus how that page was found

  • Rejection accounting in emails_rejected_reasons, so a thin read is visible

  • Coverage reported per row

  • 27 flat snake_case fields, one row per company

Pricing

Price per event on the Apify FREE plan, from the live pricing record; paid Apify plans pay less per event.

Event

Price (USD)

Actor Start (apify-actor-start)

0.00005

Company checked (company-checked)

0.0035

Contact page found (contact-page-found)

0.0025

Email extracted (email-extracted)

0.003

Full actor documentation

This server is a thin client and holds no extraction logic. For the complete input and output reference, pricing, and run history, see the Apify Store page:

https://apify.com/mambalabs/company-contact-details-extractor


Mamba Labs GTM Suite

This server is one of the Mamba Labs GTM Suite MCP servers. Every actor in the suite takes a domain or a company and returns one flat row, so they stack in the same Clay table without reshaping anything. The actor behind this server is the Company Contact Details Extractor, immutable Apify actor ID 4mMncKaJykiq94grz.

Built by Mamba Labs | npm | Apify Store

License

MIT

Built by Mamba Labs. https://apify.com/mambalabs

Available Tools

1 tool
extract_company_contact_detailsExtract Company Contact DetailsA
Read-onlyIdempotent

Find a company's contact page from its domain and extract classified ROLE email addresses (general, support, sales, privacy), a main phone number in E.164 where the country resolves, and a postal address. Returns one flat Clay ready row. Named individuals are NEVER returned: an address is kept only when its domain belongs to the company and its local part is in the role vocabulary, so a person's address is dropped by an allow list rather than by a name detector. The row reports how many addresses were found and how many were rejected and why, so a thin result is never mistaken for a site that publishes nothing. Read only; requires an APIFY_TOKEN and consumes Apify credits per call.

NameRequiredDescriptionDefault
skipCacheNoWhen "false" (default) a successful lookup is cached for seven days and reused, which costs you nothing on a repeated run. Set "true" to force a fresh fetch. Sent as a string for Clay compatibility.
crawlDepthNoHow many pages to read after the homepage. "1" (default) reads the contact page. "2" also reads a support or legal page when the contact page yielded nothing. This is a cost and thoroughness dial, not a change of answer. Sent as a string for Clay compatibility.
emailTypesNoWhich classes of role address to return. "all" (default) returns general, support, sales and privacy. The narrower settings return only what they name and leave the other columns null, which is a different answer from not finding one. Sent as a string for Clay compatibility.
company_nameNoOptional. Used in the row and in logging. This actor gates addresses on the email DOMAIN rather than on the company name, so supplying a name does not change which addresses are kept.
includePhonesNoWhen "true" (default) the contact page is scanned for a main phone number. Set "false" to skip phone extraction entirely, which leaves the phone columns null. Sent as a string for Clay compatibility.
company_domainNoBare company domain, for example stripe.com. Needed on every call: the tool returns an error naming this field when it is missing. It is the join key for every other actor in the fleet.
includeAddressNoWhen "true" (default) a postal address is read from JSON-LD first and from the footer second. Set "false" to skip it. Sent as a string for Clay compatibility.
allowFreeMailboxesNoWhen "false" (default) an address at gmail, outlook or another free provider is rejected, because it cannot be checked against the company domain. Set "true" for small business and local company lists, where a free mailbox on the contact page is often the real contact point. Sent as a string for Clay compatibility.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 1 tool updatev1.1.1
    • Changedextract_company_contact_details2 fields changed
      • removedInput schema / additionalProperties
        Removed value: -false
      • changedInput schema / properties / company_domain / description
        Previous value: -"Bare company domain, for example stripe.com. This is the only required input and it is the join key for every other actor in the fleet."New value: +"Bare company domain, for example stripe.com. Needed on every call: the tool returns an error naming this field when it is missing. It is the join key for every other actor in the fleet."
  2. 1 tool updatev1.0.0
    • First observedextract_company_contact_details

TDQS

A4.4/5.0

Scored across 1 tool

Disambiguation5/5

With a single tool there is no possibility of misselection; its purpose (find a company's contact page from a domain and extract role emails, phone, and postal address) is stated unambiguously in both name and description.

Naming Consistency5/5

The lone name, extract_company_contact_details, follows a clear verb_noun_object snake_case pattern and is descriptive of the action and resource. There are no other names to conflict with it.

Tool Count3/5

The server is narrowly scoped and the single monolithic tool does address that scope end-to-end, but one tool is thin for a surface that handles discovery, extraction, validation, rejection reporting, and output formatting in one call.

Completeness4/5

For its stated purpose the tool covers the full pipeline (email roles, E.164 phone with country resolution, postal address) and even reports rejected addresses with reasons, avoiding false-thin results. Minor gaps exist, e.g. no bulk/multi-domain input or parameterization for selective extraction.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    B
    maintenance
    MCP server for the Mamba Labs People Finder & Email Verifier actor on Apify. Give it a company domain, name or LinkedIn URL and it returns the people at that company who match your role, seniority and department filters, each as a structured contact record with an optional verified business email.
    1
    301 npm
    MIT