# Armano MCP MCP

> Armano connects your AI client directly to your HR systems, giving you full control over workforce data via natural conversation. It lets you programmatically list employees, check time records, and manage leave requests without writing custom API calls.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** employee-records, time-tracking, absence-management, hr-automation, workforce-management, ipaas

## Description

This MCP lets you handle complex human resources tasks through simple chat commands. You can ask your agent to pull a complete directory of staff members or look up specific department affiliations. Need to audit who was clocked in when? Just ask for time tracking records, and the system pulls the metadata instantly. It’s about getting accurate oversight on absence requests and monitoring employee profiles without logging into multiple internal portals. Since Vinkius hosts this MCP, your agent connects once and gets access to Armano's full HR data set, making it a single source of truth for workforce orchestration.

## Tools

### list_employees
Generates a full directory listing of every employee in Armano.

### list_leaves
Lists all current and past leave requests, along with their status (pending, approved).

### list_projects
Shows a list of all active projects currently tracked.

### list_time_entries
Retrieves time entries, optionally filtering the results by a specific date range.

### check_armano_status
Verifies that your connection to Armano is active and working correctly.

### create_time_entry
Logs a new time entry for an employee.

### get_employee
Retrieves detailed information about a specific employee by name or ID.

### get_project
Gets details about a project, including scope and assigned personnel.

### get_time_entry
Retrieves specific time entry data for an employee on a given date.

### list_departments
Returns a list of all active departments within the organization.

## Prompt Examples

**Prompt:** 
```
List all active employees in my Armano account.
```

**Response:** 
```
I've retrieved your employee directory. You currently have 50 active profiles, including 'John Doe' (Department: Sales) and 'Sarah Manager'. Would you like the detailed role metadata for any of them?
```

**Prompt:** 
```
Show the time entries for 'Sarah Manager' from yesterday.
```

**Response:** 
```
Time intelligence orchestrated! For Sarah Manager, I've identified 2 entries from yesterday: Clock-in at 9:00 AM and Clock-out at 5:00 PM. I've retrieved the technical location metadata for your review. Need help auditing the total hours?
```

**Prompt:** 
```
Check for any pending absence requests for this week.
```

**Response:** 
```
Absence architecture orchestrated! I've identified 3 pending requests for this week, including 2 days for 'Mike Employee'. I've retrieved the technical request metadata and overlap status for your review. Shall I notify the managers?
```

## Capabilities

### View Workforce Directory
Get detailed profiles and department information for any employee in the system.

### Audit Time & Attendance Logs
Check clock-in/out metadata to maintain a complete audit trail of time worked.

### Manage Leave Requests
Access the full list and status of current time-off requests across departments.

### Process Employee Data Changes
Retrieve real-time updates on employee records and hosted documents.

### Verify System Connectivity Status
Check the connection status of your Armano account to ensure data is flowing correctly.

## Use Cases

### Preparing for Payroll
A payroll specialist needs to confirm total hours worked by everyone last month. Instead of downloading 50 individual time sheets, they ask their agent to run `list_time_entries` for the specified date range and get a consolidated list.

### Staffing a Project
A department lead needs to know who is available next week. They check the team directory using `list_employees`, then cross-reference that data with pending absences by calling `list_leaves` for availability checks.

### Onboarding a New Hire
An HR manager needs to confirm a new employee's profile details and department. They use the agent to call `get_employee` after entering the name, confirming all necessary data fields are populated before system access is granted.

### Auditing Overtime
A manager suspects overtime issues. Instead of manually checking logs, they instruct their agent to query specific time entries using `get_time_entry` for a period and check the total hours reported.

## Benefits

- Get instant oversight of employee status. Instead of navigating multiple tabs to check staff records, you can ask your agent to use `list_employees` and get a summary immediately.
- Audit time logs easily. You don't need to manually pull reports for payroll; the system gets time entry details using `get_time_entry`, giving you accurate clock-in/out timestamps instantly.
- Track absence without leaving your workspace. Use `list_leaves` to check pending requests and department availability, which cuts down on status update emails significantly.
- Keep systems talking. You can use `check_armano_status` before running complex queries. This confirms the API connection is working, preventing failed tasks mid-workflow.
- Handle project assignments efficiently. The MCP lets you look up both projects (`list_projects`) and staff details (`get_employee`), linking them together in one query.

## How It Works

The bottom line is, you tell your agent what HR information you need, and it handles the complex communication with Armano.

1. Subscribe to this MCP and grab your API Key from the Armano dashboard's App Integrations section.
2. Connect your AI agent (like Claude or Cursor) using your Vinkius client.
3. Ask your agent a question. It translates that request into an API call and returns the structured HR data.

## Frequently Asked Questions

**How do I find my Armano API Key?**
Log in to your account, navigate to **Settings** > **App Integrations**, and copy your unique API Token from the credentials section.

**Can I retrieve time entries via AI?**
Yes! The `list_time_entries` tool allows your agent to retrieve clock-in/out records for any specific period.

**How do I list my active employees?**
Use the `list_employees` tool to retrieve your complete directory along with the unique identifiers for all registered staff members.

**How do I use `list_time_entries` to filter records for a specific month?**
You must pass the date range in YYYY-MM-DD format. By providing start and end dates, you limit the results precisely, so your agent only pulls data from that period.

**When should I use the `create_time_entry` tool?**
Use this tool when you need to log time manually or correct existing records. It writes new entries directly into your Armano system, acting as a submission form through your agent.

**What specific information does `get_employee` provide about an individual's role?**
It retrieves core employee metadata, including their department affiliation and primary job title. This gives you enough context to verify if a person belongs in the correct team.

**Does `list_leaves` help me check for overlapping time off requests?**
Yes. By listing all current absence records, your agent can compare dates and flag any overlaps automatically. This is essential for planning staffing coverage across the company.

**What does `check_armano_status` tell me about my account connectivity?**
This tool verifies if the connection between your AI client and Armano is active. A successful call confirms that all API endpoints are reachable and ready for use.