# AI Receptionist MCP MCP

> AI Receptionist MCP manages all customer interactions—from initial calls to confirmed appointments—allowing your agent to handle front-desk tasks 24/7. It automatically books meetings, tracks leads, and keeps detailed transcripts of every conversation so you never miss a booking inquiry or a crucial follow-up detail.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** aireceptionist, ai-voice-api, call-transcripts, automated-booking, lead-capture, knowledge-base-automation, front-desk-orchestration, conversational-ai, mcp

## Description

This connector lets your AI client take over the entire customer engagement process. Instead of hiring staff just to answer phones after hours, you connect this MCP and let it manage your front desk through natural conversations. It handles everything from initial inquiries to full appointment scheduling.

The system monitors all incoming voice or chat interactions, pulling out key details like pricing questions, lead information, and preferred dates. You don't have to listen back to call recordings anymore; the data is organized for you. Need to know how well your sales pitches are working? The MCP gives instant analytics on every interaction. All of this high-fidelity intelligence gets routed through Vinkius, giving your agent a single source of truth about who talked to whom and what they wanted. It's pure operational automation.

## Tools

### create_aireceptionist_booking
This function books a new appointment for you through the system.

### create_aireceptionist_conversation
This tool starts tracking a brand-new customer conversation thread.

### get_aireceptionist_analytics
It pulls performance data and usage statistics for all AI interactions.

### get_aireceptionist_booking
This retrieves the specific details for an existing appointment.

### get_aireceptionist_conversation
It fetches the full transcript and metadata for a single conversation ID.

### get_aireceptionist_me
This reports your current user profile information within the system.

### list_aireceptionist_bookings
It shows you a list of all active or upcoming appointments.

### list_aireceptionist_conversations
This retrieves a summary list of recent AI-handled conversations.

### list_aireceptionist_knowledge
It lists all the articles and rules stored in your organizational knowledge base.

### list_aireceptionist_webhooks
This shows you a list of active webhooks to monitor system events.

## Prompt Examples

**Prompt:** 
```
List the last 5 conversations handled by the AI Receptionist.
```

**Response:** 
```
I've retrieved your recent interactions. The last 5 conversations include 3 voice calls for 'Booking Inquiries' and 2 chat sessions. Would you like the detailed transcript for any of these?
```

**Prompt:** 
```
Show my active bookings for the next 7 days.
```

**Response:** 
```
Accessing booking directory... You have 8 appointments scheduled for the upcoming week, including 3 new leads and 5 follow-ups. Shall I retrieve the high-fidelity metadata for the Monday sessions?
```

**Prompt:** 
```
Get the transcript for conversation ID '9283'.
```

**Response:** 
```
Fetching transcript... Conversation 9283 was a 4-minute voice call where the customer inquired about pricing and confirmed a booking for Friday. I've retrieved the complete high-fidelity log for you. Need help with the analytics?
```

## Capabilities

### Schedule appointments
The MCP can check available slots and create new bookings directly into your calendar.

### Log and monitor conversations
It tracks every incoming chat or voice interaction, giving you complete transcripts and operational details.

### Access business rules
The system uses your existing knowledge base (FAQs, policies) to guide how the AI responds to clients.

### Track lead performance
You get real-time analytics on successful conversations and captured leads for quick reporting.

### Manage system connections
It verifies API connectivity and monitors webhooks to keep your communication pipeline running smoothly.

## Use Cases

### A sales team needs instant lead qualification.
The Sales Director asks the agent, 'What were the top three pricing questions from last week?' The agent uses `list_aireceptionist_conversations` and then analyzes the data using `get_aireceptionist_analytics`, giving the director a summary of common client objections.

### An Operations Manager needs to reschedule an executive.
The manager asks, 'I need to move the meeting with Acme Corp.' The agent first runs `get_aireceptionist_booking` to confirm details and then uses `create_aireceptionist_booking` to book a new slot automatically.

### A developer needs to debug communication errors.
The developer asks, 'Check the active webhooks for any failures.' The agent responds by listing them with `list_aireceptionist_webhooks`, allowing immediate debugging of the system's communication flow.

## Benefits

- Stop manually checking call logs. Use `get_aireceptionist_conversation` to instantly retrieve complete, high-fidelity transcripts for any past interaction.
- Keep your calendar perfectly synced. You can use `list_aireceptionist_bookings` and then `create_aireceptionist_booking` all in one chat session to manage availability.
- Never guess how a client feels. Run the system's analytics via `get_aireceptionist_analytics` to get immediate insights into lead capture rates and performance metrics.
- Maintain consistency across your team. By accessing and monitoring your knowledge base using `list_aireceptionist_knowledge`, you ensure the AI always follows company policy.
- Build reliable integrations. The MCP lets you monitor active webhooks by listing them with `list_aireceptionist_webhooks` to guarantee continuous communication.

## How It Works

The bottom line is that you pass credentials once and gain full control over automated front-desk operations via natural language commands.

1. Subscribe to the AI Receptionist MCP.
2. Retrieve your dedicated API Key from your AI Receptionist dashboard developer settings.
3. Use your agent through any MCP-compatible client to begin orchestrating tasks, like listing conversations or creating bookings.

## Frequently Asked Questions

**How do I check my current user profile using get_aireceptionist_me?**
You run `get_aireceptionist_me` to retrieve your account's basic details. This confirms that the connection is valid and gives you immediate context about who is making the requests through the MCP.

**What does list_aireceptionist_analytics show me?**
This tool provides performance metrics on all AI interactions. You get reports on lead capture success rates, call volume, and interaction types to gauge overall business health.

**Can I use create_aireceptionist_conversation for a chat? **
Yes. `create_aireceptionist_conversation` starts tracking any new communication thread, whether it's from a voice call or an instant message, ensuring nothing slips through the cracks.

**Which tool should I use to see upcoming meetings? **
Use `list_aireceptionist_bookings` for a list of all active and scheduled appointments. If you need details on one specific meeting, run `get_aireceptionist_booking`.

**When I use list_aireceptionist_knowledge, how does it help my AI client answer questions?**
It provides access to your centralized knowledge base articles and business rules. Your agent references this data pool to ensure all conversations adhere to your official company policies.

**If I need external systems (like a CRM) updated after an interaction, how do I use list_aireceptionist_webhooks?**
You monitor and verify active webhooks using this tool. This ensures that when a key event happens—like a confirmed booking—the data automatically triggers actions in your other applications.

**What should I do if get_aireceptionist_booking fails because the ID is wrong?**
The API returns a specific error code, confirming that the booking record doesn't exist. Your agent can then detect this failure and prompt the user for correct information.

**Does create_aireceptionist_booking have usage limits or rate limiting?**
Yes, the system enforces rate limits on creation calls. If you exceed them, your client will receive an HTTP 429 error code. You'll need to implement a retry mechanism in your workflow.