Connect an AI assistant

Use Coldlytics from Claude, ChatGPT, Claude Code, Cursor and any MCP client.

The Coldlytics MCP server lets an AI assistant work with your Coldlytics account in conversation: "find owners of plumbing companies in Austin", "reveal the top ten", "look up acme.com", "launch a research task for these 40 domains".

Server URL: https://mcp.coldlytics.com/mcp (Streamable HTTP)

Authentication: sign in with your Coldlytics account (OAuth 2.1 with PKCE; supports Client ID Metadata Documents and dynamic client registration), or an API key sent as Authorization: Bearer cl_live_… for clients that cannot do OAuth.

Claude

  1. In Claude, open Customize → Connectors → Add custom connector.
  2. Enter https://mcp.coldlytics.com/mcp and confirm.
  3. Claude opens a Coldlytics sign-in. Approve the access you want to grant. You can disconnect at any time from Integrations → API & MCP in the dashboard.

Claude Code

claude mcp add --transport http coldlytics https://mcp.coldlytics.com/mcp

Then run /mcp inside Claude Code to sign in.

ChatGPT

Coldlytics is a listed ChatGPT plugin, so there is nothing to configure.

  1. Open the Coldlytics plugin in the ChatGPT directory and click Install plugin.
  2. Sign in to Coldlytics when prompted and approve the access you want to grant.
  3. Ask away: "find HVAC companies in Phoenix with 10 to 50 employees and tell me who runs them". Anything that spends credits asks for your confirmation first.

If your workspace cannot install plugins from the directory, you can still add the server by hand: Settings → Connectors → Advanced → Developer mode (on), then create a connector with the server URL above and OAuth authentication. Note that ChatGPT only lets Business and Enterprise workspaces run write tools such as reveals and research launches through developer-mode connectors; Pro can search and look up.

Cursor and other MCP clients

{
  "mcpServers": {
    "coldlytics": {
      "url": "https://mcp.coldlytics.com/mcp",
      "headers": { "Authorization": "Bearer cl_live_YOUR_KEY" }
    }
  }
}

Create the key under Integrations → API & MCP in the dashboard, with only the scopes the client needs.

Tools

Tool What it does Credits
get_account Subscription, credit balance, monthly search allowance none
get_search_options Valid values for locations, categories, technologies, seniorities, departments, research data points none
search_companies Companies by keywords and filters none, within the monthly allowance
search_people Decision-makers at matching companies, by seniority, department or title none, within the allowance
lookup_company One company by domain: categories, size, Google listing, technologies, website signals, branches and revealable people none, outside the allowance
lookup_person One person by email address or LinkedIn URL: name, title, seniority, department, location, company none, outside the allowance
find_person The best person at a domain (owners first, or by seniority, department or title), revealed in the same call 1 when a verified email is delivered, 1 per dial; owned people free
reveal_contact Verified email (and optionally direct dial) for one person, saved to your Contacts 1 per email, 1 per dial; owned people are free
reveal_contacts / get_reveal_run Reveal a large batch of people in the background and follow progress per verified email and dial
find_email One person's verified email from name and company domain 1 when a verified email is returned
list_contacts / get_contact Contacts you own, with every email and dial none
launch_research / get_research_task / list_research_tasks Human research for 20+ companies or people, up to 1,000 leads within 24 hours on business days 5 per contact requested, booked at launch
list_suppression_list / add_to_suppression_list / remove_from_suppression_list Read and update the account's suppression list of emails and company domains none

Every tool that spends credits is annotated so the assistant asks before running it. Searches share the account's monthly allowance with the Chrome extension (50 a month on free accounts, 5,000 on paid plans); lookups are outside it, and the dashboard itself is never capped.

Scopes

account:read, search:read, contacts:read, reveals:write, research:read, research:write, suppression:write. Team seats can only grant what their seat is allowed to do.

Searches accept the same filters as the dashboard: locations and ZIP codes, business categories, customer type, headcount and revenue ranges, technologies, ad pixels (ad_pixels for Facebook, Google, LinkedIn and TikTok), Google review count and rating, and max_per_company to cap people per company. search_people and list_contacts take the person filters (seniority, department, job title) too.

For client developers

  • Protected resource metadata: https://mcp.coldlytics.com/.well-known/oauth-protected-resource/mcp
  • Authorization server metadata: https://app.coldlytics.com/.well-known/oauth-authorization-server
  • The server is stateless (JSON-RPC over POST); long work returns a run or task id to poll.