Integrations

Connect HuntSales to your AI

HuntSales speaks MCP (Model Context Protocol), the open standard for connecting tools to AI assistants. Point Claude, ChatGPT, or any MCP client at HuntSales with an API key and your AI can answer questions about your contacts, pipeline, and the shared prospect Vault. It is read-only and scoped to your organisation by your key.

Endpoint

https://huntsales.io/api/mcp

Transport: Streamable HTTP (JSON-RPC 2.0). Auth: Bearer API key.

1

Create your API key

In HuntSales, go to Settings → Developer and click Create API key. Copy it when shown; it is only displayed once. The key starts with hs_live_. Keep it private, it is read-only and scoped to your workspace, and you can revoke it from the same page any time.

2

Connect your AI client

Pick the app you use. Replace hs_live_YOUR_KEY with the key from step 1.

Claude Code (the CLI)

Run this one command in your terminal:

claude mcp add --transport http --scope user huntsales \
  https://huntsales.io/api/mcp \
  --header "Authorization: Bearer hs_live_YOUR_KEY"

Check it worked with claude mcp list (HuntSales should show ✓ Connected). It is available in new Claude Code sessions.

Claude Desktop

Go to Settings → Developer → Edit Config (this opens a file called claude_desktop_config.json; if Windows asks which app to open it with, choose Notepad or VS Code). Add HuntSales inside mcpServers. Desktop launches local commands, so we use the mcp-remote bridge to reach the hosted server (you need Node.js installed):

{
  "mcpServers": {
    "huntsales": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote", "https://huntsales.io/api/mcp",
        "--header", "Authorization: Bearer hs_live_YOUR_KEY"
      ]
    }
  }
}

If you already have other servers, just add the huntsales block alongside them. Save the file and fully restart Claude Desktop. HuntSales then appears under Settings → Developer.

claude.ai or ChatGPT (web)

Add a custom connector pointing at https://huntsales.io/api/mcp. These web clients are built around OAuth, so if yours cannot send a custom Authorization header, use the Claude Code or Claude Desktop method above, those pass your key directly.

3

Ask your AI about your CRM

Once connected, you can ask things like:

  • How many contacts are at the Follow-up stage?
  • What is my pipeline breakdown right now?
  • How many HR managers in Singapore are in the Vault?
  • How many HuntSales credits do I have left?

ChatGPT and the OpenAI API

The same endpoint works with any MCP client. ChatGPT supports remote MCP connectors in Developer mode (Plus, Pro, Team, Enterprise, and Edu plans): turn it on under Settings then Apps then Advanced settings then Developer mode, then add a custom connector pointing at https://huntsales.io/api/mcp.

One thing to know about auth: HuntSales authenticates with your Bearer API key, which Claude Desktop passes as a custom header. ChatGPT connectors are built around OAuth, so if your client cannot send a custom Authorization header, the Claude setup above is the smoothest path today. Email us if you need a hand wiring up ChatGPT.

With the OpenAI API or Agents SDK, pass HuntSales as a remote MCP tool (thetools array with the endpoint URL and your key in the headers), the same way you would any hosted MCP server.

Available tools

get_credits

Your HuntSales credit balance.

query_contacts

Search your CRM contacts by name, email, or job title; filter by stage.

get_pipeline_summary

Count of your contacts in each pipeline stage.

count_prospects

Count fresh prospects in the shared Vault that match a profile.

The connection is read-only for now. Actions that change data (adding contacts, logging calls, building campaigns) stay inside the HuntSales app, where they are confirmed before running. Your key is scoped to your organisation and can be revoked any time from Settings.

Prefer plain REST? See the HuntSales API reference.