← all tools
Recruiting CRM

VincereMCP connector for Claude and ChatGPT

Everything you sourced lands in Vincere, on the right record.

Vincere is a recruiting CRM, and one of the 54 tools hyreflow connects to Claude, ChatGPT and other AI assistants. Through hyreflow, an AI agent can run 9 actions: 6 that look something up and 3 that create or change records. Vincere costs no hyreflow credits, and runs on your own Vincere account.

Cost per callfree
Your own keyoptional
CategoryRecruiting CRM

What is Vincere?

Vincere (vincere.io) is a recruiting CRM. Your agent searches Vincere before it creates anything, so you do not end up with duplicates, then writes the genuinely new ones in. It reads your jobs, companies and contacts as well.

Vincere is the destination. Sourcing and enrichment feed it.

What can you ask Claude or ChatGPT to do with Vincere?

With hyreflow connected, you ask for the outcome in plain language and the assistant runs Vincere for you. For example:

  • “Push this shortlist in, skipping anyone already on the database”
  • “What jobs am I working? Build a longlist for this one using Apollo”
  • “Update this record with the mobile LeadMagic found”
  • “Write the Fathom debrief onto the candidate”

How do you connect Vincere to Claude or ChatGPT?

You connect hyreflow once over MCP, and Vincere comes with it, next to the other 53 tools. You do not need to run a separate Vincere MCP server.

  1. 1

    Add hyreflow as a connector in your assistant

    In Claude, ChatGPT or any other MCP client, add a custom connector named hyreflow with the server URL https://recruit.hyreflow.ai/api/v2/mcp. The MCP setup guide on hyreflow.ai has the exact steps for each app.

  2. 2

    Sign in to hyreflow and pick a workspace

    A browser window opens. Sign in, choose the workspace the assistant may act on, and approve. The connection is live.

  3. 3

    Connect your Vincere account

    Vincere runs on your own Vincere account. Connect it on the Integrations page in hyreflow, and hyreflow charges no credits for its calls.

  4. 4

    Ask for the outcome

    Tell Claude or ChatGPT what you want done with Vincere in plain language. The assistant picks the Vincere action that fits and runs it through hyreflow.

Using Cursor, Claude Code or another client? Every one is covered in the MCP setup guide.

Which tools work well with Vincere?

In a hyreflow run, Vincere is most often paired with Apollo, LeadMagic, Fathom and SourceWhale.

  • Apollo

    source against the roles already live in Vincere

  • LeadMagic

    fill the contact gaps on records you already hold

  • Fathom

    interview debriefs onto the candidate record

  • SourceWhale

    outreach shaped the way the desk is measured

What are the alternatives to Vincere?

Other recruiting CRMs hyreflow connects: Atlas, Bullhorn, Carerix, Crelate, JobAdder and Loxo. They run through the same connector, so you can switch, or combine them in one run, without new setup.

Which Vincere actions can an AI agent run through hyreflow?

Through hyreflow, an AI agent can run 9 Vincere actions: 6 that look something up and 3 that create or change records. Vincere costs no hyreflow credits, and runs on your own Vincere account.

Vincere actionWhat it doesCost through hyreflow
Search candidatesLooks something upno hyreflow credits
Search companiesLooks something upno hyreflow credits
Search contactsLooks something upno hyreflow credits
Search jobsLooks something upno hyreflow credits
Create candidateCreates or changes a recordno hyreflow credits
Create candidates batchCreates or changes a recordno hyreflow credits
Update candidateCreates or changes a recordno hyreflow credits
Get candidateLooks something upno hyreflow credits
Get jobLooks something upno hyreflow credits

One credit is priced on the pricing page. The full price list for every tool is in the pricing tables.

How does an AI agent know how to use Vincere?

hyreflow ships a written playbook for Vincere, and the agent loads it before the first call. Auth, rate limits, what each call costs, which actions need your approval, and the mistakes worth avoiding. It is the difference between an agent that knows the tool and one that guesses at it.

Read the Vincere docs →
Show the raw playbookwritten for the agent

HOW in lib/vincere.py.

