# Fieldly MCP for AI Agents AI Agent Connect

> Fieldly MCP connects your AI agent to your construction management platform. It lets you manage work items, team bookings, invoices, and inventory directly through a chat interface. Stop jumping between tabs and start handling project details where you already work.

## Overview
- **Category:** erp-operations
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_zH4ZH6WGr1cwX2JjF8VZT8Q9dxJsDN4iOrYy6EWT/ai-agent-connect
- **Tags:** work-orders, scheduling, construction-management, time-tracking, invoicing, field-service

## Description

Fieldly is a platform built for the construction industry to keep projects on track. This Connector lets your agent talk directly to your Fieldly account so you can stop digging through menus to find basic information. Instead of opening three different tabs to see your crew schedule, your material inventory, and your current job list, you can just ask your agent for the status of a specific project. It pulls the data you need instantly, whether you're checking if an invoice was paid or seeing which teams are booked for the next shift.

Because this is hosted on Vinkius, you get a reliable way to plug your construction data into your existing AI workflow. You can manage your customer profiles, verify user identities, and create new work items without ever leaving your chat window. It turns your agent into a functional assistant that actually knows your project details, helping you stay focused on the job site rather than the paperwork.

## Tools

### create_work_item
Add a new job or task to your construction queue. Use this to quickly log new work orders from the field.

### get_booking
Pull the specific details for a single team booking. Use this to see the exact schedule for a specific crew.

### get_invoice
Look up the details for a specific billing record. This lets you see the line items and status of a single invoice.

### get_me
Verify the identity of the current authorized user or app. This ensures your agent is connected to the right account.

### list_articles
See all your inventory items and service materials. This helps you check what supplies you have on hand.

### list_bookings
View all scheduled team bookings across your projects. Use this to see who is working where and when.

### list_invoices
See all billing records and invoices in the system. Use this to track payments and outstanding balances.

### list_users
See all the users registered in your Fieldly account. This helps you manage who has access to your data.

### list_work_items
View a complete list of all construction tasks and jobs. Use this to get a bird's-eye view of your current projects.

### get_work_item
Get the specific details for a construction task or job. Use this to see what needs to be done on a specific site.

### list_customers
Pull a full list of your customers and their contact info. This keeps your CRM data accessible in your chat.

## Prompt Examples

**Prompt:** 
```
Show me all active jobs.
```

**Response:** 
```
I've pulled your active construction jobs. Here is the current list:

| Job Name | Status | Priority |
| :--- | :--- | :--- |
| **Roof Repair - Site A** | In Progress | High |
| **Foundation Pumping** | Scheduled | Medium |
| **Downtown Plaza** | Completed | Low |

Would you like the full details for any of these?
```

**Prompt:** 
```
Who's working tomorrow?
```

**Response:** 
```
Checking your team bookings for tomorrow... 

Here is the schedule:
* **Electricians**: 8:00 AM - 4:00 PM (Site ID: 442)
* **Carpenters**: 10:00 AM - 3:00 PM (Site ID: 109)
* **Plumbers**: 1:00 PM - 6:00 PM (Site ID: 221)

Do you need the specific site addresses for any of these crews?
```

**Prompt:** 
```
Are there any unpaid bills?
```

**Response:** 
```
I've checked your invoices and found 2 unpaid records:

* **INV-202**: $5,400 (Associated with 'Downtown Plaza')
* **INV-205**: $3,200 (Associated with 'Downtown Plaza')

Would you like me to pull the customer contact info for these invoices?
```

## Capabilities

### Create new work items
Add new jobs or tasks to your construction queue instantly through chat.

### Check team schedules
View all scheduled team bookings to see who is working where and when.

### Pull billing records
Access all invoices and billing data to track project financials.

### Manage material inventory
List all inventory and service articles to keep track of supplies.

### Look up customer profiles
Retrieve customer contact details and profiles from your CRM.

### Verify user permissions
Check the identity of the authorized user or application for security.

## Use Cases

### Checking Job Status
A manager asks for the status of the 'Roof Repair' project. The agent uses get_work_item to pull the specific details and current progress.

### Scheduling Teams
An operations coordinator asks who is booked for tomorrow. The agent uses list_bookings to show the full crew schedule.

### Billing Audit
A bookkeeper asks for unpaid construction invoices. The agent uses list_invoices to find all outstanding balances.

### Material Check
A site supervisor asks if they have enough lumber on site. The agent uses list_articles to check the current inventory.

## Benefits

- Stop switching tabs by using list_work_items to see every active project and job in one place.
- Keep projects on schedule by pulling team availability and crew schedules with list_bookings.
- Track your cash flow more accurately by checking unpaid bills and project financials with list_invoices.
- Manage your supply chain better by pulling material lists and inventory articles with list_articles.
- Speed up customer service by pulling contact info instantly with list_customers to keep your CRM data handy.

## How It Works

The bottom line is you get a direct line from your chat interface to your construction project data.

1. Subscribe to the Fieldly MCP on the Vinkius marketplace.
2. Request Public API access from the Fieldly support team.
3. Enter your Client ID and Client Secret in your AI client settings.

## Frequently Asked Questions

**How does Fieldly MCP help with construction management?**
It connects your construction projects directly to your AI agent. You can ask for job updates, check crew schedules, and manage materials without needing to log into a separate dashboard.

**Can I use Fieldly MCP to see my team's schedule?**
Yes. You can ask your agent to list all upcoming bookings, which will show you which teams are scheduled, at what times, and for which projects.

**Can I check my invoices using the Fieldly MCP?**
Absolutely. You can ask your agent to list all invoices or look up specific billing details to track your project financials and unpaid balances.

**Does Fieldly MCP work with my existing customer list?**
Yes, it can pull your customer profiles and contact details directly from your Fieldly account so you can access CRM data during your chat.

**How do I get my Fieldly account connected to my AI agent?**
You just need to subscribe to the Connector on Vinkius, request API access from Fieldly support, and then enter your credentials into your AI client settings.

**Can I add new work orders to Fieldly through my AI agent?**
Yes, you can tell your agent to create a new work item. It will then add the new job or task to your construction queue automatically.

**How do I obtain my Fieldly API credentials?**
First, contact support@fieldly.com to enable the Public API. Once activated, you can find your Client ID and Client Secret in the **Integration Settings** of your Fieldly Admin panel.

**How long is the access token valid?**
Fieldly access tokens are valid for one hour. The agent handles token renewal automatically so you don't have to worry about manual updates.

**Can I create new construction tasks via chat?**
Yes! The `create_work_item` tool allows you to programmatically generate new construction tasks and work items directly within your AI-powered workflow flawlessy.