# Float — how to use (mcp.ai)

Connect your Float account and use 10 tools for project management straight from your AI agent. Connect with your own API key. Float is a resource management and project planning platform for scheduling teams, managing project capacity, tracking time, and reporting on utilization.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_float?ms=1787291460000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `float_create_allocation`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/float`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/float/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/float/create/allocation` — Schedule work on a Float project for one or more people, or leave it unassigned, with optional phase, status, notes, and recurrence. Supplying a project-task name may create that project-task definiti
  - body: { notes?: string, status?: string, end_date: string, phase_id?: integer, people_ids?: integer[], project_id: integer, recurrence?: string, start_date: string, start_time?: string, hours_per_day: number, project_task_id?: integer, repeat_end_date?: string, project_task_name?: string }
- `POST https://api.mcp.ai/api/float/create/project` — Create a Float project with core scheduling and classification fields. This tool intentionally excludes rates, currencies, budgets, and project-team replacement operations.
  - body: { name: string, tags?: string[], color?: string, notes?: string, status?: string, billable?: boolean, end_date?: string, client_id?: integer, start_date?: string, project_code?: string }
- `POST https://api.mcp.ai/api/float/get/people/capacity/report` — Return person-level capacity, scheduled, unscheduled, time-off, billable, and non-billable totals for a required date range.
  - body: { end_date: string, people_id?: integer, start_date: string }
- `POST https://api.mcp.ai/api/float/get/project` — Retrieve one Float project by ID, optionally including its phases, project tasks, team, expenses, or currency details.
  - body: { include?: string[], project_id: integer }
- `POST https://api.mcp.ai/api/float/get/project/utilization/report` — Return project-level scheduled, logged, billable, non-billable, budget, and utilization totals for a required date range, optionally for one project.
  - body: { end_date: string, project_id?: integer, start_date: string }
- `POST https://api.mcp.ai/api/float/list/allocations` — Find scheduled allocations in Float by project, person, client, phase, project task, date range, billing state, status, or recurrence.
  - body: { sort?: string, status?: string, billable?: boolean, end_date?: string, per_page?: integer, phase_id?: integer, client_id?: integer, people_id?: integer, project_id?: integer, recurrence?: string, start_date?: string, next_cursor?: string, modified_since?: string, project_task_id?: integer, include_task_days?: boolean }
- `POST https://api.mcp.ai/api/float/list/people` — Find active people on the Float schedule by default, or filter for archived or all people, employee type, department, tags, and related account details.
  - body: { sort?: string, tags?: string[], email?: string, active?: boolean, include?: string[], per_page?: integer, employment?: string, next_cursor?: string, people_types?: string[], department_id?: integer, modified_since?: string }
- `POST https://api.mcp.ai/api/float/list/projects` — Find Float projects by code, client, lifecycle state, billing state, status, or tags, optionally including planning details such as phases, tasks, team, and currency.
  - body: { sort?: string, tags?: string[], active?: boolean, status?: string, include?: string[], billable?: boolean, per_page?: integer, client_id?: integer, next_cursor?: string, project_code?: string, modified_since?: string }
- `POST https://api.mcp.ai/api/float/update/allocation` — Reschedule or revise selected fields of a Float allocation. Sends only fields explicitly supplied by the caller and preserves Float task IDs in the result. Supplying a project-task name may create tha
  - body: { notes?: string, status?: string, end_date?: string, phase_id?: integer, people_ids?: integer[], recurrence?: string, start_date?: string, start_time?: string, allocation_id: integer, hours_per_day?: number, project_task_id?: integer, repeat_end_date?: string, project_task_name?: string }
- `POST https://api.mcp.ai/api/float/update/project` — Update selected core identity, schedule, lifecycle, and tag fields on a Float project. This tool does not expose financial configuration or project-team replacement and removal operations.
  - body: { name?: string, tags?: string[], color?: string, notes?: string, active?: boolean, status?: string, billable?: boolean, end_date?: string, client_id?: integer, project_id: integer, start_date?: string, project_code?: string }

## Example prompts
- "What can I do in Float?"
- "Show me a summary of my Float account"

## More
- Page: https://mcp.ai/float
- Agent spec (llms.txt): https://mcp.ai/float/llms.txt
- Postman collection: https://mcp.ai/float/postman.json