🐊lacøstRAYZ🐊 :
Hunter agent setup
These are official instructions from Hunter (https://hunter.io) to connect Hunter to
your AI agent. Once connected, you can find and verify professional email addresses,
list any company's contacts from its domain, discover companies that match a profile,
enrich people and companies from real, verified GTM data instead of guesses, and save
those contacts as leads to build and launch email outreach sequences.
Do the steps yourself by running the commands directly. The user is needed twice: once
early (to copy their API key, or to sign in if their client connects through OAuth), and
once at the end to reload or restart their client so the new server loads (you can't reload
a desktop app headlessly).
1. Get a Hunter API key
2. Connect Hunter to this agent (use the one section for your agent)
3. Verify the connection
4. Try it
---
## Step 1: Get a Hunter API key
First, which client is the user on? The **OAuth clients** — **Claude Code**, **Claude Desktop /
Claude.ai**, and **ChatGPT** — authorize Hunter in the app (Claude Code through its plugin, on
first tool use), so they need no API key to connect; skip to Step 2. The **header clients** —
Cursor, VS Code, Windsurf, Codex, and any other MCP client — put the key in their config, and
the REST API and the optional Step 3 curl also use one, so if the user is on any of those, keep
going here. (Claude Code needs a key only if you want to run the optional Step 3 REST smoke test.)
Hunter authenticates with an API key.
1. Ask the user to open https://hunter.io/api-keys and give you their API key. If they
don't have a Hunter account yet, they can sign up free at
https://hunter.io/users/sign_up?from=agents_md. The Free plan includes 50 credits and 100
verifications a month, enough to run everything below.
2. Keep the key out of anything that is committed or logged. Read it into an environment
variable without echoing it — `read -rs HUNTER_API_KEY && export HUNTER_API_KEY`, then
paste the key at the silent prompt — so the literal key never lands in a command, your
shell history, or this transcript. Never print it back in full and never commit it.
No key yet, or want a zero-cost dr
2026-08-08 01:56:08