Connect Huntr MCP

Connect Huntr MCP to give your AI client GTM intelligence tools for account research, company search, people search, verified emails, phones, website contacts, page analysis, job signals, tech stack, LinkedIn activity, X activity, pricing checks, balance, and usage. Huntr’s MCP server is available at:

https://api.tryhuntr.com/mcp

Clients that support MCP OAuth can connect in the browser without configuring headers. Other clients can continue to send your Huntr API key in this HTTP header:

x-api-key: hntr_YOUR_KEY

Create your API key from the Huntr dashboard. OAuth clients ask for it once in Huntr’s authorization page. Store the key securely; do not commit MCP config files that contain it.

Claude

Claude Desktop connects to Huntr as a native remote connector. No settings file, local bridge, Node.js installation, or custom header is required.

Step 1: Open the custom connector setup

In Claude Desktop, open Settings, select Connectors under Customize, click Add, then choose Add custom connector.

Claude Desktop Connectors settings with Add custom connector selected from the Add menu

Step 2: Enter the Huntr MCP server

Enter Huntr as the connector name and paste this exact server URL:

https://api.tryhuntr.com/mcp

Click Continue. Do not add a trailing path, API key, or query parameters to the URL.

Claude Desktop Add custom connector dialog with Huntr and the Huntr MCP server URL entered

Step 3: Choose OAuth authentication

Claude detects Huntr’s OAuth support. Select:

Authentication: Always required
OAuth client: No client ID — register one automatically

The first option requires every user to authorize with their own Huntr API key. The second lets Claude register itself securely with Huntr, so you do not need to create or paste an OAuth client ID or secret. Continue to add the connector.

Claude Desktop custom connector authentication with Always required and automatic OAuth client registration selected

Step 4: Start the connection

Open the new Huntr connector and click Connect. Claude opens Huntr’s authorization page in your browser.

Huntr connector details in Claude Desktop with the Connect button highlighted

Step 5: Authorize with your Huntr API key

Paste your Huntr API key into the authorization page and click Connect Huntr. If you do not have a key, use Create or find your Huntr API key to open the dashboard. The browser sends the authorization result back to your Claude account. The remote connector then becomes available in Claude Desktop; you do not need to add the API key to a settings file.

Huntr OAuth authorization page with an API key entered and the Connect Huntr button

Step 6: Confirm access and choose tool permissions

Return to Settings → Customize → Connectors → Huntr and confirm the connector shows Disconnect, which means it is connected. Claude groups Huntr tools into Read-only tools and Write/delete tools. Set each group to Always allow if you want Claude to call Huntr without asking before every tool request. To approve calls individually and control when credits are used, leave the groups in an approval-required mode instead. You can then enable Huntr for a conversation from the + menu under Connectors.

Connected Huntr connector in Claude Desktop with Always allow selected for both tool permission groups

Team and Enterprise workspaces require an owner to add the custom connector under Organization settings → Connectors. Each member then connects their own Huntr account.

Claude Code

OAuth setup

claude mcp add --transport http --scope user huntr https://api.tryhuntr.com/mcp
claude mcp login huntr

Complete the browser authorization page. Claude Code stores and refreshes the OAuth token for you.

API-key setup prompt

Copy this into a Claude Code chat:

Set up the Huntr MCP server in Claude Code for me.

Start by asking me for my Huntr API key. Tell me I can create one at https://tryhuntr.com/dashboard and that the key is shown once, so I should copy it immediately.

Once I paste the key, register Huntr as a streamable HTTP MCP server named "huntr" at user scope, available in all my projects, pointing at https://api.tryhuntr.com/mcp. Send my key in the x-api-key header.

If a huntr server already exists, remove it first:
  claude mcp remove huntr --scope user

Then add it:
  claude mcp add --transport http --scope user huntr https://api.tryhuntr.com/mcp --header "x-api-key: MY_KEY_HERE"

