Icebreaker

Lookup the viewer's profile and all connected profiles (LinkedIn, etc.). This tool fetches comprehensive profile data for the current viewer using the search query: - socialPaths: ["icebreaker/viewer_pkid"] - sources: ["all"] - ordinality: ["Global"] - limit: 100 Returns all profiles associated with the viewer across platforms including: - Primary profile information - All connected social profiles (LinkedIn, GitHub, etc.) - Work history and experience across platforms - Contact information and social links **viewerPkid is ALWAYS provided** from the OAuth access token (urn:icbk-mcp:user_pkid) for this endpoint. The results are automatically cached locally in ~/.icebreaker/viewer_cache/ for future reference.

lookup_viewer_tool

Create a list or add/remove members or update name/description/share_state. Actions: create (name + social_paths required; optional team_domain for team lists), add_members, remove_members (list_id + social_paths), update (list_id + name and/or description and/or share_state). On create, owner and creator are always your pkid; team_domain is optional. System lists (creator: icebreaker) cannot be modified. **viewerPkid is ALWAYS provided** from the OAuth access token (urn:icbk-mcp:user_pkid) for this endpoint. Every POST to the lists API includes `viewer` (your pkid) in the JSON body. Create also sends owner and creator as your pkid, with optional domain for team lists. After a successful create (or any action returning an `id`), construct and surface the list URL: - Personal lists: https://app.icebreaker.xyz/lists/{id} - Team lists (when `team_domain` was provided): https://app.icebreaker.xyz/teams/{team_domain}/lists/{id}

manage_list_tool

Return the caller's plan, subscription status, and per-feature Schematiq limits.

get_entitlements_tool

Queue a social path for syncing the viewer's social graph. Use when the user wants to sync their LinkedIn, Twitter, or GitHub network. Accepts a social path in the form channel/identifier (e.g. linkedin/johndoe, twitter/handle, github/octocat). For self-queue (no collaborator_pkid), team_domain is optional: when omitted, the server resolves it automatically from the current viewer context; pass team_domain only to override. Optional collaborator_pkid queues a sync on behalf of a team collaborator. Pass collaborators[].pkid from get_team_collaborators when present (only for icebreaker/{pkid} collaborators), or icebreaker/{pkid}. When collaborator_pkid is set: - team_domain is required in the API request: pass team_domain explicitly, or rely on automatic resolution on pre-configured profile mounts. It is forwarded as teamDomain. - The API requires the caller to be a team admin on team_domain and collaborator_pkid to identify a collaborator on that same team_domain. MCP does not verify roles; unauthorized calls fail at the API. - social_path is the graph to sync and need not match the collaborator. Use get_team_collaborators(company_domain=team_domain) to list collaborators on the team.

queue_network_sync_tool

Query sync status for a social path (linkedin, twitter, github) for the viewer's graph. Companion to queue_network_sync: same social_path form (e.g. linkedin/johndoe). GET on the same base URL as the queue webhook with that path appended (URL-encoded). Pass the same collaborator_pkid and team_domain used when queueing to poll collaborator-scoped jobs. Optional collaborator_pkid queues a sync on behalf of a team collaborator. Pass collaborators[].pkid from get_team_collaborators when present (only for icebreaker/{pkid} collaborators), or icebreaker/{pkid}. When collaborator_pkid is set: - team_domain is required in the API request: pass team_domain explicitly, or rely on automatic resolution on pre-configured profile mounts. It is forwarded as teamDomain. - The API requires the caller to be a team admin on team_domain and collaborator_pkid to identify a collaborator on that same team_domain. MCP does not verify roles; unauthorized calls fail at the API. - social_path is the graph to sync and need not match the collaborator. Use get_team_collaborators(company_domain=team_domain) to list collaborators on the team. For self-queue status (no collaborator_pkid), team_domain is optional; when omitted on OAuth/header mounts it is not resolved from Neon on status polls (avoids a DB round-trip).

queue_network_sync_status_tool

