# Apptoto MCP

> Apptoto handles scheduling, contact records, and automated messaging for service businesses. It lets your AI agent book new appointments instantly, look up client details, track online booking availability, and manage opt-in/opt-out lists—all without you having to switch between apps.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** appointment-reminders, automated-messaging, scheduling-automation, client-communication, calendar-sync, booking-management

## Description

Managing a busy schedule means juggling calls, emails, and multiple systems just to keep the calendar straight. You need an agent that knows your clients and your openings before you even ask it. This MCP connects your AI client directly to Apptoto’s scheduling backbone. Instead of manually cross-referencing spreadsheets for contact info or logging into a separate booking portal, your agent does it all in context.

It lets you instantly check if a lead needs an appointment and then book it—all while confirming their email address. You can manage who gets reminders via SMS versus email, build out the next event, and even find old records on demand. Because this MCP lives within the Vinkius catalog, your agent has instant access to all Apptoto’s functions from one place. It simply reads what you need, builds the appointment, updates the client record, and sends the confirmation—all with natural conversation.

## Tools

### create_event
Builds an appointment on your calendar when prompted by the user.

### get_account_check
Verifies that your API connection to Apptoto is still working correctly.

### get_contact
Pulls all specific information for one named client, like their phone number or email.

### get_event
Retrieves the full details of a single appointment when you know its identifier.

### list_bookings
Shows all the online time slots that are currently available for booking.

### list_contacts
Retrieves a list of every client record stored in your Apptoto account.

### list_events
Provides an overview and full details for all existing appointments on the calendar.

### list_lists
Shows you which opt-in or opt-out messaging groups exist.

## Prompt Examples

**Prompt:** 
```
List all my appointments for today.
```

**Response:** 
```
I've retrieved your schedule for today. You have 4 appointments, including 'Consultation with John Smith' at 10:00 AM and 'Follow-up Call' at 2:00 PM.
```

**Prompt:** 
```
Find contact details for 'Jane Doe'.
```

**Response:** 
```
I've found Jane Doe in your contacts. Her phone number is (555) 123-4567 and her email is jane.doe@example.com.
```

**Prompt:** 
```
Create a new appointment 'Site Audit' for tomorrow at 9 AM.
```

**Response:** 
```
The appointment 'Site Audit' has been successfully created for tomorrow at 9:00 AM.
```

## Capabilities

### Manage appointments
Instantly creates new events on your calendar or pulls up details for any past or upcoming meeting.

### Look up client data
Searches your database to pull a person's full record, including phone numbers and email addresses.

### Check booking status
Lists all available online slots or checks if a specific time slot is open for new bookings.

### View your schedule history
Retrieves lists of all past and future appointments, giving you an overview of your workload.

### Control messaging lists
Manages your opt-in and opt-out groups for automated reminders via email or text message.

## Use Cases

### Need to book a new client and update their record.
A lead texts: 'I'm free next week.' Your agent first uses `list_bookings` to check availability, then uses `get_contact` to find the name, and finally runs `create_event`, completing the booking and updating your contact database in one flow.

### A client asks for their previous meeting details.
Instead of searching through emails or old notes, you just ask the agent to find the event. It uses `get_event` to pull up all the metadata instantly so you can talk about it with the client.

### You need a full list of every current and past meeting.
A quick request for 'my schedule' triggers the agent to use `list_events` and summarize everything, allowing you to see booking trends or identify gaps in your calendar.

### Your team is setting up a new service offering.
The manager asks the AI to check if they can send reminders for this new service. The agent uses `list_lists` to confirm which messaging groups are active and available for updates.

## Benefits

- You stop jumping between apps. Instead of opening your CRM to find a client's phone number and then switching to your calendar to book them, the agent handles both steps instantly using `get_contact` and `create_event`.
- Never miss a follow-up because you forgot to check availability. Use `list_bookings` to see real-time openings across your entire schedule right inside your chat workspace.
- Automated reminders are now simple. Instead of manually checking who is opted in, use the tools to manage lists and ensure every client gets the proper reminder via SMS or email.
- Getting an overview used to mean opening a dashboard. Now, you can run `list_events` to get all your appointments—past and future—in one readable summary without leaving your agent interface.
- It saves time on verification. You don't need to wonder if the connection is working; running the `get_account_check` tool instantly confirms everything is ready for action.

## How It Works

The bottom line is that your AI client coordinates all these tasks using a single natural language prompt.

1. Connect this MCP to your preferred AI client within Vinkius. You authenticate using Apptoto's secure API keys.
2. Tell your agent exactly what you need: 'Book a follow-up call with Sarah Smith for next Tuesday.'
3. The agent uses the available tools—first looking up Sarah’s contact details, then checking availability, and finally creating the event—and reports back the success or failure.

## Frequently Asked Questions

**How do I use `create_event` with this MCP?**
You simply tell your agent what to schedule, like 'Schedule a meeting next Tuesday.' The tool figures out the date and time necessary. It's always best practice to first check availability using `list_bookings` if you need to narrow down options.

**Does `get_contact` work for all clients?**
Yes, it looks up any client stored in your Apptoto records. Just give the agent a name or part of an email address, and it pulls the full record details for you.

**Can I check my account status with `get_account_check`?**
Absolutely. Running this tool confirms that your API connection is active and ready to go before you start making any bookings or changes, which saves time debugging later.

**What's the difference between `list_events` and `get_event`?**
`list_events` gives you a summary of many appointments (a list). Use `get_event` when you already know the specific ID or details of one single appointment you want to examine.

**When I call `list_bookings`, what details can I expect about online appointments?**
It returns a list of all recorded bookings. You'll get core details like the client name, service type, and scheduled date for every appointment managed through the platform.

**Does `list_contacts` provide all required client information, or just names?**
It provides a full directory of your contacts. This includes their name, phone number, and email address, letting you process bulk data for follow-ups.

**If I only have the event ID, how can I use `get_event` to retrieve all details?**
You must pass a valid event ID to `get_event`. This ensures your agent fetches all associated metadata for that specific appointment record.

**What information does `list_lists` provide regarding messaging compliance?**
It displays all your opt-in and opt-out lists. Accessing these statuses is critical to ensure you send automated SMS or email reminders compliantly.

**How do I find my Apptoto API Key?**
Log in to Apptoto, go to **Settings > API**, and you will find your API Key there. If you don't see it, contact Apptoto support.

**Can I create new appointments via the API?**
Yes, you can use the `create_event` tool to add new appointments to your Apptoto calendar. Provide the subject, start time, and end time.

**Does Apptoto support two-way messaging?**
Yes, Apptoto supports two-way SMS and email messaging. While this server focuses on event and contact management, the contacts you retrieve feed into your messaging workflows.