When done, tell me to open a new Claude Code chat and run /mcp to confirm the Huntr tools appear.

Manual API-key setup

claude mcp remove huntr --scope user
claude mcp add --transport http --scope user huntr https://api.tryhuntr.com/mcp \
  --header "x-api-key: hntr_YOUR_KEY"

Open a new Claude Code chat, then run:

/mcp

ChatGPT

ChatGPT connects to Huntr through its plugin UI and Huntr’s browser-based OAuth flow. You do not need to edit a configuration file, create an OAuth client, or add a custom API-key header to ChatGPT.

Step 1: Enable Developer mode

Open ChatGPT Settings → Security and login, then turn on Developer mode. Availability depends on your ChatGPT account and workspace policy.

Step 2: Add Huntr in ChatGPT Plugins

Open ChatGPT Plugins, click the + button, and create a connection with:

Name: Huntr
Description: GTM research, company search, people search, and enrichment tools
Connection: Public endpoint
MCP server URL:

https://api.tryhuntr.com/mcp

Create the connection, then review the Huntr tools ChatGPT discovers. Do not enter an API key, OAuth client ID, client secret, or custom header in the plugin settings.

Step 3: Enable Huntr in a conversation

Start a new ChatGPT conversation, open the tools menu, and add Huntr. Then ask ChatGPT to use a Huntr tool, for example:

Use Huntr to check my current balance.

Step 4: Authorize your Huntr account

When ChatGPT asks you to connect, continue to the Huntr authorization page. Paste your Huntr API key and click Connect Huntr. Create or retrieve a key from the Huntr dashboard if needed. ChatGPT exchanges the authorization code for its own access token and returns to the conversation. Your Huntr API key is not added to ChatGPT settings or shown to the model.

Step 5: Run a tool

Approve the tool request when ChatGPT asks. Once the balance result appears, the connection is ready for research, search, enrichment, and the other Huntr tools.

If Developer mode or the + button on ChatGPT Plugins is unavailable, your account or workspace policy does not currently allow custom MCP connections.

Codex

Quick setup prompt

Copy this into a Codex chat:

Set up the Huntr MCP server for me in Codex.

Detect my OS.
Add or update a Huntr MCP server in my Codex config.toml:
   ~/.codex/config.toml on macOS/Linux, %USERPROFILE%\.codex\config.toml on Windows.
Use this server URL: https://api.tryhuntr.com/mcp
Send the API key as the x-api-key HTTP header from HUNTR_API_KEY.
Ask me for my Huntr API key. Tell me I can create one at https://tryhuntr.com/dashboard and that the key is shown once.
Set HUNTR_API_KEY persistently for my OS.
Tell me to fully quit and reopen Codex, then run /mcp to confirm the Huntr tools appear.

Manual setup

Set your API key in the environment:

export HUNTR_API_KEY="hntr_YOUR_KEY"

Then add this to ~/.codex/config.toml:

[mcp_servers.huntr]
url = "https://api.tryhuntr.com/mcp"
env_http_headers = { "x-api-key" = "HUNTR_API_KEY" }

Restart Codex, then run:

/mcp

Cursor

Open Cursor Settings.
Open MCP.
Add a new global MCP server.
Paste this config into ~/.cursor/mcp.json:

{
  "mcpServers": {
    "huntr": {
      "type": "http",
      "url": "https://api.tryhuntr.com/mcp",
      "headers": {
        "x-api-key": "hntr_YOUR_KEY"
      }
    }
  }
}

Restart Cursor and use Agent mode.

Windsurf

Add Huntr to your Windsurf MCP configuration:

{
  "mcpServers": {
    "huntr": {
      "type": "http",
      "url": "https://api.tryhuntr.com/mcp",
      "headers": {
        "x-api-key": "hntr_YOUR_KEY"
      }
    }
  }
}

Restart Windsurf and confirm the huntr tools appear.

VS Code

