# Envoy MCP

> Envoy MCP lets you manage all physical workplace operations using natural conversation. Use your AI agent to pre-register visitors, book desks and meeting rooms, track incoming deliveries, audit real-time office capacity, and confirm employee sign-ins—all without opening the Envoy dashboard. It gives you full control over corporate logistics and occupancy planning.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** visitor-management, desk-booking, hybrid-work, office-operations, room-scheduling, workplace-safety

## Description

This MCP connects your workplace account directly, letting you manage complex office operations via natural language prompts. Instead of navigating separate scheduling apps for rooms, desks, visitors, and deliveries, your agent handles it all in one conversation. You can confirm a desk reservation while simultaneously checking the capacity limit for that floor, or pre-register an unexpected guest and get their QR code invite instantly. Whether you're coordinating logistics across multiple sites or simply need to know how many people are on site right now, this tool works across your entire portfolio of locations.

By connecting through Vinkius, you give any MCP-compatible client the ability to handle everything from listing all available desks to getting detailed employee sign-in logs for compliance checks. It takes the friction out of physical operations management. You tell your agent what needs doing—like 'I need a room booked next Tuesday and I also need to track the delivery arriving at 3 PM'—and it executes the whole sequence.

## Tools

### list_locations
Retrieves a complete list of all office locations managed within your Envoy account.

### list_visitors
Shows every visitor who has checked in or is expected at any specified location.

### pre_register_visitor
Creates a new visitor profile, managing their arrival details and security compliance steps.

### list_deliveries
Retrieves all incoming packages and deliveries scheduled for an Envoy location.

### list_desks
Generates a list of every hot desk available at a given office site.

### reserve_desk
Books a specific hot desk for a designated time slot in the Envoy system.

### cancel_desk_reservation
Removes an existing desk booking from the organizational map.

### list_rooms
Lists all bookable meeting rooms and spaces at a specific office location.

### get_employee_signins
Fetches detailed records of employee physical sign-in data for a given time period or site.

### get_capacity
Retrieves the current, real-time occupancy count and capacity limit for an office location.

## Prompt Examples

**Prompt:** 
```
Pre-register guest 'Jane Doe' (jane@example.com) for tomorrow at 10 AM
```

**Response:** 
```
Guest registered! I've scheduled Jane Doe's arrival at your office for tomorrow at 10:00 AM. A QR code invite and NDA link have been sent to her email. Would you like to reserve a meeting room for this time?
```

**Prompt:** 
```
Reserve desk 'D-101' at the 'Main Office' for next Friday
```

**Response:** 
```
Desk reserved! You have successfully booked desk D-101 for next Friday. Your reservation is confirmed in the Envoy organizational map and will appear on your office dashboard.
```

**Prompt:** 
```
What is the current occupancy at the London office?
```

**Response:** 
```
Checking London capacity... There are currently 45 people checked in out of a 100-person limit (45% occupancy). The office is currently within compliance boundaries.
```

## Capabilities

### Manage Visitor Flow
Pre-register expected guests, generate QR code invites, and map security compliance steps for arrivals.

### Reserve Physical Space
List available hot desks or book specific meeting rooms by committing precise timing payloads to the organization's map.

### Audit Occupancy Metrics
Check real-time capacity and calculate active load metrics to ensure the office stays within compliance boundaries.

### Track Deliveries and Logistics
View incoming packages, monitor their status, and extract pickup receipts without going through physical front desk processes.

### Audit Employee Presence
Fetch detailed historical records of employee sign-ins across any date range or specific location.

## Use Cases

### The Unexpected Guest
An executive asks their agent: 'I have a guest arriving today who isn't on the list.' The agent uses `list_visitors` to check records, then executes `pre_register_visitor` and sends the necessary QR code invitation.

### End-of-Day Cleanup
The Office Manager asks: 'What's our capacity for the whole building?' The agent immediately runs `get_capacity`, providing a number and percentage, allowing them to send out last-minute warnings before closing.

### Booking Overlap Conflict
A user needs two desks next week. They ask for help reserving space, and the agent uses `list_desks` to check availability first, then executes `reserve_desk` for both spots.

### Investigating Attendance
The Security Team asks: 'Show me who was physically present last month.' The agent runs `get_employee_signins`, providing a filtered log trail that validates attendance records instantly.

## Benefits

- Never open a dashboard to book a desk again. You can use the `reserve_desk` tool and secure your spot instantly with a single conversational prompt.
- Quickly check compliance status. Use the `get_capacity` tool to see real-time occupancy metrics, ensuring you stay within legal limits without manual counting.
- Simplify guest arrivals. Instead of sending emails, use `pre_register_visitor` to create a visitor profile and distribute QR code invites immediately.
- Automate coordination. You can list available rooms (`list_rooms`) and then reserve one using `reserve_desk`, all in the same agent conversation flow.
- Audit history easily. The `get_employee_signins` tool lets you pull log trails for any date range, making compliance reporting painless.

## How It Works

The bottom line is: you talk to your agent, and it handles the complex scheduling and tracking across all your physical locations.

1. Subscribe to the Envoy MCP and provide your unique API Key, which you find within the Envoy Console under Integrations.
2. Connect this MCP to your preferred AI client (like Claude or Cursor).
3. Use natural conversation to ask for specific office actions, such as listing available desks or checking current capacity.

## Frequently Asked Questions

**How does the Envoy MCP handle capacity limits?**
You use the `get_capacity` tool to pull real-time data showing how many people are checked in versus the building's maximum limit. This helps you ensure compliance before scheduling large groups.

**Can I book desks and rooms at different locations?**
Yes. The MCP allows you to work across multiple sites. You can use `list_locations` first, then perform actions like booking or checking capacity for any of those listed buildings.

**What if I need to check historical attendance records?**
Use the `get_employee_signins` tool. It fetches detailed log trails for employee sign-in data, letting you audit who was physically present across any date range.

**Do I have to use a specific format to pre-register a visitor?**
No. You just ask your agent to 'Pre-register Jane Doe for tomorrow.' The MCP handles the necessary data fields and security compliance steps automatically via `pre_register_visitor`.

**Is this useful for coordinating deliveries?**
Absolutely. Use `list_deliveries` to get a full status report on incoming packages, letting you know if they've arrived and where the pickup receipt is located without calling reception.