MCP server
CATS MCP by usefulapi
Read CATS candidates, jobs and pipelines, and make explicitly confirmed recruiting…
- Runs
- Remotely
- Version
- 1.12.0
- Listing updated
- 4 days ago
About CATS MCP by usefulapi
CATS MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.
Read CATS candidates, jobs and pipelines, and make explicitly confirmed recruiting changes.
Install
Run in a terminal
claude mcp add --transport http cats-ats https://cats-ats.usefulapi.io/mcpAdd to Settings → Connectors → Add custom connector
https://cats-ats.usefulapi.io/mcpInstall in CursorOpens Cursor, which asks you to confirm. Or add it by hand:
Add to ~/.cursor/mcp.json
{
"mcpServers": {
"cats-ats": {
"url": "https://cats-ats.usefulapi.io/mcp"
}
}
}Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:
Add to .vscode/mcp.json
{
"servers": {
"cats-ats": {
"type": "http",
"url": "https://cats-ats.usefulapi.io/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"cats-ats": {
"serverUrl": "https://cats-ats.usefulapi.io/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"cats-ats": {
"type": "http",
"url": "https://cats-ats.usefulapi.io/mcp"
}
}
}Tools this server provides (34)
Read directly from the server.
- cats_get_site
- The CATS site (account) this API key belongs to: id, mode (recruiter or employer) and subdomain. GET /site.
- cats_list_users
- List the CATS users (recruiters) with id, name, title and access level. Use the ids as owner or assignee. GET /users.
- cats_list_candidates
- List candidates (personal data: name, emails, address, employer, skills, notes), one page at a time, max 100 per page. Use cats_search_candidates or cats_filter_candidates to find specific people. GET /candidates.
- cats_get_candidate
- One candidate by id (personal data). GET /candidates/{id}.
- cats_search_candidates
- Free-text search over candidates (name, email, skills, resume text...), paged. GET /candidates/search?query=.
- cats_filter_candidates
- Filter candidates by fields (read-only, although it is a POST): first_name, last_name, title, emails.primary, address.city/state/postal_code, country_code, current_employer, key_skills, notes, dates (date_created, date_modified), owner_id, is_hot... Each condition is {field, filter, value}; filters: exactly, contains, between {gte,lte}, greater_than, less_than, is_empty, geo_distance. Paged. POST
- cats_list_candidate_pipelines
- The jobs a candidate is in the pipeline for, with rating, workflow and current status id. GET /candidates/{id}/pipelines.
- cats_list_candidate_activities
- The activity log of a candidate (calls, meetings, notes, pipeline changes), paged. GET /candidates/{id}/activities.
- cats_list_candidate_tasks
- Tasks attached to a candidate. GET /candidates/{id}/tasks.
- cats_list_candidate_attachments
- File names, sizes and whether each file is a resume, for a candidate's attachments. Metadata only: file contents are never downloaded. GET /candidates/{id}/attachments.
- cats_list_jobs
- List job orders with title, location, company, recruiter, status and workflow ids, dates. Paged. GET /jobs.
- cats_get_job
- One job order by id, with its description. GET /jobs/{id}.
- cats_search_jobs
- Free-text search over job orders, paged. GET /jobs/search?query=.
- cats_list_job_pipelines
- The candidates in the pipeline of a job: pipeline id, candidate id, rating and current status id. Paged. GET /jobs/{id}/pipelines.
- cats_list_job_statuses
- The statuses a job order can have (Active, OnHold, Closed...). GET /jobs/statuses.
- cats_list_pipelines
- List candidate-to-job pipelines (candidate id, job id, rating, workflow id, status id), paged. GET /pipelines.
- cats_get_pipeline
- One pipeline (a candidate on a job) by id. GET /pipelines/{id}.
- cats_filter_pipelines
- Filter pipelines by id, candidate_id, job_id, status_id, rating, date_created or date_modified (read-only, although it is a POST). Each condition is {field, filter, value}. Paged. POST /pipelines/search.
- cats_get_pipeline_status_history
- The status changes of a pipeline over time (status, who, when). GET /pipelines/{id}/statuses.
- cats_list_workflows
- The pipeline workflows (sets of statuses such as Contacted, Interviewing, Offered). GET /pipelines/workflows.
- cats_list_workflow_statuses
- The statuses of one pipeline workflow (id, title, prerequisites, triggers). Use the ids with cats_change_pipeline_status. GET /pipelines/workflows/{id}/statuses.
- cats_list_companies
- List client companies (name, address, website, owner), paged. GET /companies.
- cats_get_company
- One company by id. GET /companies/{id}.
- cats_search_companies
- Free-text search over companies, paged. GET /companies/search?query=.
- cats_list_contacts
- List client contacts (personal data: name, title, emails, company), paged. GET /contacts.
- cats_get_contact
- One client contact by id (personal data). GET /contacts/{id}.
- cats_search_contacts
- Free-text search over client contacts, paged. GET /contacts/search?query=.
- cats_list_tasks
- List tasks (description, priority 1-5, due date, assignee, completion, the record it is about), paged. GET /tasks.
- cats_get_task
- One task by id. GET /tasks/{id}.
- cats_list_activities
- The site-wide activity log (calls, emails logged, meetings, notes) with the record each is about, paged. GET /activities.
- cats_add_candidate_activity
- WRITE: Requires confirm:true. log an activity (a call, meeting, note...) on a candidate's record. It only records the entry in CATS: no email/SMS-send request is made, even for type 'email' or 'text_message'. Creates a new entry each time (not idempotent). POST /candidates/{id}/activities.
- cats_create_task
- WRITE: Requires confirm:true. create a task in CATS, optionally about a candidate, contact, company or job and assigned to a user. Creates a new task each time (not idempotent); CATS may notify the assignee. POST /tasks.
- cats_change_pipeline_status
- WRITE: Requires confirm:true. change the status of a pipeline (move a candidate to another stage of a job's workflow, e.g. Interviewing, Offered, Rejected). Get the pipeline id from cats_list_candidate_pipelines and the status id from cats_list_workflow_statuses. Requires confirm:true. Requests that status triggers (which can e-mail people or change records) be suppressed: every trigger attached t
- cats_create_candidate
- WRITE: Requires confirm:true. create one candidate record (personal data) with name, optional contact details and notes. Refuses when CATS finds a duplicate (check_duplicate=true, the default). Creates a new record each time (not idempotent); no email-send request is made to the candidate and no login is created. POST /candidates.
CATS MCP by usefulapi FAQ
How do I add CATS MCP by usefulapi to Claude Code?
Run this command in your terminal: claude mcp add --transport http cats-ats https://cats-ats.usefulapi.io/mcp