How to Use the Kippy MCP in Windsurf

Q: How does Windsurf use Kippy to automate performance reviews?

Windsurf uses Cascade to call listappraisals and compile Kippy feedback. Cascade reads historical Kippy scores, matches them against current benchmarks, and drafts evaluations without manual steps.

Q: How do I add the Kippy MCP Server to my Windsurf configuration?

Open your Windsurf mcpconfig.json file and add the Kippy server details under the mcpServers key. Once saved, Windsurf Cascade immediately detects Kippy tools like listteams and listusers.

Q: What happens when Windsurf encounters missing competency data in Kippy?

When listcompetencies returns an empty set, Windsurf Cascade halts its planning phase and asks you to define the missing skills in Kippy.

Let Windsurf run autonomous performance reviews and track team KPIs directly inside your editor with the Kippy MCP Server.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Kippy MCP to Windsurf

Create your Vinkius account to connect Kippy 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 Kippy with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Autonomously pull Kippy KPI scores inside Windsurf

The Kippy MCP Server exposes the `list_kpis` and `list_kpi_scores` tools so Windsurf Cascade can check organizational performance targets without manual prompts. When you ask Windsurf to analyze a team's progress, Cascade queries these Kippy endpoints directly to build a live performance profile. Cascade uses this real-time Kippy context to highlight lagging metrics and suggest adjustments inside the editor. You don't have to copy-paste spreadsheet data into Windsurf anymore; Cascade handles the Kippy database queries on its own.

Cascade chains Kippy appraisals and competency tracking

The `list_appraisals` and `list_competencies` tools allow Cascade to execute multi-step talent evaluations inside the Windsurf interface. When you set a goal in Windsurf to review a developer's skills, Cascade pulls their past Kippy reviews and compares them to active competency benchmarks. Instead of running single-turn commands, Windsurf coordinates these Kippy tools to find skill gaps and write a draft review. You get a complete evaluation file in Windsurf generated entirely from your live Kippy records.

Audit system logs directly from the Windsurf editor

The `list_audit_logs` tool gives Windsurf instant access to Kippy change records to track who updated performance targets. Cascade reads this Kippy log history to trace modifications and verify that team scores match official entries. If a Kippy KPI score changes unexpectedly, you can tell Windsurf to investigate the discrepancy. Cascade scans the Kippy audit trail and lists the exact timestamps and user IDs responsible for the updates in your editor.

Setup guide

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

mcp_config.json

{
  "mcpServers": {
    "kippy-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 Kippy. 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 Kippy 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 Kippy MCP in Windsurf

Windsurf uses Cascade to call `list_appraisals` and compile Kippy feedback. Cascade reads historical Kippy scores, matches them against current benchmarks, and drafts evaluations without manual steps.

Yes, because the Kippy MCP Server runs in a read-only configuration that prevents Windsurf from altering database records.

Open your Windsurf `mcp_config.json` file and add the Kippy server details under the `mcpServers` key. Once saved, Windsurf Cascade immediately detects Kippy tools like `list_teams` and `list_users`.

When `list_competencies` returns an empty set, Windsurf Cascade halts its planning phase and asks you to define the missing skills in Kippy.

Windsurf processes your Kippy appraisal records locally within its sandbox environment. The Kippy MCP Server transmits these sensitive performance scores over an encrypted endpoint token, keeping your Kippy HR data isolated from external training sets.

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