Skip to main content
The workspace server answers from your organization’s own data in Orbb — the people and accounts in your connected CRM, email, calendar and calls, and who on your team knows them. Every tool is read-only and free. It signs in with OAuth only, and your organization needs MCP access turned on.
Ids flow between tools: a company from orbb_search_companies gives the accountId for orbb_get_account_interactions and the target for orbb_find_connector_paths; a person from orbb_search_people gives the contactId for orbb_get_contact_interactions; orbb_list_personas gives the names personas takes. Pass next_cursor back as cursor to page; a search cursor lasts 30 minutes.

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.
Takes no arguments. Returns { 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.
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.
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.
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.
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?”.
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.
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.
Returns { contactId, link, name, interactions: [...], page? } — same interaction shape as the account tool.