find_lookalike_companies
Find companies similar to one or more seed domains (for audience expansion).
Read audiences
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
Request template, not a complete runnable example. Replace placeholders, empty objects, arrays, and zero values with valid account-specific inputs. Read required fields and nested constraints in the full schema. Confirm the account, connected channels, and referenced assets before calling a write tool.
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.
{
"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.
{
"companies": [],
"reason": "[reason redacted]"
}Related
Other audiences tools: