orbb_list_personas
List the user’s saved persona profiles for this organization. Returns each persona’s id, name, departments, seniorities, titles, and excluded titles. Use the returned name (preferred) or id as the personas filter on orbb_search_people.
The full description your agent reads
The full description your agent reads
{ personas: [{ id, name, departments: Department[], seniorities: Seniority[], titles: string[], excludeTitles: string[] }] }.
orbb_search_people
Search people across identity, role, engagement, persona, lists, CRM/opportunity, account context, and (opt-in) graph predicates. Filters compose via AND, so fewer filters means broader results.
The full description your agent reads
The full description your agent reads
Returns
{ items: [...], count: number, has_more: boolean, total?: number, next_cursor?: string, warnings?: string[] }. Each item: id, link, name, title?, company?, city?, why?, seniority?, department?, email?, verified_profile?, last_interaction_at?, last_meeting_at?, meetings_total?, emails_total?, persona_matches?, lists?, in_crm?, open_opportunities?: [{ name?, stage?, amount_usd?, owner?: { name?, email? } }], connectors?: [{ type: "colleague"|"best_path", name, email?, score, company? }], top_connector? (same shape), raw_ids?: { contact_id, person_id }. Text content header: "Found N person(s):"; empty: "No people matched the filter.".
orbb_search_companies
Search companies / accounts as the unit (not individual people) across identity, account_type, opportunities, engagement aggregates, and (opt-in) graph predicates. Filters compose via AND — fewer filters means broader results.
The full description your agent reads
The full description your agent reads
Returns
{ items: [...], count, has_more, next_cursor?, warnings? }. Each item: id (the accountId for orbb_get_account_interactions), link, name, industry?, size?, account_type?, why?, domains?, account_owner?: { name?, email? } (detailed only; "Unassigned" = in CRM with no owner), tier?: 1|2, open_opportunities?, closed_opportunities?, last_interaction_at?, meetings_total?, top_contacts?: [{ name, title?, score }], raw_ids?: { account_id, crm_account_id? }.
orbb_find_connector_paths
Find the warmest connector paths (also called “introducers” or “warm intro paths”) through the relationship graph to a SINGLE target — either an account (target: { account_name }) or a specific person (target: { person_ref } with email or name). Prefer an email for person_ref and a domain for account_name whenever you have one — both resolve unambiguously, while names can match several records and come back as a disambiguation error.
The full description your agent reads
The full description your agent reads
Returns
{ target: { type: "account"|"person", name, id, link, image? }, paths: [ pathHop & { connectors?: (contactRef & { score? })[], target_contact?: contactRef } ] }. Each path/intro object: hops: string[], score: number, strength: string, line_labels: string[], connector_closeness_to_org?: number, composite_score: number, tier: 1|2|null, strength_basis: "composite" | "path_score_only", reasoning?: string[], raw_ids: Record<string,string>|null. Contact refs (contactRefShape): name, link?, email?, role?, avatar?, companyImage?, company?, seniority?: string|null, persona_matches?: string[]|null, segment: string|null (avatar/companyImage omitted in concise).
orbb_find_connector_paths_bulk
Find warm-introduction paths for MANY targets in one call. Use this instead of calling orbb_find_connector_paths in a loop — that tool is single-target and says so.
The full description your agent reads
The full description your agent reads
Returns
{ targets: [{ target: Record<string,string> (echoed), paths?: <same path shape as single>, problem?: string }], resolved: number, unresolved: number }.
orbb_find_connector_intros
Find who a SINGLE connector can introduce you to (the warm intros that person can make). Answers “who can X introduce me to?”.
The full description your agent reads
The full description your agent reads
Returns
{ connector: contactRef & { id }, intros: [ pathHop & { target_contact?: contactRef } ] }. line_labels holds exactly one strength label (single connector→target segment).
orbb_get_account_interactions
Recent two-way communication interactions (emails, calendar events, calls) for ONE account, identified by accountId.
The full description your agent reads
The full description your agent reads
Returns
{ accountId, link, name, interactions: [{ timestamp?, interactionType: "MSG_SENT"|"MSG_RECEIVED"|"EVENT_ATTENDED"|"CALL", subject? }], page?: { limit, returned, truncated } }.
orbb_get_contact_interactions
Recent two-way communication interactions (emails, calendar events, calls) for ONE person, identified by contactId. Covers every email address known for this person, so the history can include interactions from their earlier roles.
The full description your agent reads
The full description your agent reads
Returns
{ contactId, link, name, interactions: [...], page? } — same interaction shape as the account tool.