Auth & config (two headers)

  • Base URL: https://{tenant}.vincere.io/api/v2 — the tenant is the workspace's own Vincere subdomain.
  • Connect: connect Vincere from the dashboard's Integrations page with the tenant, Client ID and API key Vincere issued for the account, then sign in to Vincere. No client secret.
  • Auth: BOTH x-api-key AND id-token (1 h TTL). The id-token refreshes automatically once connected — no manual refresh needed.

Operations (paths CONFIRMED 2026-06-01; full spec signup-gated)

Candidates: search_candidates, get_candidate, create_candidate, update_candidate. Reads: search_jobs, get_job, search_companies, search_contacts. Index: reference/docs/vincere/raw/endpoints.md.

  • Jobs are job (NOT position) in v2 — confirmed. Search paths carry a trailing slash (/candidate/search/).
  • Search quirk: fl/sort are matrix params on the path (/candidate/search/fl=id,name;sort=created_date asc?q=...), q is a query param. The client passes fl/q as query params; if a search 400s, report it rather than retrying with a hand-built path.

Guardrail

Production ATS writes — pilot one, confirm, then bulk. Watch for id_token expiry (refresh + retry).

Handoff

ATS write target: enriched candidates → create_candidate.

Callable surface

Call via the CLI: hyreflow tools execute vincere <method> --payload '{...}' (preview with --dry-run; hyreflow tools get vincere <method> returns the live contract + cost). Only the methods listed below are callable.

  • batch(method: str, calls: list, *, stop_on_error: bool = False) -> dict — Batched get/search/update/create: run one method over many inputs, rate-limited. Each call is a value -> method(value), or {"args": [...], "kwargs": {...}} for multi-arg methods like update_candidate(id, payload). Destructive methods (delete) are refused. See lib/_base.run_ops.
  • create_candidate(payload: dict) -> Any — POST /candidate — create a candidate.
  • create_candidates_batch(payloads: list[dict], *, stop_on_error: bool = False) -> dict — POST /candidate for many records, respecting VINCERE_RATE_LIMIT_RPM.
  • get_candidate(candidate_id: str, *, fields: str | None = None) -> Any
  • get_job(job_id: str, *, fields: str | None = None) -> Any
  • search_candidates(q: str, *, fl: str | None = None, sort: str | None = None, **params) -> Any — GET /candidate/search/ — q uses Vincere's field:terms# syntax; fl=returned fields, sort=e.g. "created_date desc".
  • search_companies(q: str, *, fl: str | None = None, sort: str | None = None, **params) -> Any — GET /company/search/.
  • search_contacts(q: str, *, fl: str | None = None, sort: str | None = None, **params) -> Any — GET /contact/search/.
  • search_jobs(q: str, *, fl: str | None = None, sort: str | None = None, **params) -> Any — GET /job/search/ — jobs are job in Vincere v2 (CONFIRMED — not position).
  • set_id_token(id_token: str) — Swap in a freshly-refreshed id_token (they expire after 1 h).
  • update_candidate(candidate_id: str, payload: dict) -> Any

Questions about Vincere and hyreflow

Can I use Vincere inside Claude or ChatGPT?

Yes. hyreflow is a connector for Claude, ChatGPT and other AI assistants. Once hyreflow is connected, you ask for the outcome in plain language and the assistant calls Vincere for you. hyreflow exposes 9 Vincere actions this way.

Do I need my own Vincere account to use it with hyreflow?

Yes. Vincere runs on your own Vincere account. You connect it to hyreflow once, hyreflow charges no credits for the calls, and Vincere bills you as before.

What does Vincere cost through hyreflow?

Vincere costs no hyreflow credits, and runs on your own Vincere account.

How do I connect Vincere to an AI agent over MCP?

Add the hyreflow MCP server to your assistant and sign in. hyreflow calls the Vincere API directly and exposes its actions as tools the assistant can run, so there is no separate Vincere server to install.

Connect hyreflow to your assistant →

Put Vincere to work from one prompt

Connect hyreflow to Claude or ChatGPT and ask for the outcome. It reads the playbook above before it makes a single call.