# Clearstory MCP MCP

> Clearstory MCP lets you manage construction financials and project data right from your chat client. You can track change order requests (CORs), monitor Time & Material tags, and review current rates for labor and equipment without logging into the main platform. It gives your AI agent full visibility into which projects are running over budget or need contract updates.

## Overview
- **Category:** erp-operations
- **Price:** Free
- **Tags:** change-orders, construction-management, financial-tracking, project-rates, t-and-m-tags

## Description

Connecting Clearstory through Vinkius means you keep all your construction project financial data in natural conversation. You gain direct control over Change Order Requests (CORs) and Time & Material tags, treating them like any other piece of information. Instead of opening multiple dashboards to check status reports or verify rates, your agent pulls the data instantly. This centralized view lets you get a real-time pulse on every project—from listing active projects to pulling specific contract details linked to change orders. It's about getting answers fast and making sure everyone is working off current financial figures, whether that means checking labor rates or reviewing notifications sent between customers and contractors.

## Tools

### get_cor_details
Retrieves detailed information for one specific Change Order Request (COR).

### get_project_construction_details
Gets detailed status and financial data for a single construction project.

### list_change_order_requests
Gets a list of all Change Order Requests (CORs) in your account.

### list_project_contracts
Lists contracts that are directly linked to specific change orders.

### list_change_notifications
Lists all change notifications sent between the client and contractor.

### list_construction_projects
Provides an inventory of every construction project you have on file.

### list_construction_rates
Retrieves the current Labor, Material, Equipment, and Other (LMEO) rates for your projects.

### list_tm_tags
Reads a list of digital Time & Material tags recorded in the field.

## Prompt Examples

**Prompt:** 
```
List all active construction projects in Clearstory.
```

**Response:** 
```
Retrieving your active projects... I found 4 projects: 'City Hospital Expansion', 'Eastside Towers', 'Green Street Plaza', and 'Downtown Refurb'. Which one would you like to see CORs for?
```

**Prompt:** 
```
Show me the last 5 Change Order Requests.
```

**Response:** 
```
Checking recent CORs... I found 5 items ranging from $500 to $12,000. The most recent is COR #105 for 'Additional Electrical Outlets' ($1,250) in status 'Pending'.
```

**Prompt:** 
```
What are the labor rates for the 'City Hospital' project?
```

**Response:** 
```
Retrieving rates for City Hospital... The standard labor rate is $85/hr for Journeymen and $65/hr for Apprentices. These are configured under the project's LMEO settings.
```

## Capabilities

### Identify Projects
List and get detailed status information for any construction project, active or dormant.

### Review Change Orders
Access the full details of specific change order requests to see amounts and current statuses.

### Check Field Tags
Retrieve a list of digital Time & Material tags recorded directly from the job site.

### Audit Contracts
Find contracts that are linked to specific change order requests for quick verification.

### Track Rates
Get current Labor, Material, Equipment, and Other (LMEO) rates used across all projects.

## Use Cases

### Verifying Project Scope Creep
A PM needs to know exactly how many change orders are open on Site B. They ask their agent, and it runs `list_change_order_requests` first, then uses `get_cor_details` on the top three results, giving them a precise scope of work creep before calling the client.

### Budgeting for New Phases
A General Contractor needs to estimate costs for a new wing. They run `list_construction_rates`, confirming the labor rates are $90/hr, then use that data point in a separate calculation prompt.

### Client Dispute Resolution
A client questions billing history. The agent uses `list_change_notifications` to pull the full communication log, allowing the PM to immediately show the client when the initial agreement was made.

### End-of-Month Billing Check
Finance needs to reconcile billing for a recent job. They use `list_tm_tags` to pull all recorded field time and cross-reference it with project rates via `get_project_construction_details`.

## Benefits

- Review all active projects by running `list_construction_projects` to get a quick inventory without navigating deep into the system.
- Stop guessing project costs. By calling `list_construction_rates`, you see current LMEO rates instantly, helping budget checks right where you are working.
- When a change happens on site, use `list_tm_tags` to pull those digital records immediately for review and billing confirmation.
- Audit compliance fast. You can call `list_project_contracts` and then `get_cor_details` together to verify which changes hit covered contracts.
- Track status fluctuations using `list_change_order_requests`. This lets you see if a pending COR is stuck or ready for the next step.

## How It Works

The bottom line is you get project-critical financial figures pulled into your chat window instead of a web dashboard.

1. Subscribe to the Clearstory MCP using your API key.
2. Connect that key to any compatible client (Claude, Cursor, etc.) through Vinkius.
3. Ask your agent a question—like 'What are the current rates for City Hospital?'—and it pulls the data directly.

## Frequently Asked Questions

**How do I use list_construction_projects to see all my sites?**
Simply ask your agent to run `list_construction_projects`. It returns an inventory of every project name and ID you have, letting you start drilling down into any specific job.

**What is the difference between list_change_order_requests and get_cor_details?**
`list_change_order_requests` gives you a summary list of all CORs. You use `get_cor_details` when you need to see every specific piece of information about one single, particular change order.

**Can I check rates using list_construction_rates?**
Yes, running `list_construction_rates` pulls all current LMEO rates for your projects. This is critical for quick budget checks against different job sites.

**Does the MCP help me with T&M tags? (using list_tm_tags)**
Absolutely. The `list_tm_tags` tool reads the digital Time & Material records straight from the field, letting you verify what was billed without opening the site-specific module.

**Which tool should I use to check contract links? (using list_project_contracts)**
Use `list_project_contracts`. This tool specifically pulls and lists contracts that are officially linked to your change orders, helping you audit compliance quickly.

**How do I use list_change_notifications to review communication between customers and contractors?**
It pulls a chronological record of all change notifications. You can track who sent the message, when it was sent, and what specific topic or project it related to.

**When I use get_project_construction_details, what information does it return for a site?**
The tool provides a full data snapshot of a selected construction project. This includes key dates, current status flags, and general operational details necessary for comprehensive oversight.

**Can list_change_order_requests filter results by status or date parameters?**
Yes, you can refine the results using specific filters. You send required criteria—like filtering only 'Pending' CORs or those created within a defined date range.

**Can I see the total amount of outstanding CORs for a project?**
Yes! Use the `list_change_order_requests` tool. The agent will return all CORs, and you can ask it to calculate or filter for the total value of those in 'Pending' or 'Under Review' status.

**How do I check the latest T&M tags from the field through the agent?**
Use the `list_tm_tags` tool. Your agent will fetch the most recent digital Time & Material tags, allowing you to review labor hours and material usage without opening the web app.

**Where do I find my Clearstory API Key?**
Log in to Clearstory, navigate to **Settings > Offices**, select your office, and go to the **Integrations** tab. You can generate and copy your API key from there.