Skip to main content
All integration guides
Marxel connector for Claude

Use Marxel in Claude

Compare candidate evidence against criteria you confirm, prepare interview questions, and save a selected review to Marxel when you choose to. This page covers what the connector does, the permissions it asks for and how it handles data.

Reviewed 15 October 2026

At a glance

Server URL
https://mcp.marxel.co/mcp
Authentication
None for reviews. OAuth sign-in to Marxel only for saving.
OAuth scopes
reviews:write, offline_access

What it does

Bring a hiring brief and up to five CVs into a Claude conversation. Claude proposes job-related criteria from the brief and asks you to confirm up to eight of them. Must-have is used for explicit requirements, Responsibility for role duties and Nice-to-have for desirable experience.

Marxel then builds a review workspace. For each candidate and criterion it shows whether the CV evidences it, needs clarification or doesn't evidence it, with a cited quote from the CV and an interview question to verify it. Marxel's server rejects any quote that doesn't appear word for word in the CV text you supplied.

The connector doesn't rank candidates, sort them into Screening Buckets, make hiring decisions or contact anyone. Your team reads the evidence and decides what to do next. A quote check confirms the words appear in the supplied text; it doesn't confirm that the CV is genuine or that Claude's reading of it is right.

When you want to keep a review, you can save the selected candidates to your Marxel organisation. That creates a Screening Job with your confirmed criteria and starts Marxel screening.

Fictional sample

Ask Claude to “open the Marxel sample shortlist” to try the connector without any real CVs. The sample is a fictional Senior Platform Engineer role at a made-up company, with three invented candidates. This is one of them.

Sam Rivera · Site Reliability Engineer

Fictional sample
Fictional sample evidence for Sam Rivera
CriterionEvidenceInterview question
Lead a cloud migrationMust-haveNeeds clarificationBuilt Terraform modules for an AWS migration; overall project ownership is not stated.What was your responsibility for the migration beyond Terraform delivery?
Own production reliabilityMust-haveEvidencedOwned the on-call programme for 18 services and introduced incident reviews.What changed as a result of your incident reviews?
Mentor other engineersNice-to-haveEvidencedRan fortnightly reliability workshops for eight engineers.How did you measure whether the workshops improved engineering practice?

The fictional sample can't be saved to Marxel.

Add it to Claude

Use either of these:

  1. 1. Once Marxel is listed in Claude's connector directory, add it from there.
  2. 2. In Claude, open Settings → Connectors, choose Add custom connector and enter https://mcp.marxel.co/mcp.

You don't need a Marxel account to compare CVs. Saving a review needs a Marxel account connected through OAuth sign-in.

Tools

The public connector exposes seven tools. Only save_to_marxel writes data.

Marxel connector tools
ToolAccessWhat it does
open_shortlistRead-onlyNo sign-inOpens the review workspace with the labelled fictional sample: its hiring brief, criteria, and each sample candidate's status, source and interview question per criterion.
compare_candidatesRead-onlyNo sign-inCompares candidates from the fictional sample against its hiring brief. It does not compare your CVs.
confirm_criteriaRead-onlyNo sign-inAsks you to confirm job-related criteria before any evidence is extracted. Proposes criteria from the hiring brief; you keep up to eight. Uses a form where the host supports it, otherwise asks in chat.
create_review_workspaceRead-onlyNo sign-inBuilds a candidate comparison and interview questions from CVs you supply, using only the confirmed criteria. Every quote must appear word for word in the supplied CV text. Stores nothing and changes no Marxel records.
list_marxel_organizationsRead-onlySign-in requiredLists the Marxel organisations your account can save a review to.
save_to_marxelWriteSign-in requiredAfter you choose an organisation and confirm the import, creates a Screening Job and the selected Candidate records, then starts screening. Retries with the same request key return the same Screening Job. It never messages candidates or makes hiring decisions.
get_marxel_save_statusRead-onlySign-in requiredChecks a previous save. Returns links to the saved Screening Job, team settings and plan page, the number of candidates imported, and plan details when available.

Sign-in and permissions

The four review tools work without an account. The three save tools use OAuth, with Marxel as the authorisation server. To connect, you sign in to Marxel and approve the request on Marxel's consent page.