If your VS Code MCP client supports HTTP MCP servers with custom headers, add Huntr with this server definition:

{
  "servers": {
    "huntr": {
      "type": "http",
      "url": "https://api.tryhuntr.com/mcp",
      "headers": {
        "x-api-key": "hntr_YOUR_KEY"
      }
    }
  }
}

If your extension expects the mcpServers format instead, use:

{
  "mcpServers": {
    "huntr": {
      "type": "http",
      "url": "https://api.tryhuntr.com/mcp",
      "headers": {
        "x-api-key": "hntr_YOUR_KEY"
      }
    }
  }
}

Restart VS Code after saving the config.

Cline

Open Cline’s MCP server settings and add Huntr as an HTTP MCP server:

{
  "mcpServers": {
    "huntr": {
      "type": "http",
      "url": "https://api.tryhuntr.com/mcp",
      "headers": {
        "x-api-key": "hntr_YOUR_KEY"
      }
    }
  }
}

Restart the extension or reload VS Code, then ask Cline to list available MCP tools.

Zed

If your Zed MCP setup supports HTTP servers and headers, add Huntr as:

{
  "mcpServers": {
    "huntr": {
      "type": "http",
      "url": "https://api.tryhuntr.com/mcp",
      "headers": {
        "x-api-key": "hntr_YOUR_KEY"
      }
    }
  }
}

Restart Zed and confirm the Huntr tools are available in the assistant.

What your agent can do

Once connected, your AI client can call the same Huntr workflows available through the REST API.

Build lists

MCP tool	REST equivalent	What it does
`company_search`	`POST /company-search`	Build company lists with structured or semantic filters
`company_search_count`	`POST /company-search-count`	Count matching companies without returning rows
`person_search`	`POST /person-search`	Find people by title, employer name, location, and firmographics
`person_search_count`	`POST /person-search-count`	Count matching people without returning rows

Enrich contacts

MCP tool	REST equivalent	What it does
`person_email`	`POST /person-email`	Find a work email plus returned employee and company fields for one person
`person_phone`	`POST /person-phone`	Find an employee phone plus returned company fields for one person
`reverse_email`	`POST /reverse-email`	Identify person, phone, and company fields from an email
`person_linkedin_url`	`POST /person-linkedin-url`	Resolve LinkedIn profile URL from `linkedin_url`, or from first name, last name, and company URL
`person_linkedin`	`POST /person-linkedin`	Get full LinkedIn profile data from a profile URL

Research accounts

MCP tool	REST equivalent	What it does
`research`	`POST /research`	Agent-led research for one account, buyer, market, or structured question

Use research for one focused synthesis task. For bulk lists, use direct tools such as company_search, company_search_count, person_search, person_search_count, and person_email.

Website and page intelligence

MCP tool	REST equivalent	What it does
`company_contact`	`POST /page-company-contact`	Extract emails, phones, and social profiles from a company website
`find_pages`	`POST /page-find`	Discover relevant public URLs on a domain
`page_scrape`	`POST /page-scrape`	Scrape structured content from one URL
`page_analyze`	`POST /page-analyze`	Analyze one page with an LLM prompt
`tech_stack`	`POST /company-tech-stack`	Detect technologies on a domain
`job_postings`	`POST /company-jobs`	Find active job listings for a company

LinkedIn and X signals

MCP tool	REST equivalent	What it does
`linkedin_company`	`POST /company-linkedin`	Get company profile data from a LinkedIn company URL
`company_linkedin_url`	`POST /company-linkedin-url`	Resolve a LinkedIn company URL from company URL/domain, or best-effort from name
`company_linkedin_posts`	`POST /company-linkedin-posts`	Get paginated posts from a LinkedIn company page
`linkedin_post`	`POST /linkedin-post`	Get detailed data for one LinkedIn post
`linkedin_post_reactions`	`POST /linkedin-post-reactions`	Get people who reacted to a LinkedIn post
`linkedin_post_comments`	`POST /linkedin-post-comments`	Get comments from a LinkedIn post
`x_profile`	`POST /x-profile`	Get X profile metadata
`x_post_search`	`POST /x-post-search`	Search X posts
`x_post`	`POST /x-post`	Get one X post by ID or URL
`x_thread`	`POST /x-thread`	Get thread context for an X post

