How to Use the ClockShark MCP in Windsurf

Use Windsurf to manage your field crew's hours and project budgets without leaving your IDE.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect ClockShark MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate crew scheduling in Windsurf

Cascade can handle your field schedule by calling `create_shift` directly from your editor. It reads your project requirements and maps them to your current staff roster. Stop switching tabs to check availability. You just tell the agent who needs to work, and it pushes the data straight into your account.

Track job progress with this MCP Server

Use `list_jobs` and `list_tasks` to pull active project data into your Windsurf chat. The agent interprets the current status of your construction sites instantly. It avoids the manual lookup process entirely. You see the exact task list and project names as they exist in your backend.

Audit field labor data

The agent uses `list_timesheets` to fetch recent entries for your review. It parses the raw log data to find discrepancies in your labor costs. You gain visibility into how your budget is spent. The agent presents a clear breakdown of hours billed against your active jobs.

Setup guide

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

mcp_config.json

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

Connect the server through the Cascade MCP settings panel. Once linked, you can ask the agent to pull specific timesheet logs using the available toolset.

Yes, Cascade can trigger the scheduling tools to post new shifts. It handles the API calls so you don't have to navigate the web portal.

It provides the data you need to calculate costs. By querying the job and timesheet records, your agent performs the math based on real-time field data.

Your API tokens stay inside your local configuration files. Vinkius manages the connection, but your secrets never leave your local machine.

We only touch your timesheet and employee records. The connection is encrypted and limited to the specific tools required for your tasks.

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