find_lookalike_companies
Find companies similar to one or more seed domains (for audience expansion).
Read audiences
Returns data. Calling it changes nothing, so it is safe in an unattended loop.
What it does
Find companies similar to one or more seed domains (for audience expansion).
Company-level only. Use to expand a target list from known-good accounts.
RETURNS: {companies: [{domain, name, employee_range, industry, city, state}, ...]}.
Returns {companies: []} when none are found or targeting is not configured.Arguments
| Argument | Type | Notes | |
|---|---|---|---|
domains |
array | required | Seed company domains, e.g. ['metadata.io']. |
limit |
integer | Max lookalikes to return (default 10). |
Request
curl
curl -s -X POST https://mcp-server.metadata.io/mcp \
-H "Authorization: $METADATA_PAT" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-H "MCP-Protocol-Version: 2025-11-25" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"find_lookalike_companies","arguments":{"domains":[]}}}'Response
Recorded with these arguments. Enum values are the first the tool's own schema
declares; ids were fetched live from a list_ call immediately before.
arguments used
{
"domains": [
"metadata.io"
]
}Real, from the production server, in 136 ms. Values that identify a customer or disclose money are replaced with typed placeholders; keys, types and nesting are exactly as returned.
recorded response
{
"companies": [],
"reason": "[reason redacted]"
}Related
Other audiences tools: