Question 1

Umamy MCP

Accepted Answer

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

Question 2

Signing in with your company identity provider (SAML SSO)

Accepted Answer

Umamy supports enterprise single sign-on through SAML 2.0. Your team signs in with your own identity provider — Microsoft Entra ID, Okta, Google Workspace, or any SAML 2.0 provider — and new employees get access on their first sign-in, with no invitation to send.

Setting it up takes three things: your IT team configures an application on their side, you tell us your identity provider's metadata URL, and you prove the email domains your provider speaks for. Nothing is enforced until you ask us to switch it on.

What your IT team needs from us

Umamy is the service provider (SP). These are its values:

| Field | Value | | ---- | | Identifier / Entity ID | https://auth.umamy.io/auth/v1/sso/saml/metadata | | Reply URL / ACS URL | https://auth.umamy.io/auth/v1/sso/saml/acs | | Metadata URL | https://auth.umamy.io/auth/v1/sso/saml/metadata | | Metadata file (for tools that want an upload) | same URL + ?download=true | | Single logout (SLO) URL | https://auth.umamy.io/auth/v1/sso/slo | | NameID format | emailAddress | | Sign-on URL (for IdP-initiated sign-in) | https://app.umamy.io/sign-in |

The same values are shown on Settings → Single Sign-On in Umamy, with copy buttons. Read them there rather than from this page if the two ever disagree — that page is generated from the live configuration.

What we need from you

Your identity provider's SAML metadata URL (preferred) or its metadata XML file. You can enter it yourself on **Settings → Single Sign-O

Question 3

My hunt shows no new profiles: is my LinkedIn account disconnected?

Accepted Answer

Umamy finds and contacts your candidates through your LinkedIn account. If that account gets disconnected, your hunt stops quietly. Here's how to spot it and get things moving again.

Signs of a disconnection

No new profiles for several days.
Invitations stay in the queue and aren't sent anymore.
No new messages go out to candidates.

Check your account

In the left menu, open Integrations.
Under LinkedIn accounts, look at your account status: it should be Connected.

Reconnect the account

On the Integrations page, reconnect your LinkedIn account.
Sign in with your LinkedIn email and password on the secure page that opens.

|| Reconnect the same LinkedIn account. A launched hunt stays linked to the account it was launched with.

Check that the hunt restarts

Open the hunt.
At the top right, check that the hunt is Live. If it's paused, restart it from that menu.
New profiles arrive at the Next agent run, and invitations go out again at their usual pace.

The hunt status at the top right (Live) and its menu

Why does this happen?

LinkedIn sometimes cuts access for connec

Question 4

Launch your hunt the right way in 3 steps

Accepted Answer

A successful hunt is decided before the first message goes out. It launches in 3 steps, in this order: scope, check the pool, validate the score. Skipping a step often costs several weeks.

| The golden rule: a criterion must check a real track record, not whether a word appears on the profile.

Step 1 — Scope the role (45 min, with the hiring manager)

The hiring manager is in the room: they settle the job-specific questions.

Prepare before the session:

the job description;
2 or 3 LinkedIn profiles of candidates you would hire tomorrow;
the list of people already contacted elsewhere, so they aren't approached twice.

Decide together:

the one deal-breaker criterion (e.g. "has already led projects from X to Y"), described as an experience, not a keyword;
the exact job titles used at your competitors, without acronyms;
what you exclude (titles, industries, backgrounds);
the target companies: to favour, or to require? Requiring them can divide the pool by five;
what can't be seen on LinkedIn (management, contract type, country): you'll ask in the first message;
the realistic number of profiles in this market.

You get a written recap within 24 hours: a simple "OK" by reply is enough. Then create the hunt:

Click Hunts.
Click + (New hunt), right next to it.
Describe the role in a few sentences, or attach the job description.
Click Create your hunt.

![Left menu: Hunts and the + button (New hunt)

Question 5

How do I edit my Scorecard after launch, and why are my scores changing?

Accepted Answer

The Scorecard gives each candidate a score from 0 to 100. You can change it at any time, even after your hunt is live.

| The Scorecard ranks candidates. The Brief finds them. To get more candidates or different profiles, change the Brief.

Open the Scorecard

Open the hunt, then the Agent tab.
Click the Scorecard card. The Edit Scorecard window opens.

Edit the criteria

Put the most important criterion at the top: drag the criteria to change their order. Then:

Make a criterion required: click the pin on the left of the criterion.
Add a criterion: click Add criterion, at the bottom of the window.
Click Save when you're done.

The Edit Scorecard window: the pin, Add criterion and Save

To reword or remove a criterion, tell Umamy in the conversation. For example: "Remove the English criterion".

The percentages are calculated automatically, based on the order of the criteria and which ones are pinned. You don't need to enter them.

Required or optional?

Optional: the criterion counts in the score, without blocking the candidate.
Required: a candidate who doesn't meet it is not approved automatically.

|| Keep required criteria for your true deal-breakers (1 or 2). Making everything required empties your talent pool and can pause your search.

Why are my scores changing?

Question 6

Change the LinkedIn account of a hunt

Accepted Answer

Each hunt sends its invitations and messages from a LinkedIn account. Want to use a different one (for example yours instead of a colleague's)? First free up the old account's seat, then add the new one.

|| Your license includes 1 active LinkedIn account at a time. Remove the old account before adding another one, otherwise an extra license will be charged.

Step 1 — Remove the old account

In the left menu, open Integrations (at the very bottom).
On the LinkedIn account card, click the gear icon.
Click Delete.

Integrations: the gear icon of a LinkedIn account, then Delete

Step 2 — Add the new account

Still in Integrations, click Add an account, then follow the guide to connect your LinkedIn account.

The Add an account button, above the LinkedIn accounts

Step 3 — Use it in your hunt

Open your hunt, Agent tab, then the Engage card:

Stay on Account & identity.
Pick the new account from the list.

Engage, Account & identity: choose the sending LinkedIn account

| A hunt that has already launched stays linked to the LinkedIn account it started with, so candidates alway

Frequently Read Articles

Browse All Categories

No categories configured.