---
title: Set up Icebreaker for your agent
name: agent-setup
description: Connect the Icebreaker MCP server, sign in, sync your network, and run your first network search.
url: https://www.icebreaker.xyz/prompts/agent-setup.md
slug: agent-setup
updated: 2026-11-17
requires: Icebreaker MCP. Any plan including Free.
source: www
---

This file tells an agent how to connect Icebreaker for its user, so they can search their own professional network.

Do every step you can yourself. Leave only these to the user: signing in through the browser, clicking in apps you can't control, and picking files. Never ask for or handle the user's password.

- Connect the Icebreaker MCP server
- Sign in
- Check the user's network
- Run a first network search
- Point the user to the network lead scan skill

---

## Connect the Icebreaker MCP server

Server URL: `https://mcp.icebreaker.xyz/auth` (Streamable HTTP, OAuth). It works on every plan, including Free.

If Icebreaker tools such as `lookup_viewer_tool` are already available to you, skip to "Check the user's network".

Otherwise, work out which client you are running in and connect:

- Claude Code: run `claude mcp add icebreaker --transport http https://mcp.icebreaker.xyz/auth`
- Codex: run `codex mcp add icebreaker --url https://mcp.icebreaker.xyz/auth`, then `codex mcp login icebreaker`
- Cursor: add this server to `~/.cursor/mcp.json`. Keep any servers already in the file.

  ```json
  { "mcpServers": { "icebreaker": { "url": "https://mcp.icebreaker.xyz/auth" } } }
  ```

- Claude.ai or Claude Desktop: you can't add connectors yourself. Tell the user: open https://claude.ai/customize/connectors, click +, paste the server URL, click Add, then Connect.
- ChatGPT: tell the user to open https://chatgpt.com/plugins/plugin_asdk_app_69fb97f35d08819181973c6151b2cd75 and click Connect.
- Goose Desktop: tell the user to add a custom extension with Type "Streamable HTTP" and the server URL as the Endpoint.
- Any other MCP client: add a Streamable HTTP server with the server URL.

---

## Sign in

Tell the user a browser window will open. Ask them to sign in to Icebreaker, or sign up free, and approve access. Wait for them to confirm before you go on.

If the tools still don't show up, the client needs a restart or a new session. Tell the user, then continue from the next step after the restart.

---

## Check the user's network

Call `lookup_viewer_tool` and read `linked_accounts`. Call `get_entitlements_tool` once to learn the plan and teams.

- X and GitHub: if either is missing, ask the user to link it at https://app.icebreaker.xyz/settings/linked-accounts. They sync on their own after that.
- LinkedIn matters most. If it isn't linked or has no connections, offer two ways:
  - Chrome extension, which keeps LinkedIn in sync: https://chromewebstore.google.com/detail/icebreaker-extension/lpcijfonncfkamojhlobefeoeccapjll. The user signs in to app.icebreaker.xyz in the same browser, opens the extension's side panel, and syncs.
  - LinkedIn export: steps at https://docs.icebreaker.xyz/docs/export-linkedin-data.md. When the user has Connections.csv, call `upload_self_connections_csv` without `csv_text` and give them the `upload_url`. Don't ask them to paste the file.

Ask before you queue or cancel any sync. A queued sync is not a finished sync. Check it with `queue_network_sync_status_tool` and don't requeue on your own.

---

## Run a first network search

Ask the user what they want their network to help with, or use what they already asked for. Then call `search_network` with:

```json
{ "hideViewer": true, "sources": ["all"], "ordinality": ["1st", "2nd"] }
```

Put role, skills, and location in one `globs` string, like `["product designer New York"]`. Show up to 10 strong results, each with its `profile_url`. If nothing comes back, call `get_started`.

Search, mutuals, and the MCP server are free. Ranked intro paths, lists, monitors, and enrichment need Starter or higher. If a tool is refused for plan reasons, say so plainly. If the refusal lists teams the user can use, retry with one.

---

## Setup complete

Only after the server is connected, sign-in is done, and a search has run, tell the user:

```text
Icebreaker Agent Setup Complete
-------------------------------
✓ MCP server connected
✓ Signed in
✓ Network: LinkedIn <synced or pending>, X <linked or not>, GitHub <linked or not>
✓ First network search run
```

If any step failed or is pending, say which steps are done and which are still pending. Retrying a failed step is fine.

---

## Next: scan a whole network

The most useful skill to add next is the network lead scan. It scans one person's whole network against a role or job description and returns a ranked shortlist.

- Claude Code: copy `skills/network-lead-scan` from https://www.icebreaker.xyz/prompts into `~/.claude/skills/`, or fetch https://www.icebreaker.xyz/prompts/network-lead-scan.md.
- Other clients: fetch https://www.icebreaker.xyz/prompts/network-lead-scan.md when the user asks to scan a network.

It runs best with a shell and subagents. Saving its shared list needs Starter or higher.

Before using Icebreaker tools, read https://docs.icebreaker.xyz/docs/agent-instructions.md. Ask before syncs, enrichment, uploads, list edits, monitors, or invites. Never invent people, connections, or links.

---

## Resources

- All docs: https://docs.icebreaker.xyz/llms.txt
- All prompts and skills: https://www.icebreaker.xyz/prompts
- MCP setup for each client: https://docs.icebreaker.xyz/docs/mcp-quickstart.md
- Plans: https://docs.icebreaker.xyz/docs/plans-and-limits.md

These instructions are published at https://www.icebreaker.xyz/prompts/agent-setup.md so you can check them at any time.