Usage and pricing checks

MCP tool	REST equivalent	What it does
`get_pricing`	`GET /pricing`	Return the current plan-aware pricing matrix
`get_balance`	`GET /balance`	Check remaining credits and rate limit info
`get_usage`	`GET /usage`	Return recent request history

Example prompts

Find contacts

Use Huntr to find VPs of Sales at US SaaS companies with 50 to 500 employees. Return names, titles, companies, LinkedIn URLs, and verified emails when available.

Find people at one company Research one account

Use Huntr to research Notion's enterprise motion and identify likely security or procurement buyers. Include practical outreach angles.

Find buying signals

Use Huntr to find companies hiring RevOps roles, get their tech stack, then find revenue leaders with emails.

Check cost before running

Use Huntr get_pricing and get_balance first, then recommend the appropriate workflow for finding 50 qualified contacts under the active pricing plan.

Troubleshooting

Problem	Fix
Tools do not appear	Fully quit and reopen the client. Some MCP clients only reload servers on restart.
Authentication fails	Reconnect the OAuth client, or confirm a header-based client sends the exact `x-api-key`.
`tools/list` fails	Complete the OAuth connection, or confirm the client sends your `x-api-key`.
The client says the server is unreachable	Confirm the server URL is exactly `https://api.tryhuntr.com/mcp`.
Claude Desktop cannot send headers	Remove the old local server and add Huntr as a remote custom connector; OAuth requires no custom header.
A paid tool fails for credits	Run `get_balance`, then add credits from the dashboard.
Results are too broad	Ask the agent to use direct tools with stricter filters instead of open-ended `research`.

Next step

Huntr Skills — ready-made GTM workflows powered by these MCP tools
Research Agent guide
Choose your workflow
API Reference

​Claude

​Step 1: Open the custom connector setup

​Step 2: Enter the Huntr MCP server

​Step 3: Choose OAuth authentication

​Step 4: Start the connection

​Step 5: Authorize with your Huntr API key

​Step 6: Confirm access and choose tool permissions

​Claude Code

​OAuth setup

​API-key setup prompt

​Manual API-key setup

​ChatGPT

​Step 1: Enable Developer mode

​Step 2: Add Huntr in ChatGPT Plugins

​Step 3: Enable Huntr in a conversation

​Step 4: Authorize your Huntr account

​Step 5: Run a tool

​Codex

​Quick setup prompt

​Manual setup

​Cursor

​Windsurf

​VS Code

​Cline

​Zed

​What your agent can do

​Build lists

​Enrich contacts

​Research accounts

​Website and page intelligence

​LinkedIn and X signals

​Usage and pricing checks

​Example prompts

​Troubleshooting

​Next step

Claude

Step 1: Open the custom connector setup

Step 2: Enter the Huntr MCP server

Step 3: Choose OAuth authentication

Step 4: Start the connection

Step 5: Authorize with your Huntr API key

Step 6: Confirm access and choose tool permissions

Claude Code

OAuth setup

API-key setup prompt

Manual API-key setup

ChatGPT

Step 1: Enable Developer mode

Step 2: Add Huntr in ChatGPT Plugins

Step 3: Enable Huntr in a conversation

Step 4: Authorize your Huntr account

Step 5: Run a tool

Codex

Quick setup prompt

Manual setup

Cursor

Windsurf

VS Code

Cline

Zed

What your agent can do

Build lists

Enrich contacts

Research accounts

Website and page intelligence

LinkedIn and X signals

Usage and pricing checks

Example prompts

Troubleshooting

Next step