This article is also available in:

Umamy MCP

With Umamy MCP, your hunts and candidates are available right inside Claude, ChatGPT or any other MCP-compatible AI tool. Ask your questions in plain English, and the AI fetches the answer from Umamy.

In short: one address to paste (https://api.umamy.io/mcp), one sign-in to your Umamy account, and you're done. No key to copy.

Beta: Umamy MCP is available to test. Features may change.

What you can ask

You want to…	Ask for example
See your hunts	"Which hunts are live right now?"
Track your results	"How many connections were accepted over the last 30 days on hunt X?"
Find candidates	"Show me the candidates who accepted but didn't reply."
Re-read a conversation	"What did I last say to candidate Y, and what did they reply?"
Read your team's notes	"What notes do we have on candidate Y?"
Check a setting	"How is the EU sales hunt configured?"

Connect in 3 steps

Everything is also shown in Umamy: left menu → Integrations → Umamy in your AI tools section → Show steps.

Copy the server address: https://api.umamy.io/mcp (copy button next to it).
Or follow the guide: Claude setup guide (or ChatGPT) opens a 2-minute walkthrough.

Integrations, Umamy in your AI tools: the MCP server address and the Claude setup guide

Then, in your AI tool:

Tool	Where to add it	Plan needed
Claude (web or app)	Settings → Connectors → Add custom connector, paste the address, then Connect	Paid plan. On Team or Enterprise, your admin may need to approve it.
ChatGPT	Settings → Connectors → Add MCP server, paste the address	Plus, Pro, Business or Enterprise
Claude Code	In your terminal: `claude mcp add umamy --transport http` `https://api.umamy.io/mcp`, then `/mcp` → umamy → Authenticate	—
Other MCP tool	Custom connection to `https://api.umamy.io/mcp` (Streamable HTTP transport, OAuth 2.0 in the browser)	—

A window opens: sign in to your Umamy account and authorize access. That's it.

Each user signs in with their own account. There is no API key or service account for MCP: for server-to-server access, use the Umamy customer API.

What the AI can see

Umamy MCP applies the same access rules as the app: the AI only sees hunts in organizations you belong to, and their candidates.

Available tools, for the curious:

Tool	What it does
`list_organizations`	Lists your organizations (always the starting point).
`list_hunts` / `get_hunt` / `get_hunt_configuration`	Your hunts, their status and their setup.
`get_organization_metrics` / `get_hunt_metrics_timeseries` / `get_hunt_metrics_distribution`	Your numbers: funnel, trends over time, breakdowns.
`list_candidates` / `get_candidate`	Your candidates and their profile, with the scoring rationale.
`get_candidate_messages` / `list_candidate_notes`	Messages exchanged and your team's notes.

Still stuck?

The AI says it can't access Umamy: disconnect the Umamy connector in your tool, reconnect it, then test with "Which Umamy organizations am I in?".
Claude shows "No tools available": on claude.ai/customize/connectors (even if you use the app), open Umamy, ⋯ menu → Disconnect, then Connect without refreshing the page.
"Unauthorized" or "no organization found": you signed in with a different email than your Umamy account (shown bottom-left in Umamy). Reconnect with the right one.
No hunts or candidates found: ask "Which Umamy organizations am I in?". Right account but wrong organization: name it in your question. Wrong account: disconnect and reconnect.
Limits: about 100 requests per minute by default. If you hit them often, write to us.

FAQ

Do I need the same email for my AI tool and Umamy?
No. During sign-in, you choose the Umamy account the AI acts as.

Do I need a client ID or client secret?
No, it's automatic. If a tool shows these fields, leave them blank.

I just upgraded my plan: when do I get the new tools?
Right away, from your next question.

Can I connect my own internal AI tool?
Yes, if it follows the MCP client specification and handles browser OAuth sign-in. Need help: support@umamy.io.

Updated on: 30/10/2026

Was this article helpful?

Thank you!