# Insightful MCP

> Insightful MCP manages employee productivity, time tracking, and activity reports by connecting your AI client directly to workforce data. This tool lets agents list employees, track project progress, monitor real-time activity logs, and pull detailed attendance or productivity metrics for any team. It's built for anyone needing deep visibility into who worked on what and how long it took.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** workforce-analytics, time-tracking, employee-monitoring, performance-metrics, attendance-tracking, productivity-reporting

## Description

You can use this MCP to give your AI agent total visibility over workforce operations. Instead of juggling multiple HR dashboards and time-tracking spreadsheets, you simply ask your agent to pull the data. The tool lets you list all employees and teams in an organization, then retrieve deep reports on attendance or aggregate productivity metrics for specific periods. You can also track project progress by listing active projects or checking out recent employee activity logs associated with a task. If you're managing performance monitoring, this MCP provides the core capabilities to pull everything together—it’s basically automating your team management process from start to finish. When you connect through Vinkius, you get access to all these functions in one place, letting your agent act as the central source of truth for who did what and when.

## Tools

### get_attendance
Fetches aggregated time tracking and attendance records for a group or period.

### get_employee
Retrieves specific contact details and profile information for one employee.

### get_productivity
Generates aggregated reports detailing the overall productivity levels of a group or team.

### list_activity
Provides a log of recent actions and activity performed by employees in the organization.

### list_employees
Retrieves a list of every employee currently registered within the system.

### list_locations
Provides an inventory of all physical or virtual locations associated with the company.

### list_projects
Lists every active and past project that has been set up in the system.

### list_tasks
Retrieves a comprehensive list of individual tasks across all ongoing projects.

### list_teams
Lists every designated team within the organization structure.

### list_webhooks
Shows all webhooks that have been configured to push data to external systems.

## Prompt Examples

**Prompt:** 
```
List all employees in the 'Engineering' team.
```

**Response:** 
```
I'll fetch the employee list and filter for the engineering team from Insightful.
```

**Prompt:** 
```
Show me the productivity report for last week.
```

**Response:** 
```
I'll retrieve the aggregated productivity metrics for your organization.
```

**Prompt:** 
```
Check recent activity logs for project ID '789'.
```

**Response:** 
```
I'll look up the activity logs associated with that specific project.
```

## Capabilities

### Generate Time & Attendance Reports
Retrieves compiled data on employee attendance, logging time spent working.

### Retrieve Employee Profiles
Gets specific details and information for any individual staff member.

### Analyze Productivity Metrics
Pulls aggregated reports detailing overall team productivity levels over time.

### List Organization Entities
Provides comprehensive lists of all employees, teams, projects, and locations registered in the system.

### Monitor Activity Logs
Lists recent actions or activity performed by any employee within the organization.

## Use Cases

### The Quarterly Performance Review
A manager needs to write performance reviews. They ask their agent to pull data that combines productivity reports (`get_productivity`), employee details (`get_employee`), and a log of recent actions (`list_activity`) for the past quarter, giving them solid evidence for every metric.

### Onboarding a New Team
An HR coordinator needs to know who reports to whom. They run `list_employees` and then filter by team membership using `list_teams`, getting the full organizational structure in one step.

### Investigating Project Delays
A project lead notices a task is late. They check `list_tasks` to find it, and then use `list_projects` to confirm which larger initiative the task belongs to, immediately identifying the scope issue.

### Auditing System Connections
A DevOps engineer needs to verify data flow. They run `list_webhooks` to check all connected systems and then use `list_locations` to ensure regional data points are accounted for.

## Benefits

- Stop manually compiling time sheets. Use `get_attendance` to pull complete, aggregated attendance reports instantly.
- Get a real-time snapshot of team status by running the `list_activity` tool. You'll know exactly what people were working on this morning.
- When you need personnel data, calling `get_employee` gets you all necessary details without logging into multiple HR portals.
- Track resource usage across your company by using `list_projects` and then cross-referencing tasks via `list_tasks` in a single query.
- Instead of guessing team utilization, use `get_productivity` to pull hard metrics that show where the bottlenecks are.
- You can get an organizational map of resources by running `list_employees` and pairing it with `list_teams`.

## How It Works

The bottom line is that your AI client acts as the translator between your natural questions and complex HR/productivity databases.

1. Tell your AI agent what data you need, for example, 'I need last month's productivity report.'
2. The agent sends a request to this MCP, which uses the Insightful API to pull the necessary metrics and logs.
3. You receive clean, structured data—not just raw text—that you can use immediately in your workflow.

## Frequently Asked Questions

**How do I use Insightful MCP to check attendance?**
You call `get_attendance`. This tool retrieves aggregated reports covering time tracking and general attendance, which is ideal for payroll or compliance checks. You don't need to calculate anything; the data comes out ready-to-read.

**Can I find out what projects are running?**
Yes, use `list_projects`. This tool pulls a complete list of every project that has been set up in your organization's system. It’s the fastest way to get an overview of current work.

**Is Insightful MCP better than just looking at employee lists?**
Yes. While `list_employees` gives you names, running a report like `get_productivity` tells you *what those people accomplished*. It adds the crucial layer of performance data.

**I need to check recent worker activity using Insightful MCP.**
Use `list_activity`. This tool gives you a detailed log of recent actions across your workforce, helping you pinpoint exactly when and where work was done within the platform.