MCP Quickstart

Connect the Icebreaker MCP server to your AI assistant in under 2 minutes and start searching your professional network directly from Claude, ChatGPT, Codex, Cursor, or Goose.

Before you start

You will need an Icebreaker account. Sign up free at icebreaker.xyz.

MCP server URL

https://mcp.icebreaker.xyz/auth

Authentication is handled via OAuth. You will be prompted to connect your Icebreaker account the first time you add the server.

Claude

Claude.ai (web or desktop app)

The Claude Desktop app uses the same Connectors settings as claude.ai on the web.

Open Claude and go to Settings (gear icon, bottom left)
Navigate to Connectors: claude.ai/customize/connectors
Click + near "Connectors"
Paste the server URL: https://mcp.icebreaker.xyz/auth
Click Add
Click Connect and complete the OAuth flow to link your Icebreaker account

Icebreaker tools are now available in every Claude conversation automatically.

Tip: Ask Claude "What Icebreaker tools can you use?" to see the full list.

Claude Code (CLI)

Run in your terminal:

claude mcp add icebreaker --transport http https://mcp.icebreaker.xyz/auth

Follow the OAuth prompt to authenticate. The server will be available in all future Claude Code sessions.

Claude API

Connect directly from the Messages API using the mcp_servers parameter:

"mcp_servers": [
  {
    "type": "url",
    "url": "https://mcp.icebreaker.xyz/auth",
    "name": "icebreaker"
  }
]

You'll need to complete OAuth and pass the resulting token as authorization_token in the server object. See Anthropic's MCP connector docs for the full auth flow.

ChatGPT

Icebreaker is listed in the ChatGPT app directory, no Developer Mode needed.

Open the Icebreaker listing in ChatGPT
Click Connect and sign in with your Icebreaker account
Connect your network before your first search: upload your LinkedIn connections export, or install the Chrome extension for continuous sync

See the ChatGPT guide for example prompts and troubleshooting.

Codex

Run in your terminal:

codex mcp add icebreaker --url https://mcp.icebreaker.xyz/auth

Then authenticate:

codex mcp login icebreaker

This adds Icebreaker to your global Codex config at ~/.codex/config.toml. Icebreaker tools will be available in all future Codex sessions.

Tip: Ask Codex "What Icebreaker tools can you use?" to see the full list.

Cursor

Add Icebreaker to your global Cursor MCP config at ~/.cursor/mcp.json (create it if it does not exist):

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

Restart Cursor. On first use, Cursor will open a browser window to complete the OAuth flow.

To scope the server to a single project instead, place the same config in .cursor/mcp.json at your project root.

Goose Desktop

Open Goose Desktop and click Extensions in the left sidebar
Click Add custom extension
Fill in the following:
- Name: Icebreaker
- Type: Streamable HTTP
- Endpoint: https://mcp.icebreaker.xyz/auth
Click Add Extension and leave all other settings as-is
Complete the OAuth flow to connect your Icebreaker account

Verify it is working

Once connected, try one of these prompts:

Search my network for product designers in New York

Find Golang engineers in my extended network in NYC

Who in my network works at Stripe?

Who can introduce me to [name or LinkedIn URL]?

Search our team's network for enterprise sales leaders

A note on result quality

Search results reflect the connections you have synced with Icebreaker. The more of your LinkedIn, GitHub, and X/Twitter networks you have synced, the better your results.

If you have not synced yet, ask your assistant to sync your LinkedIn. It will queue a sync and let you know when it is done.

For Teams customers, searches automatically draw on your whole team's combined network.

Need help?

Reach out at [email protected] or contact your Icebreaker account manager.

Video tutorial: watch the 1-minute setup walkthrough

Want ready-made skills instead of writing prompts from scratch? See the Cookbook.