# KPA Flex MCP MCP

> KPA Flex connects your AI agent to manage EHS compliance for physical workplaces. It lets you list safety inspections, audit employee records and certifications, search incident reports across all sites, and track company equipment inventory with natural language commands.

## Overview
- **Category:** human-resources
- **Price:** Free
- **Tags:** ehs-management, workplace-safety, compliance-auditing, inspection-reports, employee-training

## Description

Maintaining a safe workplace isn't just checking boxes; it requires constant data access. This MCP connects your AI agent directly to KPA Flex, giving you real-time visibility into site safety and employee compliance. You can ask questions like, 'Which employees are overdue for their lifting certification?' or 'Show me all inspections done in the last month that flagged open issues.' It compiles safety reports, checks training status against current regulations, and pulls detailed equipment lists from your company assets. Because this MCP lives on Vinkius, you connect it alongside your other work tools, keeping all compliance data centralized. You'll stop sifting through PDFs and start getting clear answers instantly.

## Tools

### list_ehs_inspections
Lists every safety inspection conducted, letting you see when and where they took place.

### get_inspection_details
Fetches all detailed findings from a single, specific safety inspection report.

### list_flex_employees
Gathers a simple list of all employees registered in the KPA Flex system.

### get_employee_ehs_profile
Pulls a specific employee's complete EHS profile, detailing their training and certification status.

### list_custom_forms
Shows a list of all custom forms that can be used for auditing or reporting purposes.

### get_form_schema
Retrieves the technical definition (the schema) for any custom audit or reporting form.

### list_company_assets
Provides an inventory list of equipment and physical company assets managed by the organization.

### list_safety_trainings
Provides a record of employee training sessions and certification dates.

### search_ehs_reports
Searches through all historical EHS reports using keywords or date ranges to find specific incidents.

### get_flex_site_stats
Gathers high-level statistics about site safety performance at a glance.

## Prompt Examples

**Prompt:** 
```
List all safety inspections from the last 7 days
```

**Response:** 
```
I've found 15 safety inspections conducted this week. 12 were marked as 'Compliant' and 3 have 'Open Issues'. Would you like to review the findings for the open ones?
```

**Prompt:** 
```
Check compliance profile for employee 'EMP-555'
```

**Response:** 
```
Retrieved EHS profile for employee EMP-555 (John Smith). All 5 mandatory safety trainings are 'Completed' and current. No active incident reports found.
```

**Prompt:** 
```
Search reports for keywords 'forklift incident'
```

**Response:** 
```
Searching safety reports… I found 2 reports matching 'forklift incident'. One from last month in Warehouse A and one from 2023. Which one should I open?
```

## Capabilities

### Check employee safety files
The agent retrieves an individual employee’s full EHS profile, including current certifications and training records.

### Search all incident reports
You can search across every available report using natural language to find specific incidents or keywords like 'forklift' or 'chemical spill'.

### List and audit site inspections
The agent gathers a list of past safety audits, pulling up full details for any inspection you need to review.

### View company equipment lists
You can pull an inventory list of all company assets and machinery managed within the KPA Flex system.

### Get high-level safety metrics
It compiles site statistics, giving you a quick overview of overall workplace safety performance.

## Use Cases

### Investigating a near-miss incident
A worker reports seeing something wrong in Warehouse B. Instead of manually searching files, the agent uses 'search_ehs_reports' with keywords like 'Warehouse B' and 'near miss'. It quickly pulls up two relevant reports from that area last month, letting you know exactly who inspected it.

### Onboarding a new team member
HR needs to confirm the training status for 20 new employees. They use 'list_flex_employees' and then run 'get_employee_ehs_profile' on the entire group, verifying that all mandatory safety trainings are complete before they start.

### Annual compliance audit prep
The compliance officer needs a snapshot of site health. They use 'get_flex_site_stats' to get overall metrics and then run 'list_safety_trainings' to ensure the entire workforce meets the minimum certification requirements.

### Auditing specialized equipment
The team needs to verify if a piece of machinery is accounted for. They use 'list_company_assets' to get an inventory list, and then they can cross-reference that data with specific inspection details using 'get_inspection_details'.

## Benefits

- Stop manually checking compliance sheets. Use the tool to get an employee’s full EHS profile instantly, confirming mandatory training status.
- Don't wait for audits. Run a search through all EHS reports using 'search_ehs_reports' and pull up every instance of a specific hazard or keyword.
- Know what equipment you have on site. The tool to list company assets gives you an accurate, real-time count of critical machinery.
- Handle regulatory questions quickly. Instead of digging through files, just ask for 'list_ehs_inspections' and get the summary report.
- Manage forms without IT help. You can use 'get_form_schema' to see exactly what fields are required for any custom audit form.

## How It Works

The bottom line is: you don't have to learn API calls; you just tell your AI client what data you need, and it handles the rest.

1. First, subscribe to the KPA Flex MCP and generate an API key from your admin settings.
2. Then, enter that key into the configuration panel for your AI client. This links everything up.
3. Finally, just talk to your agent. You ask it what you need—like 'Show me all employees who haven't completed fire safety training’—and it runs the query.

## Frequently Asked Questions

**How do I check an employee's training status with get_employee_ehs_profile?**
You provide the employee ID to 'get_employee_ehs_profile'. The agent returns a summary of all mandatory safety trainings, noting which ones are current and which require renewal.

**What can search_ehs_reports find?**
The tool searches across every historical EHS report. You can look for specific keywords like 'chemical spill' or narrow the results down by date range to pinpoint an incident.

**Do I need multiple tools to list all inspections? (list_ehs_inspections)**
No, calling 'list_ehs_inspections' provides a summary of all audits. If you want deep details on one specific audit, then you use 'get_inspection_details'.

**Can I find out what forms are available using list_custom_forms?**
Yes, running 'list_custom_forms' shows you every custom form type. If you want to know what fields *must* be on one of those forms, use 'get_form_schema'.

**If I need to check my connection scope, what does using list_company_assets tell me?**
It verifies your system access and returns a clean inventory of all managed equipment. If the tool runs successfully, it confirms your AI client has read permissions across the asset module.

**What specific data points does get_form_schema provide for custom audits?**
It returns the exact structure of a form, including field names, required data types (text, date, number), and whether fields are mandatory. This lets your agent validate inputs before submission.

**How do I get a comprehensive list of all personnel using list_flex_employees?**
This tool returns the full roster of employees in the system. You'll get unique employee IDs, names, and basic contact details needed to run bulk compliance checks.

**What metrics are available when I use get_flex_site_stats?**
It provides a high-level snapshot of site safety performance. You receive key statistics like total incidents, average response time, and overall compliance percentages for immediate operational review.

**Where do I find my KPA Flex API Key?**
In KPA Flex, go to your profile settings or the administrative control panel to generate a new API Key for integration.

**Can I see photos attached to inspections?**
The `get_inspection_details` tool returns metadata and links to resources, including photos if available.

**Does this support creating new inspections?**
The current version focuses on data retrieval and auditing. Creation tools are being considered for future releases.