# Picktime MCP for AI Agents AI Agent Connect > Picktime MCP lets your AI agent manage your entire appointment scheduling system. It handles multi-location booking details, staff rosters, and live availability. It turns your complex scheduling backend into a simple chat interface for faster admin work. ## Overview - **Category:** productivity - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_B2cfN2FyqDzRd8EC9zAz6rlG0BGuPYQNLcMcVOSq/ai-agent-connect - **Tags:** appointment-booking, class-reservations, staff-management, availability-tracking, scheduling ## Description This Connector connects your Picktime organization to your AI client so you can manage appointments without jumping through browser tabs. Instead of digging through a dashboard to see if a stylist is free or which clinic has open slots, you just ask your agent. It handles the heavy lifting of checking staff schedules, listing available services, and pulling up specific customer booking notes. You'll find that handling high-volume requests becomes a conversation rather than a series of clicks. Because Vinkius manages the connection, you can plug this into your existing workflow and let your agent act as a dedicated booking coordinator. It's about moving from searching for data to getting answers instantly. ## Tools ### get_location See specific details like addresses, timezones, and booking URLs for one branch. This helps resolve workspace boundaries. ### list_services See every bookable service, including prices, durations, and staff assignments. This defines what customers can book. ### get_service_details Pull specific rules for a service, like cancellation policies and booking limits. Use this for deep configuration audits. ### list_staff See everyone on the team, their roles, and their active working hours. This helps determine bookable time slots. ### get_booking_details View the full history and notes for a specific customer appointment. Use this to get contact info and payment status. ### cancel_booking Remove a reservation and notify the customer of the cancellation. This immediately returns the slot to the public pool. ### list_classes View all multi-attendee sessions like yoga or workshops with capacity limits. This handles group reservations. ### get_availability Find open time slots for a specific service on a chosen date. This accounts for staff schedules and existing bookings. ### list_locations Get a list of all business branches and their unique configurations. Use this to see every location in your organization. ### list_bookings Pull a list of all reservations with customer names and payment statuses. This is essential for daily schedule management. ## Prompt Examples **Prompt:** ``` Who is available for a hair cut this Friday between 10:00 AM and 2:00 PM? ``` **Response:** ``` I've checked the schedule for Friday. Here are the available stylists for 'Hair Styling' during that window: | Stylist | Available Slots | | :--- | :--- | | **Sarah J.** | 10:00 AM, 11:30 AM | | **Mike D.** | 1:00 PM, 1:45 PM | Would you like me to pull up the booking page for one of them? ``` **Prompt:** ``` List all the bookings for the downtown branch today. ``` **Response:** ``` Here are the reservations for the **Downtown Branch** today: * **10:00 AM**: Elena Rodriguez (Hair Coloring) * **11:30 AM**: Marcus Thorne (Beard Trim) * **1:00 PM**: Sarah Jenkins (Full Highlights) * **2:30 PM**: David Chen (Scalp Treatment) All payments for these sessions are marked as **Paid**. ``` **Prompt:** ``` What's the cancellation policy for the yoga workshop? ``` **Response:** ``` The **Yoga Workshop** has the following booking rules: * **Cancellation Policy**: 24-hour notice required for a full refund. * **Capacity**: 12 attendees maximum. * **Duration**: 90 minutes. * **Staff**: Led by Instructor Chloe. ``` ## Capabilities ### Check live availability Find open time slots for specific services on any given date. ### Pull customer booking info Get full details on specific reservations, including notes and payment status. ### List all staff members See everyone on your team, their roles, and their active working hours. ### Cancel reservations Remove a booking and automatically notify the customer to free up the slot. ### View multi-location details See addresses, timezones, and booking URLs for all your business branches. ### Manage group classes View all multi-attendee sessions like yoga or workshops with capacity limits. ## Use Cases ### Checking real-time stylist availability A receptionist needs to know if a stylist is free for a specific time. They ask the agent to check availability for 'Hair Styling' next Monday, and get a list of open slots instantly. ### Generating daily morning briefings A clinic director wants to see the day's load. They ask the agent to list all reservations for today, getting a bulleted list of customers and services to share with the team. ### Handling last-minute cancellations A client calls to drop an appointment. The staff member tells the agent to cancel the specific booking ID, which notifies the client and opens the slot for others. ### Auditing multi-location service menus A manager wants to ensure all branches have the same price list. They ask the agent to list all services across all locations to compare durations and costs. ## Benefits - Stop clicking through multiple tabs by using list_locations to see all your branches in one go. - Get instant answers on staff schedules using list_staff to avoid double-booking. - Handle cancellations faster with cancel_booking to free up slots for new customers immediately. - Pull full customer histories using get_booking_details to provide better service during calls. - Quickly find open spots with get_availability to book clients faster without manual checking. - Organize group sessions easily by using list_classes to manage workshop capacities. ## How It Works The bottom line is you get a chat-based interface for your entire Picktime booking backend. 1. Subscribe to the Picktime MCP on Vinkius. 2. Enter your Enterprise Picktime API Key in the configuration. 3. Ask your AI client to check availability or list bookings. ## Frequently Asked Questions **Can the Picktime MCP help me manage multiple clinic locations?** Yes, it can list all your business branches and pull specific details like addresses and timezones for each one. **How does the Picktime MCP handle staff schedules?** It pulls the active status, roles, and working hours for all your staff members so your agent can check availability. **Can I use the Picktime MCP to see if a specific service is available?** Yes, it checks for open time slots on specific dates while accounting for staff schedules and existing bookings. **Will the Picktime MCP notify my customers if I cancel a booking?** Yes, when you cancel a reservation through the agent, it sends a notification to the customer and frees up the slot. **Can I use the Picktime MCP to see my group class capacities?** Yes, it can list all your group classes, such as yoga or workshops, along with their specific attendee limits. **Can I use the Picktime MCP to see detailed customer notes?** Yes, you can ask your agent to pull up the full details of a specific booking, including any notes left by the customer. **Can the AI find an available slot for a specific service next Friday?** Yes. Upon providing the location and service ID along with the desired date, your agent invokes `get_availability`. The connector reads Picktime's master block array, isolating the open time windows seamlessly against existing rules (like business hours and buffers). **If a customer cancels on the phone, can the AI remove their booking?** Absolutely. Just provide the booking ID to the agent and it will utilize the `cancel_booking` function. Picktime will release the blocked slot immediately back to the customer-facing booking page. **Can I grab all upcoming appointments for a specific staff member?** Yes, by matching the staff member's ID from `list_staff` with the broader fetch generated by `list_bookings`. Alternatively, your agent can sort and filter the returned array natively in its reasoning stream, showing you only Dr. Silva's schedule.