The connector requests two scopes:

  • reviews:write lets it list your organisations and save confirmed reviews into an organisation you choose. It doesn't give access to your existing Screening Jobs or Candidates.
  • offline_access keeps the connection working while you remain signed in to Marxel. Access tokens themselves expire after five minutes.

Marxel also has an optional read-only mode that would add a reviews:read scope for existing jobs and candidate evidence. It is turned off on the public connector.

Before anything is saved, Claude lists your organisations, you choose one, and you confirm the import. The save tool only accepts requests marked as confirmed, and Marxel checks that you are still a member of the chosen organisation.

On every request, Marxel verifies the token's signature, issuer, audience, scope and expiry. It also rechecks that your Marxel session is still active, your account isn't suspended, the OAuth client hasn't been disabled and your consent is still in place. A change to any of these takes effect on the next request.

Data handling

When you review candidates

Claude sends the hiring brief, confirmed criteria, CV text and the quotes it extracted to Marxel's connector server. The server checks each quote against the supplied text and returns the workspace. It doesn't store this content, doesn't create or change any Marxel records and doesn't call an AI provider.

The connector server records operational usage for each tool call: the tool name, timing, whether it failed, the client name and version, the server version, the protocol version and an anonymous session ID. CV text, hiring briefs, tool arguments and results are excluded from these records.

When you save a review

Only the candidates you select are imported. Marxel keeps:

  • The hiring brief, when supplied, and your confirmed criteria, on a new Screening Job.
  • For each selected candidate: their name, current role and company, the CV text Claude supplied, and the source label of the CV.
  • The evidence status, quote, source and interview question for each criterion, saved as a candidate note and kept separate from Marxel's own screening results.

Original uploaded files and the Claude conversation are not transferred. The temporary copy of the review used for the import is cleared once the import succeeds. Marxel then screens the imported candidates as it does any other Screening Job, using the AI providers listed on our subprocessors page.

Saved Screening Jobs and Candidates are ordinary Marxel records, handled like any other job in your organisation. For details, see our privacy policy, security overview and data processing agreement. Claude handles conversation data under Anthropic's own terms.

Disconnect

In Claude: remove or disconnect the Marxel connector in Settings → Connectors. Claude then stops calling Marxel's tools.

In Marxel: there's no settings page for revoking connected apps yet. Because every request is checked against the Marxel session you approved it with, signing out of Marxel in that browser stops further saves. Changing your password in Settings → Security also signs out your other sessions. To have the authorisation removed from your account, email support@marxel.co.

Disconnecting doesn't delete reviews you already saved. Delete those Screening Jobs in Marxel like any other job.

Limits and troubleshooting

  • Up to five candidates and eight confirmed criteria per workspace. Claude should ask you to choose a batch of five rather than drop candidates.
  • Up to 40,000 characters of text per CV and 20,000 characters per hiring brief, and requests of at most 1 MB.
  • The interactive workspace, criteria form and review export appear only where the host supports them. Elsewhere, Claude works with the results in the conversation.
  • The connector doesn't search your existing Marxel jobs or candidates.

Saving returns a sign-in error

Comparing CVs needs no account, but listing organisations, saving and checking save status need a connected Marxel account. Connect Marxel from Settings → Connectors in Claude, sign in and approve access, then ask Claude to save again. Nothing is saved until you do.

The review workspace failed

Each quote must appear word for word in the CV text supplied in that request, and a workspace takes at most five candidates and eight confirmed criteria. Ask Claude to recheck the quotes or split the CVs into batches of five.

The save failed or timed out

Retry with the same save request. Marxel returns the existing Screening Job instead of creating a duplicate. If the review or the selected candidates changed, the save needs a new request.

Marxel says a plan limit was reached

Imported candidates count towards your organisation's monthly CV screening allowance. Check your plan in Marxel, then retry with the same save request.

Saving stopped working after it worked before

The connection depends on your Marxel sign-in. If you signed out, changed your password, or lost access to the organisation, reconnect Marxel in Claude and sign in again.

Need help?

Email us with what you asked Claude and what happened. Please don't include real CVs in support requests.

support@marxel.co