# Float MCP

> Float connects your team's resource data to any AI agent. Manage scheduling, track time off, and allocate project hours by simply talking to your client. This MCP acts as a centralized source of truth for who’s working on what, letting you instantly check capacity and update timelines without jumping between systems.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** resource-planning, capacity-management, team-scheduling, time-tracking, project-allocation, workload-management

## Description

Float lets you handle resource planning—the whole mess of figuring out who has time and who's swamped—using natural conversation. You connect your Float account through Vinkius, giving your agent access to all your team data. Instead of manually cross-referencing project boards with calendars, you ask your AI client directly: 'Is Jane available next week for the Website Redesign?' It checks availability and reports back instantly. You can manage everything from listing departments and clients to creating specific task allocations or retrieving actual logged hours worked. This means you never have to guess if a developer has bandwidth before committing them to a new project, keeping your whole operation running smoothly.

## Tools

### create_allocation
Schedules specific hours for a task to a team member.

### get_logged_time
Retrieves the actual number of hours worked by an employee.

### get_person
Fetches detailed profile information for a specific team member.

### get_project
Retrieves full details about a single client project.

### list_user_accounts
Provides a list of all user accounts within the organization.

### list_allocations
Lists existing scheduled tasks and allocations across the team.

### list_clients
Pulls a comprehensive list of all active clients.

### list_departments
Retrieves a categorized list of departments within the company structure.

### list_people
Lists every team member, including their general profile details.

### list_project_task_names
Retrieves a list of common task labels used in projects (e.g., Design or Development).

### list_projects
Generates a complete list of all ongoing client projects.

### list_time_offs
Checks and lists scheduled time off, including vacations or personal days.

## Prompt Examples

**Prompt:** 
```
List all active projects in Float and the team members assigned to them.
```

**Response:** 
```
Fetching projects... I found 5 active projects, including 'Website Redesign' (3 members) and 'Mobile App Launch' (5 members). Would you like to see the specific allocations for any of these?
```

**Prompt:** 
```
Schedule John Doe for 4 hours a day on the 'Q3 Marketing' project from Monday to Friday.
```

**Response:** 
```
Allocation created! John Doe has been scheduled for 4 hours per day on the 'Q3 Marketing' project for the requested dates. His availability has been updated in Float.
```

**Prompt:** 
```
Who is scheduled for time off this month?
```

**Response:** 
```
Checking time off... This month, Sarah is on vacation from the 10th to the 15th, and Mike has a personal day on the 22nd. Would you like me to check capacity for the rest of the team?
```

## Capabilities

### Check team availability
Fetch detailed profiles and real-time status for every team member.

### View current projects and assignments
See a list of active client projects, including which department owns them and who is assigned to work on them.

### Schedule specific work tasks
Assign exact hours and dates for team members across multiple projects with one command.

### Manage time away records
Check schedules of planned vacations, sick days, or public holidays to plan capacity accurately.

### Analyze logged working hours
Compare the actual hours recorded against the scheduled project time to track progress and efficiency.

### Map organizational structure
List all clients, departments, or user accounts within your agency's framework.

## Use Cases

### A developer needs to be assigned immediately, but you aren't sure who is free.
Instead of checking every team member’s calendar manually, ask your agent to list all people and filter by current capacity. This lets you instantly identify the right fit for the task allocation.

### The client asks for a report on last month's total billable hours.
Instead of exporting and summing time sheets, ask your agent to get logged time across all relevant projects. It compiles the actual hours worked instantly, ready for reporting.

### You need to update a project timeline because a key team member is taking leave.
First, use list time offs to confirm Sarah's vacation dates. Then, ask your agent to adjust the project details and reallocate tasks around her absence.

### You’re onboarding a new account and need to see all possible departments.
Simply tell your agent to list departments or clients. It pulls the full organizational structure, giving you immediate context for resource planning.

## Benefits

- Saves you from manual data compilation. You can ask your agent to 'List all active projects and who is assigned,' instantly getting a full overview without opening multiple tabs or running complex reports.
- Guarantees accurate scheduling. Use the `create_allocation` tool to schedule hours for specific tasks, updating team availability in real-time so you never overcommit someone.
- Keeps you informed on capacity limits. By using `list_time_offs`, your agent automatically filters out time away, ensuring any allocation plan respects scheduled vacations and holidays.
- Provides deep historical context. Running a query with `get_logged_time` lets you compare what was planned versus what was actually worked, giving clear data on project efficiency.
- Knows your company structure. You can list departments or clients using dedicated tools so the agent always has full context about your agency's setup.

## How It Works

The bottom line is you give your AI client the keys to Float, letting it read and write resource data on your behalf.

1. Subscribe to this MCP through the Vinkius Marketplace and provide your Float Personal Access Token.
2. Connect your preferred AI client (like Cursor or Claude) and authorize access using that token.
3. Ask your agent a natural language question, such as 'What is Jane's capacity next week?' and it executes the necessary calls.

## Frequently Asked Questions

**How do I use Float to check if people are available?**
You ask the agent to check team availability for a specific date range or group of users. This uses data from `list_people` and checks against scheduled time off.

**Can Float automatically assign tasks to John Doe?**
Yes, you can schedule specific work tasks by using the `create_allocation` tool. You just need to tell it the hours, dates, and project name.

**What information does Float keep about projects?**
It tracks detailed records via `list_projects`, including which departments own the projects and what types of tasks (like Design or Development) are involved.

**Does this MCP help with time tracking?**
Absolutely. You can use `get_logged_time` to pull actual hours worked against scheduled project times, which is key for billing and efficiency reporting.

**What if I need to see all the clients in my account?**
Use the `list_clients` tool. It gives you a full list of every client, helping you maintain context when planning resource assignments.