How to Use the Qualified.io MCP in Windsurf

Let Windsurf Cascade autonomously run your Qualified.io technical screening pipeline from assessment setup to candidate review.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers — Included with Plan

Connect Qualified.io MCP to Windsurf

Create your Vinkius account to connect Qualified.io to Windsurf — we handle the hosting, security, and runtime updates so you don't have to. No server setup required.

GDPR Included with Plan

Setup Qualified.io with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Cascade Configures Qualified.io Assessments via MCP

`create_assessment` is the starting point when you ask Cascade to launch a new hiring track. Because Windsurf chains actions, it doesn't stop at creation; it immediately executes `publish_assessment` to make the test active and then runs `list_challenges` to verify the coding tasks match your requirements. You simply tell the IDE to set up a mid-level React role. Your autonomous agent pulls the right templates, builds the test structure, and confirms everything is live in your dashboard.

Send Cohort Invites via Windsurf Cascade

`invite_candidates_via_cohort` lets you drop an entire applicant batch into a specific test run without leaving your editor. Cascade reads your local CSV or JSON applicant files, matches them to the active assessment ID, and triggers the invitations in one sweep. If a candidate requests a retake or needs to be removed, Cascade handles it instantly. The agent calls `schedule_retry_assessment_result` or `cancel_invitation` based on your chat prompt, keeping your applicant tracking system clean.

Review Candidate Code Directly in Cascade

`get_assessment_result` pulls the candidate's exact code submissions directly into your Windsurf workspace. Cascade analyzes the performance metrics, reads the raw code files, and prepares a draft review using `create_assessment_result_review` for your engineering team to sign off on. You get a clear breakdown of where the candidate struggled without jumping back and forth to a browser. Your agent coordinates the data retrieval, formats the feedback, and lets you approve or reject applicants right from the chat panel.

Setup guide

Set up Qualified.io 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 Qualified.io 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 Qualified.io payment history." If connected, Cascade will call the Qualified.io tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "qualifiedio-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 Qualified.io. 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 Qualified.io 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 Qualified.io MCP in Windsurf

Cascade reads your local workspace context to find applicant details, then invokes `invite_candidates` or `invite_candidates_via_cohort` to send the tests. It coordinates the API calls in a single autonomous chain, so you never have to copy-paste IDs.

Yes, you can inspect candidate code and leave notes. Cascade uses `get_assessment_result` to fetch the submission, then lets you write and update grading feedback with `create_assessment_result_review`.

If a candidate runs out of time, you can instruct Cascade to run `terminate_assessment_result` to close the attempt. For candidates who deserve another shot, Cascade triggers `schedule_retry_assessment_result` to reopen the test.

Absolutely. Cascade can search your existing repository using `list_challenges` and pull specific problem details with `get_challenge` to help you assemble new test suites.

Your candidate test scores and raw code submissions travel directly between the Qualified.io API and your local Windsurf instance. Vinkius runs this MCP connection in a secure, zero-trust sandbox, ensuring applicant PII never leaks or gets stored on third-party systems.

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