# Mosaic MCP for AI Agents AI Agent Connect

> Mosaic lets you manage workforce planning and project profitability through your AI client. Track team capacity, audit budget estimates, and organize work plans without jumping between tabs. It connects your Mosaicapp data directly to your agent for real-time resource orchestration.

## Overview
- **Category:** human-resources
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_xgNhyEpLHOXxN54POhQo4BVj1lGQEh0gLdl1Ru1Y/ai-agent-connect
- **Tags:** resource-planning, workforce-management, capacity-planning, project-profitability, team-utilization, budget-tracking

## Description

Managing a large workforce usually means drowning in spreadsheets or clicking through endless rows of data to see who's actually available. You have to check one place for team member roles, another for project budgets, and a third to see who's over-allocated on a specific timeline. It's a headache that leads to burnout and missed margins. This Connector changes that by bringing all that data into a single conversation. Instead of hunting for information, you just ask your agent about your team's current status. You can pull up work plans to spot lopsided workloads or audit bill rates to make sure projects stay profitable. It turns your resource planning from a manual chore into a quick check. Because Vinkius hosts this connection, you can jump from high-level portfolio audits to specific member check-ins in seconds. You get a clear view of your organizational throughput without the friction of manual navigation.

## Tools

### list_cost_rates
See the internal cost rates and unit limits used for resource tracking.

### list_members
Get a full list of every team member currently mapped in your Mosaic instance.

### get_member
Pull specific details for a single team member, like their role and current assignments.

### list_work_plans
See all scheduled work plans that map your resources to specific projects.

### list_calendar_events
View all tracked calendar events to see how time is being spent across the team.

### list_check_ins
Pull the physical log check-ins for team members to see real-time attendance.

### list_budgets
See the simulated or structured budget estimates for your active projects.

### list_projects
Get a high-level list of all projects and initiatives your organization is tracking.

### list_bill_rates
View the organizational configuration for external bill rates across all projects.

### list_rate_groups
Look up the defined arrays that map generalized rate groups for your team.

### list_roles
See the categorical domains used to classify different project roles.

### list_currencies
Get a list of the team-specific currencies used for financial logs and timekeeping.

## Prompt Examples

**Prompt:** 
```
Who on the design team has the most availability over the next two weeks?
```

**Response:** 
```
I've checked the current work plans for the design team. Here's the breakdown of availability:

- **Sarah Johnson**: 40% available (Currently on 'Mobile App' project)
- **Mark Rivera**: 80% available (Currently benched)
- **Alex Smith**: 0% available (Fully allocated to 'Web Redesign')

Would you like me to see the specific tasks Mark is currently assigned to?
```

**Prompt:** 
```
Give me a summary of the budget for project ID 'proj-98765'.
```

**Response:** 
```
Here are the budget details for project **proj-98765**:

| Category | Amount |
| --- | --- |
| Billable Hours | $85,000 |
| Operational Overhead | $40,000 |
| **Total Estimate** | **$125,000** |

The project is currently tracking within its expected margins based on the current resource mappings.
```

**Prompt:** 
```
List the current bill rates for our senior engineering roles.
```

**Response:** 
```
I've retrieved the bill rates for the senior engineering roles:

- **Senior Architect**: $250/hr
- **Lead Developer**: $225/hr
- **Engineering Manager**: $200/hr

These rates are mapped across all active initiatives in your Mosaic instance.
```

## Capabilities

### Pull team member profiles
Get roles and availability for anyone on the team instantly.

### Spot over-allocated staff
Identify which team members are stretched too thin on current projects.

### Audit project budgets
Check bill rates and cost rates to maintain healthy project margins.

### Track real-time check-ins
See physical logs and temporal events to understand daily throughput.

### Map high-level projects
View the scope and resource attachments for your entire portfolio.

### Identify rate groups
Understand how different contributors are classified and billed.

## Use Cases

### Finding available designers
A project manager notices a delay and needs to know who can help. They ask the agent to use list_members to find designers with open capacity.

### Checking project profitability
An ops director needs to see if a project is losing money. They ask the agent to audit the project's budget estimates using list_budgets.

### Verifying real-time attendance
A resource lead wants to see who is currently in the office. They ask the agent to pull the latest physical logs using list_check_ins.

### Auditing client billing structures
A manager needs to see the billing structure for a new client. They ask the agent to pull the relevant bill rates and rate groups using list_bill_rates.

## Benefits

- Stop manually hunting for team details because get_member pulls roles and assignments into a single view.
- Prevent team burnout by using list_work_plans to identify exactly who is over-allocated on a project.
- Protect your margins by quickly auditing bill rates and cost rates with list_bill_rates and list_cost_rates.
- Get a clear picture of daily throughput by pulling real-time data from list_check_ins and list_calendar_events.
- Manage your entire portfolio at once by using list_projects to see high-level scope mappings.
- Standardize your financial reporting by pulling global currencies and measurement units with list_currencies.

## How It Works

The bottom line is you get a conversational interface for your entire workforce and project budget data.

1. Subscribe to the Mosaic MCP via the Vinkius catalog.
2. Provide your Mosaic API Token and X-Origin ID.
3. Ask your agent to list work plans or audit budgets.

## Frequently Asked Questions

**What can I do with the Mosaic MCP for AI agents?**
You can use your AI agent to query your entire workforce management system. This means you can ask about team capacity, check project budgets, and view work plans through a simple chat interface.

**Can the Mosaic MCP help me manage team burnout?**
Yes, it helps by letting you quickly identify team members who are over-allocated on specific projects, allowing you to rebalance workloads before people get overwhelmed.

**How does the Mosaic MCP handle project budgets?**
It allows your agent to pull and audit bill rates, cost rates, and budget estimates for any project, giving you a real-time look at your financial margins.

**Can I use the Mosaic MCP to see who's working on what?**
Absolutely. You can ask your agent to list current work plans or pull specific member profiles to see exactly which projects your team is assigned to.

**Does the Mosaic MCP support multiple currencies?**
Yes, it can pull the specific currencies and measurement units used by your team to ensure your financial logs and timekeeping data are accurate.

**How does the Mosaic MCP improve resource planning?**
It moves resource planning from a manual spreadsheet task to a conversational one. You can get instant answers on availability, capacity, and project scope without navigating complex grids.

**Can I see my team's workload across different projects through my agent?**
Yes. Use the `list_work_plans` tool. Your agent will retrieve the hierarchical timeline mapping resources to projects, allowing you to see exactly how many hours are allocated to each member across your entire portfolio.

**How do I check if a specific project is still within its estimated budget?**
The `list_budgets` tool allows your agent to retrieve financial estimates for a given Project ID. You'll see the structured budget models and applied rates, helping you monitor financial health through natural conversation.

**Can my agent list all the roles and bill rates configured in our Mosaic account?**
Absolutely. Use the `list_roles` and `list_bill_rates` tools to identify your organizational allocation vectors. Your agent will report the roles and associated financial constants used to calculate project margins.