# AssessTEAM MCP

> AssessTEAM connects your agent to employee performance data, project financials, and time logs in one place. You can run 360-degree reviews, track who is billing what, and see if a project is actually making money—all through natural conversation. It cuts out the spreadsheets and dashboard diving.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** performance-management, employee-evaluation, timesheet-tracking, kpi-tracking, 360-reviews, workforce-development

## Description

Managing human capital usually means juggling three different systems: HR for evaluations, accounting for cash flow, and operations for time tracking. This MCP changes that. Instead of manually compiling reports across dashboards or exporting data to Excel just to figure out if 'Project Phoenix' was worth the manpower, your agent handles it all. You simply ask your AI client a question—like 'What was the profitability last quarter compared to the Engineering team’s performance?'—and you get an instant answer that connects employee reviews directly to dollar signs. It gives you total visibility into how people and projects perform together. This kind of cross-functional insight is exactly what Vinkius made this MCP possible for.

## Tools

### create_timesheet_entry
Records a new entry detailing hours worked by an employee on a specific project.

### list_employees
Retrieves a list of all active employees in the organization.

### list_performance_evaluations
Fetches records of past performance reviews and KPI assessments for employees.

### get_profitability_report
Generates a detailed financial report showing the profit and margin for a selected project.

### list_projects
Retrieves a list of all active projects managed within AssessTEAM.

### list_organizational_teams
Provides a list and structure map of defined organizational teams.

### list_timesheets
Lists historical time entries and records for an employee or project.

## Prompt Examples

**Prompt:** 
```
List all active projects and their status.
```

**Response:** 
```
I've retrieved your projects. You have 4 active initiatives including 'Website Redesign' (On track), 'Mobile App v2', and 'Client Audit'. Which one would you like profitability metrics for?
```

**Prompt:** 
```
Log 8 hours for employee 'emp_1029' on project 'proj_8823' for today.
```

**Response:** 
```
Time log created! I've added 8 hours to employee emp_1029's timesheet for project proj_8823 today. The entry has been recorded successfully in AssessTEAM.
```

**Prompt:** 
```
Show me the latest performance evaluations.
```

**Response:** 
```
I've fetched the evaluations. Over the last quarter, 15 reviews were completed. Average KPI score is 4.2/5.0. Shall I retrieve the detailed feedback for the 'Engineering' team?
```

## Capabilities

### Calculate project profit margins
Get detailed financial reports showing if a specific project or department is making money.

### Track labor hours against projects
Create and retrieve time logs to accurately report employee work hours for billing.

### Review workforce structure
See a list of all employees, departments, and team hierarchies within the company.

### Query performance history
List past employee evaluations and KPI scores to track development over time.

## Use Cases

### Closing the books on a client project.
A project manager asks their agent: 'How much did Project Zenith cost us versus how much revenue it generated?' The agent first uses `list_projects` to confirm the ID, then calls `get_profitability_report`, giving an instant answer that links labor costs directly to profit.

### Reviewing employee workload and billing.
An operations lead asks: 'Show me all timesheets for John Doe over the last month.' The agent uses `list_timesheets` and cross-references it with `list_employees` to give a detailed, auditable report of billable hours.

### Planning department restructuring.
An HR manager needs to know which teams are performing poorly. They ask the agent to combine results from `list_organizational_teams` and `list_performance_evaluations`, allowing them to pinpoint departments needing immediate support.

### Checking if a new hire is ready for billing.
A business owner asks: 'Did the new team complete their required training hours?' The agent checks `list_timesheets` and confirms that all mandatory time entries were logged before approving status changes.

## Benefits

- You don't have to manually aggregate time logs. Use the `create_timesheet_entry` tool to log hours, and then use your agent to query `list_timesheets` for a complete history of work.
- Stop guessing about project health. Run `get_profitability_report` to see exactly how much money each initiative is generating based on current labor costs.
- Understand your workforce structure instantly by listing teams and employees using `list_organizational_teams` and `list_employees`. Know who reports to whom without opening a directory.
- Track talent development history. The `list_performance_evaluations` tool lets you pull up past reviews, so you can measure growth against concrete metrics year over year.
- Manage project scope visibility by listing all active projects via `list_projects`. This gives you the necessary context before checking profitability or staffing needs.

## How It Works

The bottom line is you stop jumping between HRIS and accounting platforms; you just ask one smart tool for the answer.

1. Subscribe to this MCP and input your AssessTEAM API key.
2. Connect the service credentials via any MCP-compatible client (Claude, Cursor, etc.).
3. Use natural language prompts with your agent to query employee status or project finances.

## Frequently Asked Questions

**How do I use `create_timesheet_entry`?**
You tell your agent to create a timesheet entry, specifying the employee ID, the project name, and the hours. The MCP handles logging that accurate time against the correct job.

**Can I check project profitability using `get_profitability_report`?**
Yes. You tell your agent which project you want analyzed, and it generates a detailed report showing the financial margin for that specific initiative.

**What is the difference between `list_employees` and `list_organizational_teams`?**
The list of employees provides individual records. The list of organizational teams maps out the structure, showing which groups exist and how they relate to one another.

**`list_performance_evaluations`—what kind of data does it give?**
It gives you historical review metrics, including past KPI scores and general feedback records. It helps track employee development over time.

**How do I use `list_timesheets` to find entries from a specific time period?**
You can filter timesheet results by providing start and end dates in the query parameters. This lets you quickly review labor costs or performance for a defined historical window without fetching every record.

**What happens if `list_employees` fails to return any data?**
This usually means either no employees are registered under your current account permissions, or the API key needs updating. Double-check that your credentials grant access across all required organizational units.

**Does `list_projects` provide enough detail to calculate profitability?**
No, listing projects gives you basic metadata like names and statuses. To get financial metrics or margin analysis, you must use the separate `get_profitability_report` tool.

**Are there limitations on how often I can run `create_timesheet_entry`?**
The system handles rate limiting to maintain stability. If you make too many entries in rapid succession, your agent will receive an error; try spacing out your calls slightly.

**Can I see the profitability metrics for a specific project?**
Yes! Use the `get_profitability_report` tool. Your agent will retrieve detailed financial data, including cost vs. revenue and margin analysis for your active projects.

**How do I add a new timesheet entry for an employee?**
Use the `create_timesheet_entry` action. Provide the Employee ID, Project ID, number of hours, and the date in YYYY-MM-DD format to log the work instantly.

**Is it possible to list all team members via AI?**
Absolutely. Use the `list_employees` query. The agent will retrieve the complete directory of collaborators and team members associated with your account.