# HCSS MCP for AI Agents AI Agent Connect

> HCSS MCP lets you manage heavy construction projects directly through your AI agent. It connects your HCSS platform to your workflow, letting you pull timecards from HeavyJob, check HeavyBid estimates, and monitor equipment telematics without switching tabs or exporting CSVs. It's built for construction pros who need real-time field data.

## Overview
- **Category:** erp-operations
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_970fCc55OXJVbuwOsEcxKsbjFfZuXDgGQ2GpfGcz/ai-agent-connect
- **Tags:** heavy-civil-construction, timecard-management, estimating, telematics, project-tracking, field-data

## Description

This Connector connects your heavy construction platform to your AI client so you can manage projects, timecards, and equipment without jumping between different software portals. Instead of hunting for specific data in multiple tabs, you can just ask your agent to pull what you need. This means you can check your fleet's GPS location, review bidding estimates, or see your current job costs in a single conversation. By using this Connector through the Vinkius catalog, you turn your AI into a virtual project engineer that stays on top of your site progress and equipment status. You no longer have to waste time exporting reports or manually logging into various systems just to get a status update. It keeps your focus on the actual work while your agent handles the data retrieval.

## Tools

### get_bid_items
Use get_bid_items to see specific bid items for a particular estimate. This helps you verify quantities and prices during bidding.

### get_equipment_location
Use get_equipment_location to get current GPS coordinates for a piece of equipment. This helps you track machinery in real-time.

### get_equipment_meters
Use get_equipment_meters to get the latest odometer or hour readings for your machines. This helps you plan for maintenance needs.

### list_business_units
Use list_business_units to see all business units in HCSS. This helps you understand the organizational structure of your company.

### list_cost_codes
Use list_cost_codes to see all cost codes defined in your system. This helps you stay consistent with project accounting and budget tracking.

### list_employees
Use list_employees to see all employees synced in HCSS. This makes it easy to check staffing levels across different units.

### list_equipment
Use list_equipment to see every piece of tracked equipment in your telematics. This gives you a clear view of your entire fleet.

### list_estimates
Use list_estimates to pull bidding estimates from HeavyBid. This helps you stay aligned with your current project budgets.

### list_jobs
Use list_jobs to see all construction jobs and projects. This lets you quickly identify which sites are currently active.

### list_precon_projects
Use list_precon_projects to browse active pre-construction projects. This helps you track the lifecycle of upcoming work.

### list_timecards
Use list_timecards to retrieve timecard data from HeavyJob. This allows you to monitor site progress and labor hours instantly.

## Prompt Examples

**Prompt:** 
```
List all active construction jobs.
```

**Response:** 
```
I've retrieved your jobs. You have 5 active projects, including **Highway 101 Expansion** (ID: 5501), **Downtown Bridge Repair** (ID: 5505), and **Industrial Park Phase 2**. Which one would you like to see timecard summaries for?
```

**Prompt:** 
```
Show the current location of Excavator ID EX-992.
```

**Response:** 
```
Accessing telematics... **Excavator EX-992** is currently located at (29.7604, -95.3698), which is near the 'Highway 101' job site. The engine was last reported running 2 hours ago. Should I check the fuel level or meter readings?
```

**Prompt:** 
```
What are the bid items for estimate ID 2024-001?
```

**Response:** 
```
Retrieving HeavyBid data... **Estimate 2024-001** includes 12 bid items, such as:

* Site Clearing
* Foundation Piling
* Asphalt Paving

Would you like to see the assigned quantities and unit prices for these items?
```

## Capabilities

### Pull timecard data from HeavyJob
Retrieve labor hours and site progress reports directly into your chat.

### View real-time GPS for equipment
See exactly where your heavy machinery is located on a job site.

### Check bid items for estimates
Access specific quantities and unit prices for upcoming project bids.

### List active construction jobs
Get a full overview of all current projects and their statuses.

### Track pre-construction project lifecycles
Monitor the progress of projects in the planning and pre-con phase.

### Get odometer and hour readings for machines
Check the latest meter readings to schedule maintenance and track usage.

## Use Cases

### Checking Excavator location
A fleet manager needs to know where a specific machine is. They ask their agent to use get_equipment_location to find the GPS coordinates of Excavator EX-992.

### Reviewing timecard summaries
A project manager wants to see who worked on a site yesterday. They ask the agent to use list_timecards to pull data from HeavyJob for a specific job.

### Verifying bid items
An estimator is in the middle of a high-pressure bid. They use get_bid_items to pull specific quantities and prices for a new project estimate.

### Monitoring fleet hours
A maintenance lead wants to see which machines need service. They ask the agent to use get_equipment_meters to check the latest odometer and hour readings.

### Browsing pre-con projects
A project coordinator needs to see what's coming up next month. They use list_precon_projects to see all active pre-construction projects.

## Benefits

- Stop manual data exports by pulling timecards from HeavyJob directly into your chat interface.
- Monitor fleet health with real-time GPS and meter readings from your telematics without opening extra tabs.
- Stay on budget by quickly checking bid items and estimates from HeavyBid while you're in the field.
- Reduce context switching by viewing jobs and business units without logging into multiple different portals.
- Speed up project planning by browsing pre-construction lifecycles and active projects instantly.
- Identify equipment utilization trends and job cost variances in seconds using natural language queries.

## How It Works

The bottom line is you get a way to query your entire construction operation without leaving your chat interface.

1. Subscribe to the HCSS MCP on Vinkius.
2. Enter your HCSS Client ID, Client Secret, and Subscription Key into your AI client.
3. Ask your agent to pull project costs or check equipment locations.

## Frequently Asked Questions

**Can I use HCSS MCP with Claude?**
Yes, you can connect HCSS to Claude or any other MCP-compatible client. This allows you to query your construction data using natural language.

**Can I see my equipment locations with HCSS MCP?**
Yes, you can ask your agent to pull real-time GPS coordinates for any specific piece of machinery in your fleet.

**How do I connect my HeavyJob timecards?**
Once you subscribe and enter your credentials, your agent can pull timecard data from HeavyJob directly into your conversation.

**Can I see my HeavyBid estimates?**
Yes, this Connector allows you to browse bidding estimates and pull specific bid items for your current projects.

**Is my construction data secure?**
Your data security is managed through your HCSS credentials. The Connector only accesses the data you authorize via your Client ID and Secret.

**Who is HCSS MCP for?**
It's designed for project managers, fleet managers, and estimators who need fast access to field data, telematics, and project costs.

**Can it track my pre-construction projects?**
Yes, you can use the Connector to browse active pre-construction projects and see where they stand in their lifecycle.

**How do I obtain my HCSS API credentials?**
You must request API access through the **HCSS Developer Portal** (developer.hcssapps.com). Once approved, you will receive your Client ID, Client Secret, and Ocp-Apim-Subscription-Key.

**Can I see the real-time location of my equipment?**
Yes! Use the `get_equipment_location` tool with the unique equipment ID. It will return the latest GPS coordinates recorded by the Telematics system.

**Does this integration cover both HeavyJob and HeavyBid?**
Yes, this Connector includes tools for both modules, allowing you to access timecard data from HeavyJob and estimate/bid data from HeavyBid in a single interface.

**Is the integration secure for construction data?**
Absolutely. The integration uses industry-standard OAuth 2.0 Client Credentials flow and HTTPS. Your credentials are encrypted and stored securely within the Vinkius Cloud infrastructure.