Marvin Recruiter

io.github.marvin-recruiterPublished by GitHub account marvin-recruiterv1.0.0Updated Oct 29, 2026

Recruitment ATS + CRM for agencies: candidates, jobs, pipeline and outreach, with your permissions.

VerifiedStreamable HTTPWeb executableProductivity & WorkflowCommunication & CollaborationBusiness & Commerce

Overview

AI-generated overview

Remote MCP server for Marvin Recruiter, giving an assistant access to a recruitment agency's candidates, jobs, pipeline and outreach under the user's own…

What you can do
  • Search, count, filter and read records such as candidates, contacts, companies, jobs, processes, missions and notes, plus saved searches, statistics and team lists
  • Create, update, duplicate, merge and delete records, notes, lists and reminders
  • Manage hiring pipelines: move stages, add feedback, schedule interviews, handle applications and close job pipelines
  • Match and score candidates against jobs, compare candidates and find similar profiles or jobs
  • Draft outreach, briefs, summaries, interview questions and next-step suggestions, then send messages or enrol people in sequences
  • Search and import LinkedIn profiles, enrich contacts, publish jobs to boards or career pages, and run Marvin's…
When to use it
For recruitment agencies, IT consultancies and staffing firms whose teams already work in Marvin Recruiter and want an AI assistant to search the database, prepare briefs and outreach, and move candidates through pipelines without leaving the chat.
Requirements
A Marvin Recruiter account with a seat in the firm's workspace; no anonymous access or shared key. The hosted endpoint uses Streamable HTTP with OAuth 2.1 sign-in through a browser (Google account). Clients using an mcp.json file need the mcp-remote bridge and Node.js 18 or later. Some tools depend on workspace features or admin roles.
Before you install
The assistant acts with the user's own account permissions, and actions are recorded under the user's name. It can write, delete, merge, send LinkedIn, email or WhatsApp messages, enrol people in sequences, publish jobs and spend enrichment credits; sensitive actions start as a preview and need confirmation. LinkedIn and email features require connected accounts, and recruitment data is sent to the hosted service in France.

Installation

In SourceWeft

  1. Open Marvin Recruiter in the dashboard and add it to a workspace.
  2. Connect the required credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.marvin-recruiter%2Fmarvin-recruiter/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config. The client completes OAuth sign-in on first connect.

{
  "mcpServers": {
    "marvin-recruiter": {
      "type": "http",
      "url": "https://mcp.marvins.ai/mcp"
    }
  }
}

README

Marvin Recruiter MCP server

Français

The official remote Model Context Protocol server of Marvin Recruiter, the recruitment software for recruitment agencies, IT consultancies and staffing firms, published by MARVIN SAS (Paris, France).

It gives Claude, ChatGPT, Cursor and other MCP clients access to your firm's recruitment database (candidates, contacts, companies, jobs, hiring processes, missions and timesheets, notes, lists, sequences and history), with the permissions of your own Marvin account.

https://mcp.marvins.ai/mcp

This repository holds the documentation and the server.json published to the official MCP Registry. It contains no server code: the server is a hosted service, operated by Marvin.

Requirements

  • A Marvin Recruiter account, with a seat in your firm's workspace. There is no anonymous access and no shared key: each user connects with their own account.
  • The MCP server is included in every Marvin plan, with no per-request credit. Your AI assistant subscription stays your own.

At a glance

Endpointhttps://mcp.marvins.ai/mcp
TransportStreamable HTTP
AuthenticationOAuth 2.1 with PKCE and dynamic client registration (RFC 7591)
OAuth metadatahttps://mcp.marvins.ai/.well-known/oauth-protected-resource, https://mcp.marvins.ai/.well-known/oauth-authorization-server
Capabilitiestools, resources, prompts
Tools53
Prompts8

Connect

The same address works for every firm: your sign-in decides the account, the workspace and the permissions. On first use, your client opens a browser window: sign in to Marvin (the sign-in page uses your Google account; if a Marvin session is already open in the same browser, it is reused) and approve the access.

Claude (web and desktop)

Settings → Connectors → Add custom connector, then paste https://mcp.marvins.ai/mcp.

Claude Code

bash
claude mcp add --transport http marvin https://mcp.marvins.ai/mcp

Then run /mcp in Claude Code and choose the server to sign in.

ChatGPT

Settings → Connectors (Apps), add a custom connector with the URL https://mcp.marvins.ai/mcp and the OAuth authentication. Availability of custom connectors depends on your ChatGPT plan and workspace settings.

Cursor and other clients that use an mcp.json file

Use the mcp-remote bridge, which handles the OAuth sign-in through your browser (requires Node.js 18 or later):

json
{  "mcpServers": {    "marvin": {      "command": "npx",      "args": ["-y", "mcp-remote@latest", "https://mcp.marvins.ai/mcp"]    }  }}

Keep the @latest suffix: older versions of mcp-remote can hang on tool calls.

Any other MCP client

Point the client at https://mcp.marvins.ai/mcp with the Streamable HTTP transport. The server answers unauthenticated requests with 401 and a WWW-Authenticate header that points to its OAuth metadata, so clients that implement MCP authorization discover the sign-in on their own.

