MCP Server - Clustr

Clustr provides a hosted MCP (Model Context Protocol) server that lets AI assistants like Claude, Cursor, and Windsurf interact with your Clustr network directly through natural language. Ask your AI assistant to search opportunities, manage target accounts, or import contacts without leaving your workflow.

Setup

The Clustr MCP server is hosted on Clustr’s infrastructure — no Node.js required, and it’s always up to date. Just point your AI client at the URL.

Prerequisites

A Clustr API key from API settings

Configure Your AI Client

HTTP (Recommended)
npm (legacy)

Works with Claude Code, Claude Desktop, Cursor, Windsurf, and any MCP-compatible client.Add the following to your MCP config file (.mcp.json for Claude Code, claude_desktop_config.json for Claude Desktop, or your client’s equivalent):

{
  "mcpServers": {
    "clustr": {
      "type": "http",
      "url": "https://api.clustr-ai.com/mcp",
      "headers": {
        "Authorization": "Bearer your-api-key"
      }
    }
  }
}

Replace your-api-key with the key from your API settings page, then restart your AI client.Why HTTP?

No Node.js or npm install required
Always runs the latest version — nothing to update
Works across all MCP-compatible clients with the same config

If you prefer to run the server locally, the npm package is still available.Requires Node.js 18+ (download here)

Claude Code
Claude Desktop / Cursor

Run this command in your terminal:

claude mcp add clustr -e CLUSTR_API_KEY=your-api-key -- npx -y @clustr-ai/mcp-server

Replace your-api-key with the key from your API settings page. The server will be available immediately — no restart needed.

Add the following to claude_desktop_config.json (Claude Desktop) or your Cursor MCP settings:

{
  "mcpServers": {
    "clustr": {
      "command": "npx",
      "args": ["-y", "@clustr-ai/mcp-server"],
      "env": {
        "CLUSTR_API_KEY": "your-api-key"
      }
    }
  }
}

Replace your-api-key with the key from your API settings page, then restart your client.To update to the latest version:

npm install -g @clustr-ai/mcp-server@latest

Available Tools

Once connected, your AI assistant has access to the following tools:

Tool	Description
`start_abm_search`	Start an ABM search for a target company and get a shareable magic link immediately
`get_abm_search_link`	Retrieve the magic link for an existing ABM search without re-running the pipeline
`import_contacts`	Import LinkedIn contacts for referral opportunity discovery. Results delivered via webhook.
`search_opportunities`	Search opportunities — by contact, company, or across your entire network
`search_companies`	Search or lookup companies by name, domain, or LinkedIn URL
`list_connectors`	List people in your network with opportunity counts
`get_network_stats`	Get an overview of your network — connectors, opportunities, top companies
`get_job_status`	Get the status and progress of an import job
`list_jobs`	List import jobs with optional status filter
`update_opportunity`	Update an opportunity’s status or notes
`list_opportunity_statuses`	List available opportunity statuses for your tenant
`create_target_accounts`	Add target accounts for opportunity prioritization
`list_target_accounts`	List or search your target accounts
`delete_target_account`	Remove a target account by ID, name, or LinkedIn URL
`whats_new`	Show the MCP changelog and available tools

Example Prompts

Here are some things you can ask your AI assistant once Clustr is connected:

“Run an ABM search on Salesforce and give me the report link”
“Find referral opportunities at Stripe”
“What opportunities do we have through john-doe on LinkedIn?”
“Show me my top opportunities by confidence score”
“Give me an overview of my network”
“Who are my connectors?”
“Check the status of my last import”
“Mark opportunity X as Contacted”
“Add Stripe as a target account”
“List all our target accounts”

Authentication

The MCP server uses the same API key as the REST API. Pass it as a Bearer token in the Authorization header of your client config (HTTP transport) or as the CLUSTR_API_KEY environment variable (npm transport).

Troubleshooting

Issue	Solution
`401 Unauthorized`	Verify your API key is correct and active in API settings
Tools not appearing	Restart your AI client after updating config
Rate limited	Wait a moment and retry. The error message includes retry timing.
Large responses truncated	Use `page` and `page_size` parameters to paginate results
`CLUSTR_API_KEY environment variable is required` (npm only)	Set the `CLUSTR_API_KEY` env var in your client config

Documentation Index

​Setup

​Prerequisites

​Configure Your AI Client

​Available Tools

​Example Prompts

​Authentication

​Troubleshooting