Search for profiles using the Icebreaker Hypernetwork. ✅ **viewerPkid is ALWAYS provided** for this endpoint from the OAuth access token (claim urn:icbk-mcp:user_pkid). Use `ordinality: ["1st", "2nd"]` for extended network (recommended) or `["1st"]` for direct connections only. QUICK START - Common one-shot queries: - "find golang engineers in nyc": {"globs": ["golang engineer New York"], "ordinality": ["1st", "2nd"], "limit": 50, "hideViewer": true, "sources": ["all"]} - "find rust developers": {"globs": ["rust developer"], "ordinality": ["1st", "2nd"], "limit": 50, "hideViewer": true, "sources": ["all"]} - "find python engineers in san francisco": {"globs": ["python engineer San Francisco"], "ordinality": ["1st", "2nd"], "limit": 50, "hideViewer": true, "sources": ["all"]} - "look up linkedin user hoangmn": {"socialPaths": ["linkedin/hoangmn"], "ordinality": ["Global"], "limit": 50, "hideViewer": true, "sources": ["all"]} ESSENTIAL PARAMETERS (use these for most queries): - globs: Combine skills/roles AND location in one string, e.g., ["golang engineer New York"] or ["rust web3 San Francisco"] (PREFERRED - put location in globs, not in locations parameter) - ordinality: ["1st", "2nd"] (based on viewerPkid availability above) - limit: 50-100 recommended for initial searches - hideViewer: Always set to true to exclude yourself from results - sources: ["all"] to search across all platforms - locations: (DEPRECATED - prefer putting location in globs instead) - socialPaths: Look up specific profile(s) by social path/handle (same form as omni_profile.social_name), e.g. linkedin/hoangmn, github/octocat, twitter/handle, profile/{id}. Returns those exact profiles — use when you know a handle from elsewhere. NOT for searching someone's connections (use connectedSocialPaths for that). Prefixes: icebreaker/, profile/, linkedin/, farcaster/, github/, twitter/. - connectedSocialPaths: Search the network/connections of the given path(s), not the profile(s) themselves. For their full global indexed network (subject to visibility), set ordinality to ["Global"]. Up to 1000 paths per request (team: get_team → social_paths). Prefixes only: icebreaker/, profile/, linkedin/, farcaster/, github/, twitter/. - Company by domain: append globs with ["credentialnames:Verified: companydomain.com"]; includeAssociations defaults to true (anyone at company, verified or not). Set to false only for verified-members-only. Both return current and past affiliation (no current-only filter). - Examples — profile lookup by handle: {"socialPaths": ["linkedin/hoangmn"], "ordinality": ["Global"], "limit": 50, "hideViewer": true, "sources": ["all"]} | GitHub: {"socialPaths": ["github/octocat"], "ordinality": ["Global"], "limit": 50, "hideViewer": true, "sources": ["all"]}. - Examples — another person's global indexed network (connections): {"connectedSocialPaths": ["linkedin/hoangmn"], "ordinality": ["Global"], "limit": 50, "hideViewer": true, "sources": ["all"]} | GitHub: {"connectedSocialPaths": ["github/octocat"], "ordinality": ["Global"], "limit": 50, "hideViewer": true, "sources": ["all"]} | X/Twitter: {"connectedSocialPaths": ["twitter/handle"], "ordinality": ["Global"], "limit": 50, "hideViewer": true, "sources": ["all"]}. - Team network size (example): (1) get_team with your company domain → social_paths and team_profiles_count; (2) search_network with connectedSocialPaths=social_paths, ordinality as above, globs omitted or a single very broad term if needed, limit=1000, offset=0; (3) read total size from response.hits.total in the API payload when present, else use total_results and paginate with offset until a page returns fewer than limit profiles. - connectionFollowType: One of "connection" (default when undefined), "recommendations", "following", "follower". RECOMMENDED BY MY TEAM: Use connectionFollowType: "recommendations" with either (a) teamCollaborators: "verified" or "collaborators" and teamDomain: "company.com", or (b) connectedSocialPaths set to your team's social paths (from get_team). Example: {"connectionFollowType": "recommendations", "teamCollaborators": "verified", "teamDomain": "acme.com", "globs": ["engineer"], "ordinality": ["1st", "2nd"], "limit": 50, "hideViewer": true}. PAGINATION: Results are capped at 100 per call. To retrieve all results, use the offset parameter to paginate: start with offset=0, then offset=100, offset=200, etc. Stop when the number of profiles returned is less than the limit. For full dataset scans (e.g. all members of a company), always paginate until exhausted. HARDWIRED PAYLOAD (person at company): - When searching for a person at a specific company, do NOT glob the person's name + company together. Instead: (1) use `credentialnames:Verified: <companydomain.com>` as the glob to pull all associated company members, (2) paginate through ALL pages using offset until results returned < limit, (3) filter by name client-side from the full result set. - Example - Find "Benjamin" at Lazer Technologies: Step 1: search with globs=["credentialnames:Verified: lazertechnologies.com"], offset=0, limit=100 Step 2: repeat with offset=100, offset=200, etc. until profiles returned < 100 Step 3: scan all returned profiles for name match "Benjamin" - Do NOT do: globs=["Benjamin software engineer lazer technologies"] — this misses unlisted/unindexed names. DEFAULT BEHAVIOR: - This endpoint has viewerPkid provided from OAuth JWT (urn:icbk-mcp:user_pkid) - Use ordinality: ["1st", "2nd"] for extended network (recommended) or ["Global"] for all results regardless of network distance IMPORTANT! RESULT FORMAT: Use each profile's profile_url for the link; if missing, build from omni_profile.social_name (e.g. profile/xyz -> https://app.icebreaker.xyz/profiles/xyz, linkedin/abc123 -> https://app.icebreaker.xyz/linkedin/abc123). Always include the link. Display name/bio from omni_profile. For full guidance, call get_server_instructions (tool); prompts/resources may be unavailable in some clients.

search_network