# Bureau24 MCP

> Bureau24 MCP connects your virtual receptionist service directly to your AI client. It gives you one conversational way to manage incoming calls, update availability, check call logs, and oversee customer messages without logging into a separate portal. Stop missing business leads because you were in a meeting; your agent handles the coordination instantly.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** virtual-receptionist, call-routing, call-logging, business-telephony, customer-service, inbound-calls

## Description

Your virtual secretary answers calls 24/7. This MCP lets your AI client coordinate every interaction—from initial contact to final follow-up—using natural conversation. Need to know why John Doe called yesterday? Your agent pulls up the full call log and notes immediately. You can check if a message came through, adjust your status for meetings, or even add a new contact so the secretary knows exactly who you are talking to. It keeps all of that coordination in one place. Connect this MCP via Vinkius to any compatible client like Claude or Cursor, and treat your virtual receptionist as just another tool at your fingertips.

## Tools

### create_contact
Adds a new person or company to your dedicated address book.

### get_call
Retrieves specific, detailed information about one particular call event.

### get_me
Fetches high-level details about your account and current subscription level.

### get_message
Gets the full text and context of one specific notification from the service.

### get_secretary_status
Checks what your current virtual status is set to (e.g., Available or Away).

### list_calls
Retrieves a list of all calls that the service has handled recently.

### list_contacts
Shows you every contact saved in your address book right now.

### list_instructions
Lists all the current guidelines that tell the secretary how to process calls.

### list_messages
Gets a summarized list of recent messages and notifications from your virtual secretary.

### update_secretary_status
Changes your availability status (like 'In a Meeting') and adds a note for the next caller to read.

## Prompt Examples

**Prompt:** 
```
List all recent calls handled by my virtual secretary.
```

**Response:** 
```
I've retrieved your call log. You had 3 recent calls: 'John Miller' (Inquiry about pricing), 'Unknown Caller' (Spam), and 'Linda Smith' (Meeting request). Which one would you like to read the full notes for?
```

**Prompt:** 
```
Set my status to 'busy' and tell the secretary I am in a workshop until 2 PM.
```

**Response:** 
```
Status updated! I've set your availability to 'busy' in Bureau24 and added the note for the secretary: 'In a workshop until 2 PM'. Callers will be notified accordingly.
```

**Prompt:** 
```
Show me the latest message from the Bureau24 service.
```

**Response:** 
```
Fetching messages... Your latest notification (ID: msg_10293) is a summary of today's morning activity: 2 successfully handled calls and 1 urgent callback request from 'Tech Solutions'. Would you like the callback details?
```

## Capabilities

### Review Call Logs
Retrieves a list of all calls handled by the service, including details for specific conversations.

### Manage Availability Status
Changes your professional status (Available, Busy, Away) and leaves real-time instructions for the secretary to follow with callers.

### Check Communications
Retrieves recent notifications or messages sent by the virtual service regarding your business activity.

### Maintain Address Book
Adds new contacts to your directory or lists existing ones so the secretary can identify regular callers immediately.

### Verify Operational Rules
Queries standing instructions and account metadata, letting you verify how calls are currently being processed.

## Use Cases

### The Sales Rep who missed a follow-up detail
A rep needs details on a client call from last week. Instead of logging into the web portal, they ask their agent to use `get_call` and instantly pull up the full notes and participant info for review.

### The Manager who is out sick
A manager needs to set boundaries while away. They instruct their agent to run `update_secretary_status`, setting it to 'On Vacation' and providing specific instructions on which emergency contacts should be called.

### The Startup Founder with a new client
A founder gets a potential lead. They use the agent to run `create_contact` immediately, ensuring all details are logged in the system for future reference and quick retrieval via `list_contacts`.

### The Ops Engineer checking service health
An engineer needs to verify if their current subscription is correct. They prompt their agent to run `get_me`, confirming account metadata and access rights without needing to navigate through billing pages.

## Benefits

- Never manually check a dashboard again. By using the `list_calls` tool, you get an immediate summary of all recent interactions without leaving your workflow.
- Stop forgetting to update your status. A simple prompt can use `update_secretary_status` to tell the secretary you're unavailable and provide specific instructions for callers.
- Building out client relationships gets easier because when you need to track a connection, you just run `list_contacts` or `create_contact` directly through your agent.
- You always know what’s going on. If there's an urgent issue, use the `list_messages` tool to pull up all notifications sent by the service instantly.
- Stay compliant and informed about how things run. Use `list_instructions` to quickly verify that call processing guidelines haven't changed.

## How It Works

The bottom line is that you control your entire virtual office workflow through simple commands in one place.

1. Subscribe to this MCP and input your Bureau24 API Key in the Vinkius dashboard.
2. Tell your agent what you need—for instance, 'Show me all calls from last week' or 'Update my status to Busy.'
3. Your AI client executes the request against the service and returns structured data directly into the chat interface.

## Frequently Asked Questions

**How do I check my call history using the list_calls tool?**
You prompt your agent to use `list_calls`. It retrieves a summary of all recent calls handled by the service, allowing you to see who called and when.

**Can I update my secretary status with the update_secretary_status tool?**
Yes. You tell your agent what status you want (like 'In a Meeting') and provide any necessary notes for the virtual receptionist to follow.

**Do I need to use list_contacts before creating a contact?**
No. While `list_contacts` shows existing records, using `create_contact` is a standalone action that adds new names and numbers directly to your address book.

**What does the get_me tool tell me about my account?**
The `get_me` tool fetches core information about your Bureau24 account, including details on your current subscription and profile metadata.

**If I use the get_call tool, what specific details do I retrieve for an individual call?**
You get a detailed breakdown of that single interaction. This includes full notes from the secretary, names of all participants involved in the call, and the primary reason for the call.

**How can I check if there are unread or pending messages using the list_messages tool?**
The tool pulls a chronological feed of all communications from the service. You'll see message IDs, send dates, and a summary that lets you quickly spot any urgent notifications needing attention.

**What does the list_instructions tool show about my virtual secretary’s handling rules?**
This lists your standing instructions. It tells you exactly how the virtual team processes calls, what policies are in place for missed connections, and any specific routing rules you've set up.

**How do I check the current operational status using get_secretary_status?**
This tool confirms if the service itself is currently marked as Available, Busy, or Away. It’s useful for troubleshooting to ensure your virtual receptionist can take incoming calls right now.

**Can I update my availability status via AI for the secretary?**
Yes! Use the `update_secretary_status` action. You can provide a new status (like 'busy') and an optional note to tell the secretary exactly what to say to callers.

**How do I see the notes from the last call handled by Bureau24?**
Run the `list_calls` query to find the recent interactions. You can then use `get_call` with the specific Call ID to retrieve all notes and details from the receptionist.

**Is it possible to add a regular customer to my address book via AI?**
Absolutely. Use the `create_contact` tool. Provide the customer's name, phone number, and optional email to help the virtual secretary identify them in future calls.