# Envoy MCP

> Envoy handles all your office operations through an AI agent. Use this MCP to manage visitor check-ins, book hot desks and meeting rooms, track deliveries, and measure real-time occupancy across any global campus location. It gives you full control over physical workplace logistics right from a natural conversation.

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

## Description

This connector lets you run your entire office management system through an AI agent. You can handle everything from pre-registering expected guests to reserving specific desks or checking the current capacity of a building without ever opening the Envoy dashboard. Need to know how many people are actually in the office? Check real-time occupancy data instantly. Did a package arrive late? Track its status and get the pickup receipt details. You can also analyze employee sign-in logs across any date range just by asking your agent. The power here is connecting multiple operations; for instance, chaining this Envoy MCP with another service—like a billing system or a messaging tool—allows you to build automations that span different platforms using one AI agent. Because everything runs through the Vinkius platform, your credentials pass through a zero-trust proxy, meaning your keys never sit on a disk.

## Tools

### cancel_desk_reservation
Cancels a previously booked hot desk reservation at the specified location.

### get_capacity
Retrieves real-time data showing how many people are currently in the office versus the maximum limit.

### get_employee_signins
Fetches a list of employees who signed into the building on specific dates and times.

### list_deliveries
Gets a complete manifest of all packages currently waiting for pickup at an office location.

### list_desks
List all hot desks at an Envoy location

### list_locations
List all office locations managed in Envoy

### list_rooms
List all bookable rooms/spaces at an Envoy location

### list_visitors
List all visitors checked in or expected at an Envoy location

### pre_register_visitor
Pre-register a visitor in Envoy

### reserve_desk
Reserve a hot desk in Envoy

## 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 Check-ins
Pre-register arrivals and send QR code invites while tracking security compliance.

### Book Desks and Rooms
Find available desks or meeting spaces, then reserve them by committing specific times.

### Track Deliveries
List all incoming packages at a location and generate pickup receipts.

### Audit Office Capacity
Measure current occupancy metrics against the site's maximum capacity limit.

### View Employee Presence
Fetch historical log trails to validate who was physically signed into the office on a given date range.

## How It Works

The bottom line is, you talk to your agent naturally, and it runs the complex logistics check through Envoy for you.

1. Subscribe to this MCP and input your Envoy API Key, which you grab from the Envoy Console's integration settings.
2. Connect the service to your preferred AI client (Claude, Cursor, or any compatible agent).
3. Ask your agent a question like, 'What's the current occupancy at the London office?' and let it run the request.

## Frequently Asked Questions

**Can my agent register a guest before they arrive at the office?**
Yes. Use the 'pre_register_visitor' tool. Provide the visitor's name, email, and expected arrival time. The agent will command the Envoy backend to schedule the arrival and deliver a QR code invite seamlessly.

**How do I book a hot desk for a specific date via chat?**
Use the 'reserve_desk' tool. Provide the location ID, the specific desk ID, and the target date (YYYY-MM-DD). Your agent will claim the desk in the Envoy organizational map and update the spatial UI instantly.

**Can I monitor real-time office capacity through the agent?**
Absolutely. Use the 'get_capacity' tool for a specific location. The agent computes active relational loads measuring exact occupancy metrics, providing workplace compliance data through natural conversation.

**When running the tool `list_visitors`, where is my sensitive visitor data stored?**
Your credentials never sit on disk. All keys pass through a zero-trust proxy while making calls, meaning they are only used in transit and immediately discarded for security.

**If I use the tool `reserve_desk` and it fails, what information does the agent give me?**
The agent provides a clear error message explaining exactly why the booking failed. It tells you if the desk is already reserved or if your requested time slot falls outside operational hours.

**If my company has multiple offices, how do I check all of them using `list_locations`?**
The agent runs `list_locations`, giving you a comprehensive list of every office managed in your account. You then select the specific location to run other tools like occupancy or booking checks.

**What details come with tracking packages using the tool `list_deliveries`?**
The tool returns detailed package information, including the current delivery status, expected pickup date, and records of any necessary receipts or front-desk approvals.

**How do I check what meeting rooms are available using the tool `list_rooms`?**
The agent calls `list_rooms`, providing a list of all bookable spaces. You can then filter that data to see only open time slots or specific capacity limits.