MCP Integration

Coldreach provides a Model Context Protocol (MCP) server that allows AI assistants to interact with your Coldreach data programmatically.

Overview

The MCP server exposes Coldreach's research and campaign tools as MCP tools, enabling AI assistants like Claude to:

• Look up companies and their research signals
• Search for qualified accounts matching your campaigns
• Access job posting data
• Query campaign analytics

Connection Details

Use OAuth for Claude Desktop and other MCP clients that support remote MCP authorization. Use the x-api-key header only for MCP clients that do not support OAuth but do support custom headers.

Setup with Claude Desktop

Claude Desktop connects to Coldreach through the Add custom connector flow.

1. In Coldreach, go to Settings > Developer.
2. In OAuth Clients, click Create.
3. Enter a client name such as Claude Desktop, then click Create.
4. Copy the generated Client ID and Client Secret.

   The Client Secret is shown only once. If you lose it, delete the OAuth client and create a new one.

5. In Claude Desktop, open the connector settings and click Add custom connector.
6. Enter the Coldreach connector details:

   Field	Value
   Name	Coldreach
   Remote MCP server URL	https://api.coldreach.ai/mcp
   OAuth Client ID	The Client ID from Coldreach
   OAuth Client Secret	The Client Secret from Coldreach

7. Click Connect.
8. When prompted, authorize the connection with your Coldreach email and verification code.

After authorization completes, Claude Desktop can discover and use the Coldreach MCP tools.

Manual Setup with an API Key

For MCP clients that support Streamable HTTP and custom headers, you can connect directly with your Coldreach API key.

Add this to your MCP client configuration:

{
  "mcpServers": {
    "coldreach": {
      "url": "https://api.coldreach.ai/mcp",
      "headers": {
        "x-api-key": "YOUR_API_KEY"
      }
    }
  }
}

For Claude Desktop, prefer the OAuth custom connector setup above instead of editing the local MCP configuration.

Session Management

• Each MCP connection creates a session identified by a session ID
• Sessions expire after 4 hours of inactivity
• The session ID is returned in the mcp-session-id response header

Available Tools

The MCP server exposes the same research and analysis tools available in the Coldreach chat interface, allowing AI assistants to perform company research, look up campaign matches, and more.

For a full list of available tools, connect to the MCP server and call the tools/list method.