Skip to main content
Glama

HirePulse B2B Company Research

Public Company Contacts

extract_company_contacts
Read-only

Company contact lookup from a domain: published emails and LinkedIn, X and GitHub links from the home, about, contact, team and careers pages, deduplicated, plus MX, SPF and DMARC records. Not mailbox verification. Use when an agent needs public company contact data for outreach research. $0.01 only when an email is found; a result with no email is free.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "domain": "<domain>"
    },
    "name": "extract_company_contacts"
  }
}

Input Schema

NameRequiredDescriptionDefault
domainYesBare public company domain whose published contact pages and DNS records should be inspected.
contextNoOptional. A few words on why you are calling this tool. Recorded without your identity to improve the tools; leave out personal data.

Output Schema

NameRequiredDescriptionDefault
mxNo
spfNo
codeNo
dmarcNo
domainNo
emailsNo
statusNo
sandboxNo
social_linksNo
email_deliverableNo
inferred_email_patternNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed3 schema fields changed
    • removedOutput schema / anyOf
      Removed value: -[
      -  {
      -    "properties": {
      -      "dmarc": {
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "domain": {
      -        "type": "string"
      -      },
      -      "email_deliverable": {
      -        "type": "boolean"
      -      },
      -      "emails": {
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "inferred_email_pattern": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "mx": {
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "sandbox": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "demo_domain": {
      -            "const": true,
      -            "type": "boolean"
      -          },
      -          "note": {
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "demo_domain",
      -          "note"
      -        ],
      -        "type": "object"
      -      },
      -      "social_links": {
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "spf": {
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "status": {
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "domain",
      -      "status"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": true,
      -    "properties": {
      -      "code": {
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "status": {
      -        "maximum": 599,
      -        "minimum": 400,
      -        "type": "integer"
      -      }
      -    },
      -    "required": [
      -      "status",
      -      "code"
      -    ],
      -    "type": "object"
      -  }
      -]
    • addedOutput schema / description
      Added value: +"Fields only; full schema in GET /v1/catalog."
    • addedOutput schema / properties
      Added value: +{
      +  "code": {},
      +  "dmarc": {},
      +  "domain": {},
      +  "email_deliverable": {},
      +  "emails": {},
      +  "inferred_email_pattern": {},
      +  "mx": {},
      +  "sandbox": {},
      +  "social_links": {},
      +  "spf": {},
      +  "status": {}
      +}
  2. Changed3 schema fields changed
    • addedOutput schema / anyOf
      Added value: +[
      +  {
      +    "properties": {
      +      "dmarc": {
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "domain": {
      +        "type": "string"
      +      },
      +      "email_deliverable": {
      +        "type": "boolean"
      +      },
      +      "emails": {
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "inferred_email_pattern": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "mx": {
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "sandbox": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "demo_domain": {
      +            "const": true,
      +            "type": "boolean"
      +          },
      +          "note": {
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "demo_domain",
      +          "note"
      +        ],
      +        "type": "object"
      +      },
      +      "social_links": {
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "spf": {
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "status": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "domain",
      +      "status"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": true,
      +    "properties": {
      +      "code": {
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "status": {
      +        "maximum": 599,
      +        "minimum": 400,
      +        "type": "integer"
      +      }
      +    },
      +    "required": [
      +      "status",
      +      "code"
      +    ],
      +    "type": "object"
      +  }
      +]
    • removedOutput schema / description
      Removed value: -"Fields only; full schema in GET /v1/catalog."
    • removedOutput schema / properties
      Removed value: -{
      -  "code": {},
      -  "dmarc": {},
      -  "domain": {},
      -  "email_deliverable": {},
      -  "emails": {},
      -  "inferred_email_pattern": {},
      -  "mx": {},
      -  "sandbox": {},
      -  "social_links": {},
      -  "spf": {},
      -  "status": {}
      -}
  3. Changed3 schema fields changed
    • removedOutput schema / anyOf
      Removed value: -[
      -  {
      -    "properties": {
      -      "dmarc": {
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "domain": {
      -        "type": "string"
      -      },
      -      "email_deliverable": {
      -        "type": "boolean"
      -      },
      -      "emails": {
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "inferred_email_pattern": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "mx": {
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "sandbox": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "demo_domain": {
      -            "const": true,
      -            "type": "boolean"
      -          },
      -          "note": {
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "demo_domain",
      -          "note"
      -        ],
      -        "type": "object"
      -      },
      -      "social_links": {
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "spf": {
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "status": {
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "domain",
      -      "status"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": true,
      -    "properties": {
      -      "code": {
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "status": {
      -        "maximum": 599,
      -        "minimum": 400,
      -        "type": "integer"
      -      }
      -    },
      -    "required": [
      -      "status",
      -      "code"
      -    ],
      -    "type": "object"
      -  }
      -]
    • addedOutput schema / description
      Added value: +"Fields only; full schema in GET /v1/catalog."
    • addedOutput schema / properties
      Added value: +{
      +  "code": {},
      +  "dmarc": {},
      +  "domain": {},
      +  "email_deliverable": {},
      +  "emails": {},
      +  "inferred_email_pattern": {},
      +  "mx": {},
      +  "sandbox": {},
      +  "social_links": {},
      +  "spf": {},
      +  "status": {}
      +}
  4. Changed1 schema field changed
    • changedOutput schema / anyOf
      Previous value: -[
      -  {
      -    "properties": {
      -      "dmarc": {
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "domain": {
      -        "type": "string"
      -      },
      -      "email_deliverable": {
      -        "type": "boolean"
      -      },
      -      "emails": {
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "inferred_email_pattern": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "mx": {
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "social_links": {
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "spf": {
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "status": {
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "domain",
      -      "status"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": true,
      -    "properties": {
      -      "code": {
      -        "minLength": 1,
      -        "type": "string"
      -      },
      -      "status": {
      -        "maximum": 599,
      -        "minimum": 400,
      -        "type": "integer"
      -      }
      -    },
      -    "required": [
      -      "status",
      -      "code"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "properties": {
      +      "dmarc": {
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "domain": {
      +        "type": "string"
      +      },
      +      "email_deliverable": {
      +        "type": "boolean"
      +      },
      +      "emails": {
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "inferred_email_pattern": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "mx": {
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "sandbox": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "demo_domain": {
      +            "const": true,
      +            "type": "boolean"
      +          },
      +          "note": {
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "demo_domain",
      +          "note"
      +        ],
      +        "type": "object"
      +      },
      +      "social_links": {
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "spf": {
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "status": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "domain",
      +      "status"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": true,
      +    "properties": {
      +      "code": {
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "status": {
      +        "maximum": 599,
      +        "minimum": 400,
      +        "type": "integer"
      +      }
      +    },
      +    "required": [
      +      "status",
      +      "code"
      +    ],
      +    "type": "object"
      +  }
      +]
  5. First observed

TDQS

A4.5/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations only declare readOnlyHint and openWorldHint; the description adds genuinely non-obvious behavior: which page set is scraped, that results are deduplicated, that DNS records are included, and an unusual outcome-based price ($0.01 only when an email is found, free otherwise). It does not cover rate limits or failure modes, but the cost model disclosure is the kind of detail agents actually need.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Front-loaded with the outcome, then the scope, then the negative boundary, then the price model. It is dense with signal and contains no filler or restatement of the title.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a two-parameter read-only lookup with a full output schema, everything an agent needs is present: what it returns, where it looks, what it is not, the billing condition, and when to reach for it. Return-value structure is correctly left to the output schema.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the baseline is 3; the description earns an extra point by clarifying what inspecting a "bare public company domain" actually entails (specific page paths and DNS record types). The optional context parameter is left entirely to the schema, which is acceptable given full coverage.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource (company contact lookup from a domain) and enumerates exactly what is returned: published emails plus LinkedIn, X and GitHub links scraped from named page types, deduplicated, along with MX/SPF/DMARC records. It also explicitly carves itself off from mailbox verification, so an agent can distinguish it from verification-style siblings without opening a schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

"Use when an agent needs public company contact data for outreach research" gives a concrete usage context, and "Not mailbox verification" supplies an exclusion. It stops short of naming a specific alternative tool to use instead when verification is what's wanted, but the boundary is clear enough to route on.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.