How to Use the CATS ATS MCP in Windsurf

Q: How does Windsurf use CATS ATS tools to find candidates?

Cascade uses searchcandidates to filter profiles based on your criteria. It then chains getcandidatedetails to fetch full resumes and notes without requiring manual prompts for each step.

Let Windsurf Cascade chain CATS ATS tools to screen candidates and update job orders without manual hopping.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect CATS ATS MCP to Windsurf

Create your Vinkius account to connect CATS ATS to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup CATS ATS with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Run Multi-Step Recruiting Flows in Windsurf

Cascade handles your recruiting pipeline by linking CATS ATS queries together, starting with `list_job_orders` to check open requirements. When you ask it to find matches for an open position, it pulls matching resumes using `search_candidates` right away. You do not have to copy-paste data between prompts. The agent handles the handoffs, running `get_candidate_details` on the top profiles so you get a curated shortlist in one go.

Track Daily Hiring Activities Automatically

Keep tabs on active accounts by calling `list_recruitment_activities` directly from your editor. Cascade queries recent notes to see what your team did yesterday, comparing those updates against your active client list from `list_recruitment_companies`. This MCP Server connection lets your agent draft daily summaries or flag inactive accounts. It matches companies with contacts using `list_recruitment_contacts` so you always know who to call next.

Deep-Dive Into Candidate Profiles

Stop digging through browser tabs and run `get_candidate_details` to find candidate histories instantly. Cascade extracts their work history, notes, and status directly into your chat sidebar. If the candidate looks promising, the agent grabs the original job spec via `get_job_details` to verify the fit. It does this in a single execution thread, saving you from manual searches.

Setup guide

Set up CATS ATS MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the CATS ATS MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my CATS ATS payment history." If connected, Cascade will call the CATS ATS tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "cats-ats-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by CATS ATS. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect CATS ATS now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about CATS ATS MCP in Windsurf

Cascade uses `search_candidates` to filter profiles based on your criteria. It then chains `get_candidate_details` to fetch full resumes and notes without requiring manual prompts for each step.

This MCP Server currently focuses on reading and searching your recruiting data. Cascade uses `list_job_orders` and `get_job_details` to read active positions, helping you analyze requirements directly in your workspace.

No, Vinkius manages the authentication. You add the MCP Server to your `mcp_config.json` file with your single Vinkius token, and Cascade instantly gains access to the tools.

Open your settings, go to Cascade, and add the server under the MCP section. You can also edit your local config file directly to point to the Vinkius endpoint.

Your recruitment data, candidate profiles, and job orders pass through a zero-trust V8 sandbox. Vinkius ensures your credentials and ATS data are never stored or exposed to external parties.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript