HCSS MCP. Manage job costs, timecards, and equipment status.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
HCSS MCP Server lets your AI agent manage heavy construction jobs, timecards, estimates, and equipment data. Connect it to read real-time fleet locations, check job costs, and list employees directly from HCSS.
Stop switching between portals; get all site data from one chat window.
What your AI agents can do
Get bid items
Retrieves a list of bid items needed for a specific estimate ID.
Get equipment location
Gets the current GPS coordinates for a piece of equipment.
Get equipment meters
Retrieves the latest meter readings (odometer or engine hours) for equipment.
List active jobs and pull timecard data to monitor field progress and labor hours.
Access bidding estimates and detailed bid items to verify project costs against budgets.
Get real-time GPS coordinates and the latest meter readings for every piece of tracked equipment.
List all employees and business units defined in the HCSS system for resource planning.
Browse and track active pre-con projects and their lifecycle status.
Ask AI about this MCP
Supported MCP Clients
Gemini Waiting for input…
HCSS MCP Server: 11 Tools for Construction Operations
These tools link job data, timecards, equipment locations, and bid items, giving your AI agent a complete view of your heavy construction operations.
019d75aeget bid items
Retrieves a list of bid items needed for a specific estimate ID.
019d75aeget equipment location
Gets the current GPS coordinates for a piece of equipment.
019d75aeget equipment meters
Retrieves the latest meter readings (odometer or engine hours) for equipment.
019d75aelist business units
Lists all business units defined within the HCSS system.
019d75aelist cost codes
Lists all cost codes defined in the HCSS system.
019d75aelist employees
Lists all employees synced in the HCSS system.
019d75aelist equipment
Lists all tracked equipment/fleet available in the Telematics data.
019d75aelist estimates
Lists all bidding estimates recorded in HeavyBid.
019d75aelist jobs
Lists all construction jobs and projects managed in HCSS.
019d75aelist precon projects
Lists all active pre-construction projects.
019d75aelist timecards
Lists timecard records from HeavyJob.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with HCSS, then connect any of our 4,700+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,700+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
What you can do with this MCP connector
Your AI agent handles your entire construction workflow, from initial job estimates to current field data and equipment tracking. You'll use this server to read real-time fleet locations, check job costs, and list employees directly from HCSS. You won't have to switch between portals; you'll get all site data from one chat window.
Tracking Job Progress and Labor Costs
- You can use
list_jobsto get a list of all construction jobs and projects in HCSS. You'll pull timecard data usinglist_timecardsto monitor field progress and labor hours.
Calculating Project Bid Costs
- You can get a list of all bidding estimates recorded in HeavyBid using
list_estimates. You'll retrieve specific bid items needed for an estimate ID withget_bid_itemsto verify project costs against budgets.
Monitoring Equipment Status and Location
- You can get the current GPS coordinates for any piece of equipment with
get_equipment_location. You'll also pull the latest meter readings (odometer or engine hours) for equipment usingget_equipment_meters. You can list all tracked equipment/fleet available in the Telematics data withlist_equipmentand list all equipment available withlist_equipment.
Identifying Project Resources
- You can list all employees synced in the HCSS system with
list_employees. You can list all business units defined within the HCSS system withlist_business_units.
How HCSS MCP Works
- 1 Subscribe to the HCSS server and provide your required HCSS Client ID, Client Secret, and API Key.
- 2 Your AI client connects to the server, sending a natural language request (e.g., 'What are the job costs for Project X?').
- 3 The server executes the necessary HCSS tool calls, pulls the data, and feeds the structured results back to your AI client for a human-readable answer.
The bottom line is, your AI agent handles the connection, the data retrieval, and the presentation, so you don't have to switch between systems.
Who Is HCSS MCP For?
The Project Manager who needs job cost status and timecard data immediately. The Fleet Manager who can't afford to wait for field reports. The Estimator who needs to cross-check bid items against project budgets before a deadline.
Retrieves job costs and timecard status for specific projects directly from the field data.
Checks equipment locations and maintenance needs across the entire fleet without opening the telematics portal.
Verifies specific bid item details and tracks estimate progress during intense bidding cycles.
What Changes When You Connect
- Track job progress and labor costs instantly. Instead of manually pulling timecards from HeavyJob, your agent runs
list_timecardsand delivers job cost summaries in seconds. You know who worked where and when. - Keep bidding estimates accurate. You can use
list_estimatesandget_bid_itemsto pull all necessary line items and quantities, letting you verify budgets without opening HeavyBid. - Know where the equipment is. Forget waiting for reports. Use
get_equipment_locationto check a machine's real-time GPS coordinates and know if it's near the job site. - Resource planning is faster. Need to know who's on site or what business units exist? Run
list_employeesorlist_business_unitsto get a clean list of available resources. - Cut through the noise on equipment. Instead of reading long telematics screens,
get_equipment_metersgives you the exact odometer or hour count you need to calculate maintenance costs.
Real-World Use Cases
Need to reconcile job costs with labor hours.
A Project Manager needs to see the current cost variance for the 'Highway 101 Expansion' job. They ask the agent to list the jobs, then specify the ID. The agent runs list_jobs and list_timecards to pull the data, giving the PM an immediate, cross-referenced cost summary.
Checking a machine's status before deployment.
The Site Supervisor needs to know if the excavator is available and where it is. They ask the agent to find the machine by ID. The agent uses list_equipment and then calls get_equipment_location and get_equipment_meters to give a full operational picture: location, status, and running hours.
Validating a new bid's cost components.
An Estimator is reviewing a proposal. They ask the agent for the bid items for a specific estimate ID. The agent uses list_estimates and get_bid_items to pull the full breakdown, allowing the estimator to compare the proposed costs against internal cost codes (list_cost_codes).
Tracking pre-construction resource needs.
A Project Director needs to know what resources are needed for the next phase. They ask the agent to list active pre-con projects. The agent uses list_precon_projects and then cross-references available employees (list_employees) to create a preliminary resource allocation plan.
The Tradeoffs
Manual data aggregation
Opening the heavy job portal, downloading the timecard CSV. Logging into the telematics system, finding the GPS coordinates. Opening the bid sheet, searching for the item cost. Then, manually compiling a single report in Excel.
→
Ask your AI agent to run list_jobs first, then specify the job ID. Ask the agent to pull the timecards using list_timecards, and separately, run get_equipment_location for the required equipment. This gets all the data in one chat.
Ignoring data dependencies
Trying to find the cost of equipment without knowing the job ID or the required cost code. The resulting data dump is incomplete or unusable.
→
Always start by listing the project using list_jobs to get the core job ID. Then, use that ID to restrict your search when calling list_timecards or when checking against list_cost_codes.
Over-reliance on single tools
Just running list_equipment and getting a massive list of machine IDs, but having no idea if they are currently running or where they are located.
→
After running list_equipment, immediately follow up by asking the agent to run get_equipment_location and get_equipment_meters for the IDs you care about. This turns a list into actionable data.
When It Fits, When It Doesn't
Use this server if you need to combine data from several different operational systems (e.g., timecards, equipment location, cost codes) into a single conversation. It's perfect for the Project Manager who needs a 360-degree view of a job. Don't use this if you only need to list all employees—just use the list_employees tool directly. Also, don't use it if your primary need is just a list of active projects; list_jobs handles that simply. This tool excels when you need to cross-reference data: linking a specific job ID to the labor recorded in list_timecards and the equipment tracked by get_equipment_location.
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.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 11 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Available Capabilities
Stop jumping between portals to track job costs.
Today, tracking job costs means jumping through hoops. You open the timecard portal to see labor hours. Then you log into the telematics dashboard to check machine usage hours. You open the bidding system to find the cost item price. You copy-paste everything into an Excel sheet, hoping nothing breaks.
With the HCSS MCP Server, you just ask the agent. You say, 'What's the cost variance for Job 5501?' The agent handles the links—it pulls the timecards (`list_timecards`), it checks the equipment hours (`get_equipment_meters`), and it cross-references the cost codes (`list_cost_codes`). You get the final number, nothing else.
HCSS MCP Server: Job & Timecard Management
You don't have to manually export field reports or log into separate portals to get a full picture of a job. This eliminates the time spent waiting for data dumps and the risk of outdated information.
The whole process moves to a chat. Your AI agent becomes the dedicated Project Engineer, pulling real-time data and synthesizing it for you. It's all one conversation.
Common Questions About HCSS MCP
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 MCP server 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.
How do I use the `list_timecards` tool to check job progress? +
You list timecards by specifying the job ID or date range. This lets you track actual labor hours against planned project timelines.
Can I use `get_bid_items` to check costs for a different estimate? +
Yes, you just provide the new Estimate ID. This lets you pull bid item details from any HeavyBid estimate without manually exporting data.
What kind of equipment data can I get using `list_equipment`? +
It lists all tracked assets from Telematics. For each piece of equipment, you get its ID, model, and status, so you know what's on site.
Does the `get_equipment_meters` tool work for all types of machinery? +
This tool retrieves the latest meter readings (odometer or engine hours) for any piece of equipment you specify. It uses the equipment ID for accurate data retrieval.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
SAP S/4HANA
Manage purchase orders, business partners, inventory, and financial postings on SAP S/4HANA — the intelligent ERP.
Mindbody
Manage classes, appointments, clients, staff, and sales from your Mindbody-powered fitness studio, spa, or wellness business through natural conversation.
Omie ERP
Manage your Omie ERP data via API — list clients, products, sales orders, financial accounts, and inventory directly from any AI agent.
You might also like
99Minutos Express
Call physical couriers via AI using 99Minutos. Extract immediate Last-mile shipping quotes and trace vehicle checkpoints dynamically.
Smartsheet
Manage sheets, reports, and rows on Smartsheet with AI agents.
Bexio
Manage your business via Bexio — list contacts, invoices, and projects directly from any AI agent.