Skip to main content
Clustr provides an MCP (Model Context Protocol) server that lets AI assistants like Claude Desktop, Claude Code, and Cursor 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

​
Prerequisites

​
Configure Your AI Client

No install needed. npx downloads the server automatically on first run. Add the following to your AI client’s MCP config file:
  • Claude Desktop → claude_desktop_config.json
  • Claude Code → .mcp.json in your project root
  • 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 AI client.

​
Available Tools

Once connected, your AI assistant has access to the following tools:
ToolDescription
import_contactsImport LinkedIn contacts for referral opportunity discovery. Results delivered via webhook.
search_opportunities_by_companySearch opportunities filtered by company domain, LinkedIn URL, or other criteria
search_opportunities_by_contactGet opportunities for a specific contact by LinkedIn URL or public ID
create_target_accountsAdd target accounts for opportunity prioritization
list_target_accountsList or search your target accounts
delete_target_accountRemove a target account by ID, name, or LinkedIn URL

​
Example Prompts

Here are some things you can ask your AI assistant once Clustr is connected:
  • “Find referral opportunities at Salesforce”
  • “What opportunities do we have through john-doe on LinkedIn?”
  • “Add Stripe as a target account”
  • “List all our target accounts”

​
Authentication

The MCP server uses the same API key as the REST API. Set it via the CLUSTR_API_KEY environment variable in your client configuration.

​
Troubleshooting

IssueSolution
CLUSTR_API_KEY environment variable is requiredSet the CLUSTR_API_KEY env var in your client config
Authentication errorsVerify your API key is correct and active in API settings
Tools not appearingRestart your AI client after updating config
Rate limitedWait a moment and retry. The error message includes retry timing.
Large responses truncatedUse page and page_size parameters to paginate results