How to Use the HCSS MCP in VS Code Copilot

Give your engineering team live access to HCSS job data, equipment telematics, and timecards directly inside VS Code Copilot.

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 VS Code Copilot

Create your Vinkius account to connect HCSS to VS Code Copilot 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 VS Code Copilot

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Query Construction Jobs in VS Code Copilot

The `list_jobs` and `list_business_units` tools pipe your active construction sites straight into your IDE. When your team builds internal dashboards, Copilot fetches the real project list to test the API wrappers you just wrote. Pre-construction data dictates future revenue. The `list_precon_projects` tool grabs projects that have not broken ground yet. Your agent uses this data to populate staging environments with realistic project phases and budgets.

Validate HeavyJob Cost Codes

The `list_cost_codes` and `list_timecards` tools allow your AI client to read field labor submissions instantly. You ask Copilot to write a script that flags overtime, and it tests the logic against real timecards submitted by your crews. Employee mapping causes endless integration headaches. By calling the `list_employees` tool, Copilot sees exactly how your workers are structured in the ERP. It writes the data transformation layer to match your internal HR system perfectly.

Access Telematics via HCSS MCP Server

The `list_equipment` and `get_equipment_location` tools connect your MCP Server to your fleet's GPS hardware. Copilot pulls the live coordinates for a dozer and writes the exact JSON parsing logic needed to map it on your custom frontend. Bidding accuracy requires granular data. The `get_bid_items` and `list_estimates` tools fetch the exact material quantities from HeavyBid. Your agent reads these line items to help you write accurate cost-tracking algorithms.

Setup guide

Set up HCSS MCP in VS Code Copilot

Prerequisites

VS Code 1.99 or later with GitHub Copilot extension
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and run "MCP: Add Server". Select HTTP (Streamable) as the server type. VS Code will create .vscode/mcp.json in your workspace.
2

Add the HCSS MCP

Paste the JSON snippet shown on the right into your .vscode/mcp.json. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Switch to Agent mode

Open Copilot Chat (Cmd+Shift+I / Ctrl+Shift+I) and switch to Agent mode using the dropdown. MCP tools are only available in Agent mode — they do not appear in Edit or Ask modes.
4

Verify the connection

In the Copilot Chat input, type # to list available tools. You should see the HCSS tools listed. Try asking: "List my recent HCSS transactions" and Copilot will invoke them automatically.

.vscode/mcp.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 VS Code Copilot

Create a .vscode/mcp.json file in your repository root and add the Vinkius HCSS configuration. Commit this file to Git. Every developer opening the project gets instant access to the tools.

No. The HCSS integration for VS Code Copilot exposes read-only endpoints like the timecard list. Your engineers can use it to build approval workflows, but the AI cannot approve hours itself.

Not at all. The integration talks directly to the cloud APIs. Your agent calls the estimates tool over HTTPS, meaning developers on Macs can query data without running Windows VMs.

Open your chat panel and ask the agent to fetch the active cost codes for a specific business unit. It will call the cost code list and print the exact JSON structure right in your editor.

The system handles highly confidential estimate and bid item data. Vinkius manages the authentication state securely, routing traffic through a stateless proxy. Your corporate bidding data never rests on our servers.

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