MCP Server

Connect AI assistants such as Claude, ChatGPT, Cursor and VS Code to your Recruitly account using the Model Context Protocol. Once connected, you can search, read and (when your account allows it) update Recruitly records in plain English.

Endpoint

https://mcp.recruitly.dev/mcp

Every client below takes this one URL. No API key is pasted anywhere: the client opens a Recruitly sign-in page and receives its own token.

Authentication

The server uses OAuth. The first time a client connects, a browser window opens so you can sign in to Recruitly. After that the connection stays signed in until the token expires, when the client asks you to sign in again.

Supported sign-in methods:

• Google: sign in with your Google account
• Microsoft: sign in with your Microsoft account
• Email OTP: enter your email address and the 8-digit code Recruitly sends you

You must already be an active user on a Recruitly account. Sign-in is refused otherwise.

Setup

Claude.ai

1. Open Settings, then Connectors.
2. Choose Add custom connector.
3. Enter the name Recruitly and the URL https://mcp.recruitly.dev/mcp, then Add.
4. Click Connect and sign in to Recruitly when the browser window opens.

The connector is then available in every chat from the tools menu.

Claude Desktop

Claude Desktop uses the same connector as Claude.ai. Open Settings, then Connectors, choose Add custom connector, enter https://mcp.recruitly.dev/mcp and connect. Connectors added on Claude.ai also appear in the desktop app once you sign in with the same account.

Claude Code

claude mcp add --transport http recruitly https://mcp.recruitly.dev/mcp

The next time you start claude, a browser window opens for the Recruitly sign-in. Use claude mcp list to check the connection and claude mcp remove recruitly to remove it.

ChatGPT

1. Open Settings, then Connectors.
2. Under Advanced, turn on Developer mode if it is not already on.
3. Choose Create and enter the name Recruitly and the MCP server URL https://mcp.recruitly.dev/mcp, with OAuth as the authentication method.
4. Sign in to Recruitly when the browser window opens.

Company knowledge and deep research use the search and fetch tools, which find and read records across candidates, jobs, contacts, companies, leads, opportunities, placements and tasks. Chats with the connector enabled can use every tool.

Cursor

Open Cursor Settings, then MCP, and choose Add new MCP server, or add this to .cursor/mcp.json:

{
  "mcpServers": {
    "recruitly": {
      "url": "https://mcp.recruitly.dev/mcp"
    }
  }
}

Cursor detects that the server uses OAuth and opens the Recruitly sign-in page when you first enable it.

VS Code

Run MCP: Add Server from the command palette and choose HTTP, or add this to .vscode/mcp.json:

{
  "servers": {
    "recruitly": {
      "type": "http",
      "url": "https://mcp.recruitly.dev/mcp"
    }
  }
}

Start the server from the file or from the MCP: List Servers command and sign in to Recruitly when prompted.

Access control

A Super user decides who can connect and what an assistant may change:

• In Recruitly, open Settings, then AI Assistant Access. In the new Recruitly app it lives under User Management, then AI Assistant Access.
• Only allow selected users to use AI assistants restricts connections to Super users and the users switched on in the list. When it is off, every active user can connect.
• Allow AI assistants to make changes is off by default. Until it is switched on, assistants can only read data; every write tool returns a message saying that changes are switched off.
• Every request runs as the signed-in user, with that user's normal permissions. An assistant cannot see or change anything the user could not see or change in Recruitly.
• Deleting records is not available through the connector.

The same page shows, for each user, whether they have connected an assistant, which one, and when it was last used.

Next steps

• What the assistant can do: every tool, grouped by area, with example prompts
• Playbook: day-to-day recruiting routines as prompt sequences