# Fieldwire MCP

> Fieldwire MCP lets you manage entire construction projects from one chat window. Instead of jumping between mobile apps and desktop dashboards to check status updates or organize floorplans, your AI client acts as a digital project coordinator. You can list all active sites, assign tasks, update progress in batches, and access site communications (task bubbles) instantly.

## Overview
- **Category:** construction
- **Price:** Free
- **Tags:** construction-management, task-tracking, floorplans, field-collaboration, site-management

## Description

This MCP connects directly to Fieldwire, letting you handle complex construction management tasks using just natural conversation. Think of it like having a dedicated site foreman always available on your AI client. You can ask your agent to get details for specific projects or list all active sites across your account. Need to manage personnel? Your agent handles inviting new users and listing who is assigned to which job. If you're working with large volumes of plans, you can use the tool that lets you batch move floorplans to collections for better site organization. Everything stays within one chat interface, no switching apps required. Vinkius makes it simple: connect your account once from any compatible client and get immediate access to this Fieldwire functionality.

## Tools

### add_aws_post_tokens
Generates the necessary AWS POST tokens required for uploading files to S3 storage.

### batch_move_floorplans
Moves multiple floorplans into a specific collection within a project.

### batch_update_statuses
Creates, updates, or deletes task statuses for groups of tasks at once.

### create_project
Starts a new Fieldwire project within your account.

### create_sheet_upload
Creates the required sheet upload entry after files are uploaded to S3.

### create_task
Adds a brand new task directly into an existing Fieldwire project.

### enable_collections
Activates the ability to organize floorplans into collections for better site structure.

### get_form_full
Polls and retrieves complete JSON data payloads for a form submission, useful when a job triggers an initial partial response.

### get_project
Retrieves comprehensive details for one specific Fieldwire project.

### invite_user
Sends invitations to new users to join your Fieldwire account.

### list_floorplans
Retrieves a list of all floorplans associated with an active project.

### list_project_users
Lists every user currently assigned to and working on a specific field project.

### list_projects
Gives you an overview of all projects registered in your Fieldwire account.

### list_statuses
Fetches the custom task statuses currently defined for a project.

### list_task_bubbles
Pulls all related comments, photos, and media attachments tied to any specific task issue.

### list_tasks
Provides a list of every task currently tracked within the project boundaries.

### update_task
Modifies the details or status of an already existing Fieldwire task.

## Prompt Examples

**Prompt:** 
```
List all projects in my Fieldwire account.
```

**Response:** 
```
I've found 3 active projects: 'Downtown Plaza' (UUID: ...), 'Westside Bridge' (UUID: ...), and 'City Hospital' (UUID: ...). Which one would you like to explore?
```

**Prompt:** 
```
Create a new task 'Fix leak in Room 302' in project [UUID].
```

**Response:** 
```
Task 'Fix leak in Room 302' has been successfully created in the project. The Task UUID is 8829-abc. Would you like to assign it to a user?
```

**Prompt:** 
```
Show me the comments and photos for task [UUID] in project [UUID].
```

**Response:** 
```
I've retrieved the task bubbles. There are 2 comments: 'Leak identified' and 'Parts ordered', along with one photo attachment showing the pipe damage.
```

## Capabilities

### Get project overviews
List all projects in your account or fetch specific metadata for a single construction site.

### Manage tasks and progress
Create new tasks, list existing ones, update their status, and even batch change statuses across multiple items.

### Organize floorplans
List all project floorplans and move groups of them into specific collections for better site organization.

### Coordinate team members
Invite new users to your account or list every person assigned to a specific job site.

### Review site communications
Access task bubbles, which pull in all comments, photos, and media attached to a specific work issue.

## Use Cases

### A general contractor needs a site status report for five different jobs.
Instead of manually logging into Fieldwire and running reports for each job, the agent can list projects across your account. This provides a high-level overview, allowing you to immediately see which sites require attention before calling out workers.

### A foreman needs to find all communications regarding an old leak.
The foreman asks the agent to check task bubbles for that specific issue. The AI gathers every comment and photo attachment linked to it, providing a complete history without him having to search through decades of emails or physical notebooks.

### A project manager needs to assign new users after a scope change.
The PM simply asks the agent to invite the necessary personnel. The tool handles sending invitations and can list all existing project users, ensuring proper resource allocation before work begins.

### An architect must organize hundreds of floorplans from multiple phases.
Instead of manually moving each file into its correct folder structure, the agent uses batch_move_floorplans. You specify which plans need organizing, and it moves them all to a designated collection instantly.

## Benefits

- Stop context switching. Instead of opening the desktop portal to list all projects or check metadata, just ask your agent. You get instant project overviews without leaving your workflow.
- Handle team coordination directly. Use the tool that lists project users and invites new personnel in one conversation. No need to log into three different admin dashboards.
- Save time with bulk actions. If you have twenty tasks needing a status change, use batch_update_statuses instead of clicking through every single entry individually.
- Never miss a detail again. When reviewing site issues, the agent accesses task bubbles, gathering all comments and media attachments automatically for review.
- Maintain perfect digital filing. Use batch_move_floorplans to organize large sets of plans into collections in minutes, making sure your project structure is always clean.

## How It Works

The bottom line is: you manage jobsite operations without ever leaving your AI client interface.

1. First, subscribe to this MCP and enter your Fieldwire API Token.
2. Next, start talking to your AI client in the chat. Ask it for something specific, like listing all projects or creating a task.
3. The agent pulls the necessary data from Fieldwire and presents you with actionable results right in the conversation.

## Frequently Asked Questions

**How do I list all projects in my Fieldwire account using Fieldwire MCP?**
You simply ask your agent to list_projects. It pulls a comprehensive overview of every project registered with Fieldwire, giving you the names and UUIDs right away.

**Can I update task statuses in bulk with Fieldwire MCP?**
Yes, use batch_update_statuses. You don't have to open thirty different tasks; just tell your agent which status you want, and it updates all of them at once.

**What is the best way to organize my floorplans with Fieldwire MCP?**
The most efficient method is using batch_move_floorplans. Instead of moving plans individually, you group them and tell your agent where they need to go.

**Does Fieldwire MCP show photos related to tasks?**
Yes, the list_task_bubbles tool retrieves all media attached to a task. This means any comments or site issues will include associated photos and documents.

**I need to add a new user to my team. How do I do that with Fieldwire MCP?**
Just tell your agent you want to invite someone, and it uses the invite_user tool to send out the necessary invitations directly through the connection.