# Worksuite MCP

> Worksuite handles your entire global contractor lifecycle—from finding talent to paying invoices. Connect this MCP and let your AI agent manage job openings, track project milestones, list all active contractors, and monitor payment status using plain conversation.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Tags:** freelancer-management, contractor-onboarding, talent-directory, vendor-management, global-hiring

## Description

Managing a global workforce requires juggling dozens of tabs: one for job postings, another for current projects, and three more just for payments. This Worksuite MCP lets you stop clicking and start talking to your AI agent. You can ask it things like, 'What's the status of the mobile app project and who is responsible?' or 'List all contractors paid last quarter.' It pulls that data together immediately. The system tracks every single interaction—whether you are using `list_talents` or checking `list_invoices`—and generates a tamper-proof, cryptographically signed audit trail for compliance. This means you always know who saw what and when. You connect once from your preferred AI client, and this MCP gives you full visibility into job pipelines, project deliverables, and payment records across your entire contractor network.

## Tools

### get_job
Retrieves the full details for a specific job opening ID.

### get_project
Gets detailed information about one particular project.

### get_talent
Pulls all the metadata and details for a single contractor profile.

### list_invoices
Retrieves a list of invoices associated with your accounts.

### list_jobs
Lists all current job openings in the Worksuite system.

### list_payments
Provides a record of recent payments made or received.

### list_projects
Shows an overview and list of all active projects.

### list_talents
Lists every single contractor profile stored in your directory.

### list_tasks
Displays a comprehensive list of all tasks tied to projects or talent.

## Prompt Examples

**Prompt:** 
```
List all active contractors in my Worksuite directory.
```

**Response:** 
```
I've retrieved your directory. You have 25 active contractors. The most recent additions include 'John Doe' (Web Developer) and 'Jane Smith' (Graphic Designer).
```

**Prompt:** 
```
Show the status of project 'Mobile App V2'.
```

**Response:** 
```
Project 'Mobile App V2' is currently 'In Progress'. 3 out of 5 milestones have been completed by the assigned contractors. Would you like to see the pending tasks?
```

## Capabilities

### Check Contractor Directory
List all existing talent profiles, or get specific details on a single freelancer or contractor.

### Track Job Openings
See what current job roles are posted and pull up specifics for any given opening.

### Monitor Projects
Get a list of active projects, or check the specific progress, milestones, and deliverables for one project.

### Audit Payments and Billing
Pull lists of payments received, track invoices, and monitor payment statuses for your global team.

### Review Task Progress
List all associated tasks linked to a project or individual contractor.

## Use Cases

### Need to onboard a new contractor quickly.
Instead of emailing HR, the agent checks `list_talents` for existing candidates. It then uses `get_talent` on the top three profiles and asks if any have completed similar tasks in the past, speeding up vetting.

### Project is stalling; need to reallocate resources.
The agent checks `get_project` to see which milestones are late. It then runs `list_tasks` for those stalled items and suggests specific available talent using `get_talent` details.

### Client asks for a full payment reconciliation report.
The agent handles the request by running both `list_payments` and `list_invoices`, cross-referencing them to confirm that every billed project has corresponding payments logged.

### Hiring needs to match a job opening to specific skill sets.
The agent uses `list_jobs` to identify the open role, then runs `get_job`. It immediately cross-references this against `list_talents` and pulls top matches using `get_talent` details.

## Benefits

- Instantly check available resources. Instead of manually reviewing spreadsheets, you can use `list_talents` and `get_talent` to see exactly who is available for a role right now.
- Never lose track of money again. You can use `list_payments` alongside `list_invoices` to get an instant financial picture without logging into the accounting portal.
- Keep projects on time. If you need a status update, asking about a project lets your agent check `get_project` and see exactly which milestones are lagging behind schedule.
- Streamline hiring. Need new people? Use `list_jobs` to see open roles, then use `get_job` to pull the specific requirements for those roles in one go.
- Build full visibility. Combining calls like `list_projects`, `list_tasks`, and `get_talent` gives you a complete picture of capacity and workload without context switching.

## How It Works

The bottom line is you manage your entire contractor life cycle by speaking to one centralized source of truth.

1. Subscribe to this MCP and provide your Worksuite Base URL and API Key.
2. Connect your AI client (Claude, Cursor, etc.) using the credentials. The connection happens through a secure, zero-trust proxy.
3. Ask your agent anything—'Show me all active contractors in the West Coast region.'—and get immediate data responses.

## Frequently Asked Questions

**How do I check if a contractor is available?**
Use the `get_talent` tool. You can input an ID or name to get all their metadata and current status within your directory.

**Can Worksuite MCP list open jobs?**
Yes, use `list_jobs`. This function gives you a complete overview of every job opening currently set up in your system.

**Do I need to check payment history manually using `list_payments`?**
No. By calling `list_payments`, the agent provides an aggregated view, allowing you to see recent transactions without manual date range filtering.

**How do I get project details and tasks at once?**
You can call `get_project` first. Then follow up by asking for related work using `list_tasks`, which shows all milestones connected to that specific project ID.

**When using `list_invoices`, what financial data do I get for tracking billing?**
It provides a detailed list of every invoice record. You'll see the invoice status, the total amount due, and which specific project ID it is tied to.

**If I need an overview of all current work, how does `list_projects` help me identify active assignments?**
The tool returns a list of every existing project in Worksuite. You can take the resulting IDs and query them with other MCP tools to get specific details on milestones or assigned tasks.

**When using `get_talent`, what criteria can I use to filter results beyond just listing all available workers?**
You must pass specific filters into the tool call. The underlying Worksuite API allows you to narrow down searches by skill set, role title, or contract status fields.

**Before running any query, like with `list_talents`, what credentials are required for the MCP connection?**
You'll need your Worksuite Base URL and API Key from your account settings. The MCP uses these keys only in transit through a secure proxy; they never sit on disk.

**Where do I find my Worksuite API Key?**
API access is typically available on Enterprise or Plus plans. Navigate to your workspace settings or contact your Worksuite account manager to generate your unique API key.

**What format should the Base URL follow?**
Your Base URL is usually your workspace domain followed by the API path, for example: `https://yourcompany.worksuite.com/api/v1`.