Security

  • One sign-in per user (OAuth 2.1). No shared token.
  • Every request is limited to the user's firm and follows Marvin roles: a record from another firm returns nothing, and the assistant cannot do anything the user's account could not do. Actions are recorded under the user's name.
  • Sensitive actions (sending a message, enrolling people in a sequence, publishing a job, deleting or merging records, paid enrichment) start as a preview. They only run after the user confirms, in the client's confirmation form when it has one, or in Marvin.
  • Data is hosted in France.

Tools

Tool names are stable identifiers. Some tools depend on the features enabled in your workspace (connected LinkedIn or email account, job board publishing, contact enrichment credits) or on your role (admin-only tools are marked). A workspace admin can choose a lighter tool set to make the assistant faster.

Search and read

ToolWhat it does
searchSearch candidates, contacts, companies, jobs, processes, missions, notes and other records, with filters.
countCount records matching filters.
read_resourceRead a record in full (job description, resume text, company profile...).
boolean_searchKeyword search with boolean operators across profiles.
statsGrouped statistics on records (by stage, owner, status, period...).
stale_entitiesFind records with no recent activity, to follow up.
run_saved_searchRun one of the user's saved searches.
recent_searchesList the user's recent searches.
custom_fields_listList the custom fields defined by the workspace.
list_team_membersList the members of the firm.
get_authenticated_userShow the connected account and workspace.
helpLook up Marvin's documentation.

Create and update

ToolWhat it does
createCreate a record (candidate, contact, company, job, process, note, reminder, list...).
updateUpdate a record.
duplicate_jobDuplicate an existing job as a new one.
merge_recordsMerge duplicate people or companies (preview first, can be undone for 30 days).
manage_taxonomyCurate the workspace's jobs and skills reference (admins).
exportExport a list of companies as CSV (admins, when enabled for the workspace).

Delete

ToolWhat it does
delete_recordDelete a person, company or job (preview first, explicit confirmation).
delete_noteDelete a note.
delete_listDelete a list.
delete_reminderDelete a reminder.

Pipeline and applications

ToolWhat it does
advance_process_stageMove a candidate to another stage of a hiring process.
add_feedbackAdd interview feedback to a process.
schedule_next_interviewRecord the next interview of a process in Marvin, with a reminder (no calendar invitation is sent).
close_job_pipelineClose all remaining candidates of a job in one go (preview first).
applicationsList incoming applications for a job, accept or decline them (preview first).

Matching

ToolWhat it does
match_candidates_to_jobFind candidates in the database who fit a job.
match_jobs_to_personFind jobs that fit a candidate.
find_similar_personsFind profiles similar to a given person.
find_similar_jobsFind jobs similar to a given job.
score_candidates_for_jobRank candidates for a job, with the reasons for each score.
compare_candidatesCompare several candidates against a job.

Writing and analysis

These tools gather the data from Marvin and, where the client supports MCP sampling, have your own assistant write the text.

ToolWhat it does
draft_outreach_for_personDraft a personalised outreach message.
find_and_outreachFind candidates for a job and draft a message for each.
generate_brief_from_processWrite a candidate brief for the client from a hiring process.
summarize_person_activitySummarise the recent activity on a record.
suggest_next_actionSuggest the next step for a process.
generate_interview_questionsPrepare interview questions for a candidate and a job.
detect_duplicate_personsDetect likely duplicate people.
auto_tag_personSuggest tags for a person.

Outreach

ToolWhat it does
send_messageSend a LinkedIn, email or WhatsApp message, or a LinkedIn invitation, from the user's connected account (preview first).
enroll_in_sequenceEnrol people in an outreach sequence (preview first).

LinkedIn and enrichment

ToolWhat it does
linkedin_searchSearch LinkedIn profiles through the user's connected account.
linkedin_lookup_profileLook up a LinkedIn profile.
import_linkedin_profileImport a LinkedIn profile into the database.
enrich_person_from_linkedinUpdate a record from its LinkedIn profile.
enrich_person_contactFind a professional email or phone number, using the firm's enrichment credits (cost shown and confirmed first).

Job publishing

ToolWhat it does
diffuse_job_to_boardsPublish a job on the job boards configured by the firm (preview first).
unpublish_job_from_boardRemove a job from a job board.
manage_career_pagePublish a job on the firm's career page, or take it down.

Marvin actions

ToolWhat it does
find_actionsFind an action available in Marvin's built-in assistant.
execute_actionRun that action, with the same confirmation rules as in Marvin.

Prompts

PromptWhat it produces
brief-candidateA structured candidate brief, ready to send to the client.
interview-summaryA summary of the latest interview of a process.
sourcing-planA sourcing plan for a job: target personas, keywords, expected volume.
relance-candidatA short, personalised follow-up message to a candidate.
recap-pipelineThe state of a job's pipeline, stage by stage, with highlights and risks.
bilan-missionA review of a consulting or interim management mission.
prepa-rendez-vousPreparation notes for a client meeting.
cartographie-marcheA market map for a job or a sector: target companies, profiles already in the database, priorities.

License

The documentation in this repository is released under the MIT License. The Marvin name and logo are not covered by this license. The Marvin service is subject to its own terms.

Source: README.md at commit 3dd7591

Tools

0
This server asks you to sign in, so SourceWeft could not read its tools without an account and has not indexed them. What a connected account sees can depend on that account and its permissions.

Version history

1
  1. v1.0.0LatestOct 29, 2026

Score

85% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts