How to Use the Zeev MCP in Windsurf

Q: How can I find existing processes in Zeev using Windsurf?

Just use the listprocesses tool. This shows every available BPMN workflow definition that your agent can potentially run. You'll see names and descriptions for everything from HR onboarding to vendor payment cycles.

Q: If a Zeev task fails, how do I check its details with Windsurf?

You get the specific task ID and feed it into gettask. This gives you granular detail on why the process stopped—was it bad input data? Was an approval step missed? It’s all right there.

Q: Does Zeev support delegation when using Windsurf?

Yes. You can use delegatetask to hand off a specific action within the workflow to another user or team member. This is perfect for complex processes that require human sign-off from someone else.

Q: How do I check my own profile when using the Zeev MCP Server with Windsurf?

Use the getme tool. This simple call pulls your current user information, confirming who is running the automation or who needs to approve a step.

Automate complex business workflows right in Windsurf.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Zeev MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Start a new process flow.

The `create_request` tool lets your agent kick off any defined Zeev workflow. You set the goal—say, 'Approve expense report for Q3'—and Cascade handles generating and starting the whole sequence. It immediately returns an active request ID. This means you don't have to manually run each step; Windsurf just keeps tracking the process until it hits a defined endpoint.

Get status on any running job.

Need to know where that multi-step workflow landed? Use `get_request` to pull up specific details about an instance. You'll see exactly which step is currently waiting for approval or data input. If you just want a quick overview, the `list_requests` tool pulls all active processes in Zeev. It’s perfect for checking if any of your parallel automations are stalled.

Manage and close out tasks.

When a process is done, you need to wrap it up properly. The `finish_task` tool marks the entire Zeev workflow as complete, which is crucial for auditing. You don't want pending status flags messing up your reporting. Conversely, if something went wrong or got canceled early, the `cancel_request` tool lets you shut down the process cleanly. It stops resource consumption and frees up the task thread.

Setup guide

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

mcp_config.json

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

Just use the `list_processes` tool. This shows every available BPMN workflow definition that your agent can potentially run. You'll see names and descriptions for everything from HR onboarding to vendor payment cycles.

You get the specific task ID and feed it into `get_task`. This gives you granular detail on why the process stopped—was it bad input data? Was an approval step missed? It’s all right there.

Yes. You can use `delegate_task` to hand off a specific action within the workflow to another user or team member. This is perfect for complex processes that require human sign-off from someone else.

It touches process definitions, active request instances, and user task statuses. These are all workflow state records managed by Zeev's BPMN engine.

Use the `get_me` tool. This simple call pulls your current user information, confirming who is running the automation or who needs to approve a step.

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