# LiftedWork MCP

> LiftedWork connects your staffing agency operations directly to your AI client. You manage client accounts, track project tasks, and log time entries for placed candidates without leaving your chat window. It turns messy agency spreadsheets into structured project data you can query and update on the fly.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** staffing, candidate-management, job-listings, placement-tracking, recruitment-automation, talent-acquisition

## Description

Running a staffing agency means juggling client demands, tracking where your contractors are placed, and making sure every billable hour actually gets logged. Usually, that means bouncing between a CRM, a project board, and a timesheet app all day. This MCP collapses all of that into a single chat window. You just tell your AI client what needs to happen. Need to set up a new client project? Just ask. Need to see who is burning through their hours on a specific contract? Ask for the time logs. You stop clicking through tabs and start just asking for the data. When you subscribe through the Vinkius catalog, your agency gets a direct pipeline to manage these operational details using plain English. Your recruiters and account managers stop fighting with clunky dashboards. They just type what they need, and the system updates the project status or logs the time entry. It turns administrative overhead into a quick conversation. You get your mornings back instead of spending them updating spreadsheets. It keeps your team focused on placing talent instead of doing data entry.

## Tools

### create_project
Sets up a new project for a specific client with defined parameters.

### create_task
Adds a new task to an existing project and passes the required JSON data.

### list_clients
Returns a complete roster of all clients currently in your agency database.

### list_projects
Pulls every active and archived project across all your client accounts.

### list_tasks
Shows all agency tasks, letting you see what work is pending or done.

### list_time_entries
Fetches all tracked time entries so you can audit billable hours.

## Prompt Examples

**Prompt:** 
```
Show open positions and candidate pipeline status.
```

**Response:** 
```
Open positions: 8. 'Senior Developer' (12 applicants), 'UX Designer' (8), 'Project Manager' (15), 'DevOps Engineer' (6), 4 others. Pipeline: 45 total candidates. New (12), Screening (8), Interview (10), Offer (5), Placed (10). Avg time-to-fill: 28 days.
```

**Prompt:** 
```
Show candidates for the Senior Developer role.
```

**Response:** 
```
Senior Developer: 12 applicants. Interview stage: 4. Sarah Chen (5 yrs, Python/React, ⭐ top match). Mike Torres (7 yrs, Java/Angular). Lisa Park (4 yrs, Node/Vue). James Lee (6 yrs, Go/React). Screening: 3. New: 5. Offer pending: 0.
```

**Prompt:** 
```
Show active placements and contract details.
```

**Response:** 
```
Active placements: 10. Contract: 6, Permanent: 4. By client: Acme Corp (3), TechCo (2), Others (5). Ending within 30 days: 2. 'Ana Costa at Acme' (contract, ends May 15). 'David Kim at TechCo' (contract, ends May 20). Revenue this quarter: $45K.
```

## Capabilities

### Set up new client projects
Create new client projects and define the scope of work for your placed contractors.

### Assign and track tasks
Break down projects into specific tasks and assign them to your internal team or contractors.

### View all agency clients
Pull a complete list of your current and past agency clients to review account health.

### Monitor project status
Check the current state of all active projects across your entire agency portfolio.

### Review task progress
See exactly what tasks are pending, in progress, or completed for any given client.

### Log and audit time entries
Track billable hours and review time logs to ensure contractor invoices match actual work.

## Use Cases

### End of month billing panic
It is the 28th and you need to invoice three clients. You ask your agent to run list_time_entries and filter by client. It pulls the exact hours logged for each contractor, and you generate the invoices in minutes instead of hours.

### New client kickoff
You just signed a major tech account. Instead of manually clicking through a setup wizard, you tell your agent to run create_project for the new client and use create_task to build out the initial onboarding checklist.

### Mid-project status check
A client emails asking for a progress update. You ask your agent to run list_tasks for their specific project. It returns the exact status of every deliverable, and you reply to the client before they even finish their coffee.

### Auditing contractor utilization
You need to know if your placed devs are actually working their contracted hours. You run list_projects to find their assignments, then check list_time_entries to verify they are hitting their weekly targets.

## Benefits

- Stop digging through spreadsheets to find client info. Use list_clients to pull your entire roster instantly and see exactly who you are working with today.
- Onboarding a new account takes minutes. Just tell your agent to run create_project and create_task to get the new client set up and the work broken down.
- Never lose track of billable hours again. Query list_time_entries to see exactly what your contractors logged and ensure your invoices match the actual work.
- Get a clear picture of your agency workload without opening a dashboard. Run list_projects and list_tasks to see every active engagement and pending deliverable.
- Keep your team aligned without endless status meetings. Your AI pulls the latest task updates and project statuses on demand, so you always have the real numbers.

## How It Works

The bottom line is you manage your entire agency backend through plain text commands instead of clicking through five different software tabs.

1. Connect your LiftedWork account and generate an API key from your agency dashboard.
2. Link the MCP to your preferred AI client using your Vinkius subscription.
3. Start creating projects, assigning tasks, and logging time directly from your chat window.

## Frequently Asked Questions

**How do I see all my current clients using LiftedWork?**
Just ask your AI client to run list_clients. It pulls your entire agency roster instantly so you can see who you are working with.

**Can I create a new project for a client directly in chat?**
Yes. Tell your agent to run create_project and provide the client details. It sets up the new engagement in your LiftedWork account immediately.

**How do I track billable hours with LiftedWork?**
Ask your AI to run list_time_entries. It fetches all the logged hours so you can audit contractor time and prepare your client invoices.

**What happens if I run list_tasks in LiftedWork without a filter?**
It returns every single task across your entire agency. It is better to ask your agent to filter by a specific project to keep the data manageable.

**Do I need to use create_task before I can track time in LiftedWork?**
No, time entries are tied to projects, not just tasks. But using create_task helps you break down the project into trackable milestones.

**Can I see all active engagements using LiftedWork?**
Yes, just ask your agent to run list_projects. It pulls every active and archived project across all your client accounts in one go.

**Why does `list_projects` fail when I first connect the LiftedWork MCP?**
You must enter your LiftedWork API key during the initial setup. The MCP needs this credential to authenticate your account before it can pull any project data.

**How do I format the input when using `create_task` in LiftedWork?**
Pass your task details as a standard JSON string with double quotes around all keys and string values. The MCP parses this exact format to build the new task record.

**Can I manage candidates and track placements?**
Yes. Browse candidate profiles, track their status through the pipeline, and monitor active placements with contract details.

**Can I browse open positions?**
Yes. List all open job listings with requirements, location, and application counts.

**What API does LiftedWork use?**
Bearer authentication against `api.liftedwork.com/v1`.