cats

CATS through One

CATS is a web-based applicant tracking system designed for recruiting agencies and HR teams, offering tools for job posting, resume parsing, candidate tracking, custom workflows, analytics, and integrations to streamline the hiring process.

One exposes CATS through four MCP tools. The table below carries real action ids from One's knowledge base, so for a common operation you can skip search and go straight to reading the action's parameters.

How to run an action

1. Find the action in the table below, or call search_one_platform_actions with platform cats if it is not listed.
2. Call get_one_action_knowledge with the action id. Do this every time, including for actions in this table. The table gives you the id, not the parameters.
3. Call execute_one_action with parameters copied from that knowledge.

Never guess a parameter name, a body field, or an enum value. The knowledge has the real schema, and a guessed field is either a 400 or a silent write of the wrong thing.

Before you start

Call list_one_integrations once and confirm CATS is connected. If it is missing, the user has not connected it: say so and point them at https://app.withone.ai rather than reaching for raw HTTP.

Each connection carries an access field. If it reports {"policy": "methods", "methods": ["GET"]} the agent is read-only here, so plan a read-only answer instead of attempting a write that will be refused.

Before a write

Creates, updates, deletes and sends land on a real CATS account and cannot be recalled. State the action and the specific target in one line before the first write in a task, and let the user stop you. Reads need no confirmation.

Actions

Candidates

Action	Method	Path	Action id
Get a Candidate	GET	/candidates/{{id}}	conn_mod_def::GJ1ERox390A::OpL1GjeKQj2UVbdNm5394w
Get a Candidate Thumbnail	GET	/candidates/{{id}}/thumbnail	conn_mod_def::GJ1ESt1BdI4::GbuAF-ZbRHmRaRq7VkSyXg
Get a Candidate’s Custom Field Value	GET	/candidates/{{candidateId}}/custom_fields/{{customFieldId}}	conn_mod_def::GJ1ESD8cF3g::uGcz7a96Saece1bEfZn59w
List a Candidate’s Custom Field Values	GET	/candidates/{{id}}/custom_fields	conn_mod_def::GJ1EUEF8gv0::a4JdlGr9SpSadMTh2HD-Sw
List a Candidate’s Work History	GET	/candidates/{{id}}/work_history	conn_mod_def::GJ1EU1Ae2Gg::KaWM210MSxGuEJOX2TRrRQ
List Candidates	GET	/candidates	conn_mod_def::GJ1ETghUi8I::BR4AVHc2SESmScxa2_MjTw
Search Candidates	GET	/candidates/search	conn_mod_def::GJ1EVQBoyMw::EDeuPy4pRvuri50ASWdwtA
Attach Tags to a Candidate	PUT	/candidates/{{candidateId}}/tags	conn_mod_def::GJ1EPEGpeIs::0_oDEq2fQMGWbTYDHIfA3Q
Authorize a Candidate	POST	/candidates/authorization	conn_mod_def::GJ1EPLhmHbk::kXg8ZQ9oTkSBmbIVsVQoLg
Change a Candidate’s Thumbnail	PUT	/candidates/{{id}}/thumbnail	conn_mod_def::GJ1EPWqYKsI::wiXHRQmJSXCpqMDzDv7QoA
Create a Candidate	POST	/candidates	conn_mod_def::GJ1EPgsa2C4::KZbQY62RS9GryjAc4drTHA
Delete a Candidate	DELETE	/candidates/{{id}}	conn_mod_def::GJ1EQhR4UoQ::OJFEMjPIQ0yyPcwGSTcgXg