How to Use the HCSS MCP in Windsurf

Q: Can I cross-reference HCSS estimates with actuals in Windsurf?

Yes. You can have Cascade pull bidding data using listestimates and compare it directly to live project data. This helps you identify budget overruns instantly.

Q: How do I connect the HCSS MCP Server to Windsurf?

Add the server settings to your mcpconfig.json file. Windsurf automatically discovers the tools, making them immediately available to Cascade.

Q: Can Cascade track active pre-construction projects?

Yes, the listpreconprojects tool lets your agent pull up-to-date lists of upcoming jobs. You can analyze bid structures before the project goes live.

Let Cascade chain HCSS MCP Server operations to pull live job data, check equipment meters, and review field timecards directly 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 HCSS MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Track heavy fleet coordinates and meters in Windsurf

The `get_equipment_location` tool pulls real-time GPS coordinates for any active asset in your fleet. You give Cascade a unit number, and it fetches the location and current hours using `get_equipment_meters` in one shot. Cascade uses this data to map out equipment deployment. It flags assets sitting idle or running past service thresholds without making you run separate reports.

Analyze active estimates and bid items autonomously

The `list_estimates` tool exposes your active HeavyBid data directly to your IDE. Cascade reads these estimates, pulls the corresponding details with `get_bid_items`, and highlights discrepancies. You get a clear picture of project margins during the pre-construction phase. The agent connects these estimates to your active work without forcing you to switch windows.

Audit labor and cost codes with this MCP Server

The `list_timecards` tool brings raw labor data from HeavyJob straight into your development environment. Cascade reads the logged hours and matches them against `list_cost_codes` to spot misallocated labor costs. This automated cross-reference stops payroll errors before they hit corporate accounting. You write the rule, and the agent runs the check.

Setup guide

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

mcp_config.json

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

Cascade chains multiple tools to execute complex field operations. It can query list_jobs, pull active timecards, and verify cost codes in a single autonomous run.

Yes. You can have Cascade pull bidding data using list_estimates and compare it directly to live project data. This helps you identify budget overruns instantly.

Add the server settings to your mcp_config.json file. Windsurf automatically discovers the tools, making them immediately available to Cascade.

Yes, the list_precon_projects tool lets your agent pull up-to-date lists of upcoming jobs. You can analyze bid structures before the project goes live.

Your fleet location data remains sandboxed. Vinkius runs the server in an isolated V8 container, ensuring GPS coordinates and meter readings are never stored or exposed to external networks.

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