Find Overlap Partners
find_overlap_partnersFull Description
Returns a list of partners, sorted by partner-level metrics such as partner_score or deal_size_with_partner. Use for any question whose answer is a list of partners — "which partners...", "who else is selling into X", "which of our partners work with Y", "who has X as a customer". The named company in these questions is the account being looked up against the user's partner ecosystem.
If the user asks for accounts instead (the inverse direction: "which accounts do we share with X", "what overlapping companies do we have with Y"), use find_overlaps. The deciding signal is the shape of the question — partners-out vs accounts-out — not which company is named.
Identify the account by at least one of: account_id (direct), account_name (fuzzy), or account_domain (fuzzy). account_id bypasses fuzzy matching; name and domain may be combined to narrow on both. Optionally filter the partners with partner_ids or partner_name, or narrow to a partner tag with partner_tag_id or partner_tag_name; omit all to get every partner that shares the account.
Always pass the user's exact wording in name fields and let the tool fuzzy-match. Do not substitute IDs from memory. Ambiguous names come back in a single ClarificationRequired listing each candidate; present them to the user, then retry with the confirmed id fields.
Use sort_by + sort_order to rank partners; page + limit for pagination.
Parameters (0 required, 11 optional)
account_domainstringOwn account domain (fuzzy matched). Useful when the user mentions a company by URL or email domain. Same ClarificationRequired flow as account_name.
nullaccount_idstringOwn CRM account ID. Retry parameter; takes precedence over account_name and account_domain and skips fuzzy matching. Supply after the user confirms which account they meant.
nullaccount_namestringOwn account name (fuzzy matched). Use the user's exact wording on the first call, but strip trailing sales suffixes ('opp', 'opportunity', 'deal', 'account') and pass only the underlying entity — 'the Acme Corp opp' → 'Acme Corp'. If ClarificationRequired is returned, present the candidate accounts and ask the user which one they meant; retry with account_id.
nulllimitintegerNumber of partner rows per page (1-100, default 10).
10pageintegerPage number to retrieve (1-indexed, default 1).
1partner_idsarrayPartner organization UUIDs. Retry parameter; takes precedence over partner_name and skips name resolution. Pass one UUID to filter to a single partner, or several to filter to a set. No error if combined with partner_name.
nullpartner_namestringPartner organization name (fuzzy matched). Omit to include all partners. If ClarificationRequired is returned, present the candidate partners and retry with partner_ids.
nullpartner_tag_idstringPartner tag UUID. Retry parameter; takes precedence over partner_tag_name and skips name resolution. Filters to partners carrying this tag.
nullpartner_tag_namestringPartner tag name (fuzzy matched), e.g. 'Strategic' or 'Tier 1'. Filters to partners carrying that tag. If ClarificationRequired is returned, present the candidate tags and retry with partner_tag_id.
nullsort_bystringPartner-level metric to sort by. Omit for default ordering.
nullsort_orderstringSort direction ('asc' or 'desc'). Only used when sort_by is provided.
null