# Recruitee — how to use (mcp.ai)

Connect your Recruitee account and use 23 tools for talent and recruitment straight from your AI agent. Connect with your own API key. Recruitee is a collaborative hiring software that streamlines recruitment processes, enabling teams to source, interview, and hire candidates efficiently.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_recruitee?ms=1787295960000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `recruitee_create_candidate`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/recruitee`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/recruitee/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/recruitee/create/candidate` — Tool to create a new candidate profile. Use after gathering all candidate details. Example: "Create a new candidate named Jane Doe with email jane.doe@example.com."
  - body: { name: string, tags?: string[], email?: string, phone?: string, photo?: string, offers?: integer[], resume?: string, source?: string, cover_letter?: string, social_links?: string[], custom_fields?: object }
- `POST https://api.mcp.ai/api/recruitee/create/note` — Creates a new note for a candidate in Recruitee. Notes can be used to record interview feedback, assessments, or any observations about the candidate. Use this when you need to add commentary or docum
  - body: { note: object, candidate_id: string }
- `POST https://api.mcp.ai/api/recruitee/create/offer` — Creates a new job offer or talent pool in Recruitee. Required fields include title, location IDs, and description. Use Get Locations action to retrieve valid location IDs before creating an offer. The
  - body: { offer: object }
- `POST https://api.mcp.ai/api/recruitee/delete/candidate` — Tool to delete a candidate profile. Use when you need to permanently remove a candidate from your Recruitee account. Returns no content on success.
  - body: { candidate_id: integer }
- `POST https://api.mcp.ai/api/recruitee/delete/tag` — Permanently deletes a tag from Recruitee by its ID. This action requires appropriate API permissions to delete tags. Use this when you need to remove unused or obsolete tags. Note: Deleting a tag remo
  - body: { tag_id: integer }
- `POST https://api.mcp.ai/api/recruitee/get/candidate` — Tool to retrieve detailed information about a specific candidate. Use when you need the candidate's full profile before proceeding.
  - body: { company_id?: integer|string, candidate_id: integer }
- `POST https://api.mcp.ai/api/recruitee/get/candidates` — Tool to retrieve a list of all candidates in the company. Use when you need to fetch or filter candidates before proceeding.
  - body: { ids?: integer[], sort?: string, limit?: integer, query?: string, offset?: integer, deleted?: boolean, offerId?: integer, qualified?: boolean, company_id?: integer|string, createdAfter?: string, disqualified?: boolean }
- `POST https://api.mcp.ai/api/recruitee/get/company/id` — Tool to retrieve the company ID of the authenticated account. Use when you need to confirm your company identity before other operations.
- `POST https://api.mcp.ai/api/recruitee/get/company/offer/public` — Tool to retrieve a specific published job offer by ID or slug from the public Careers Site API. Use after you have the offer identifier.
  - body: { identifier: string }
- `POST https://api.mcp.ai/api/recruitee/get/departments` — Tool to retrieve a list of company departments. Use when you need to reference or assign offers or candidates to departments.
- `POST https://api.mcp.ai/api/recruitee/get/locations` — Tool to retrieve a list of company locations. Use when you need to see all location options before assigning them to offers.
- `POST https://api.mcp.ai/api/recruitee/get/notes` — Tool to retrieve a list of notes for a specific candidate. Use after confirming the candidate exists when you need to review their notes.
  - body: { limit?: integer, offset?: integer, candidate_id: integer }
- `POST https://api.mcp.ai/api/recruitee/get/offers` — Tool to retrieve a list of all job offers. Use after authentication to browse or paginate your company's complete set of offers.
  - body: { limit?: integer, query?: string, offset?: integer, company_id?: integer|string }
- `POST https://api.mcp.ai/api/recruitee/get/pipeline/stages` — Tool to retrieve pipeline stages of a job offer. Use when you have the offer ID and need its stages to track candidate progression. Example: "Get pipeline stages for offer ID 456."
  - body: { offer_id: integer }
- `POST https://api.mcp.ai/api/recruitee/get/tags` — Retrieve all tags with optional filtering and pagination. Search by name, sort by name or usage count, and paginate through results.
  - body: { page?: integer, query?: string, sort_by?: string, per_page?: integer, sort_order?: string }
- `POST https://api.mcp.ai/api/recruitee/list/eeo/job/categories` — Tool to retrieve available EEO (Equal Employment Opportunity) job categories. Use when you need to see standard EEO job classification options.
- `POST https://api.mcp.ai/api/recruitee/list/invoices` — Tool to list invoices for a company. Use to retrieve billing invoice records.
  - body: { company_id?: integer|string }
- `POST https://api.mcp.ai/api/recruitee/list/localization/settings` — Tool to retrieve localization settings including proposed time format and start day of the week. Use when you need to check regional or time display preferences.
- `POST https://api.mcp.ai/api/recruitee/list/share/countries` — Tool to retrieve all countries with region codes and phone codes per locale. Use when you need comprehensive country reference data including internationalization details.
- `POST https://api.mcp.ai/api/recruitee/list/share/eeo/answers` — Tool to retrieve available EEO (Equal Employment Opportunity) answers. Use when you need to see available answer options for EEO compliance questions.
- `POST https://api.mcp.ai/api/recruitee/update/candidate` — Updates an existing candidate's information in Recruitee. Use this to modify candidate details such as name, contact info, cover letter, tags, and social links. All fields except candidate_id are opti
  - body: { name?: string, tags?: string[], email?: string, phone?: string, photo?: string, offers?: integer[], resume?: string, source?: string, candidate_id: integer, cover_letter?: string, social_links?: string[], custom_fields?: object }
- `POST https://api.mcp.ai/api/recruitee/update/note` — Tool to update an existing note for a candidate. Use when you need to modify note text or pin status after creation.
  - body: { body?: string, pinned?: boolean, note_id: integer, candidate_id: integer }
- `POST https://api.mcp.ai/api/recruitee/update/offer` — Updates an existing job offer or talent pool in Recruitee. Allows modification of offer details including title, description, requirements, status, locations, department assignment, work type (remote/
  - body: { kind?: string, title?: string, hybrid?: boolean, remote?: boolean, status?: string, on_site?: boolean, offer_id: integer, options_cv?: string, description?: string, location_ids?: integer[], requirements?: string, department_id?: integer, options_phone?: string, options_photo?: string, locations_question?: string, visibility_options?: string[], options_cover_letter?: string, locations_question_type?: string, locations_question_required?: boolean }

## Example prompts
- "What can I do in Recruitee?"
- "Show me a summary of my Recruitee account"

## More
- Page: https://mcp.ai/recruitee
- Agent spec (llms.txt): https://mcp.ai/recruitee/llms.txt
- Postman collection: https://mcp.ai/recruitee/postman.json