# Mainstay (AdmitHub) MCP

> Mainstay (AdmitHub) connects your AI agent directly to your institutional student success data. Manage contact lists, audit engagement campaigns, and analyze behavioral intelligence from chat logs—all through natural conversation. It gives you a single pane of glass for managing the entire student lifecycle.

## Overview
- **Category:** customer-engagement
- **Price:** Free
- **Tags:** student-records, campaign-management, behavioral-analytics, chatbot-logs, student-success

## Description

This MCP lets you manage student records, campaign performance, and communication history without leaving your AI client. Instead of jumping between separate CRM dashboards to check on students or audit outreach efforts, your agent handles it all in one conversation. You can ask it to pull a list of contacts who haven't engaged with recent campaigns or review message logs to see what questions prospective students are asking right now. The system also keeps track of custom metadata fields, letting you segment and personalize interactions across different channels easily. Connecting this MCP via Vinkius makes sure that regardless of which AI client you use, your agent always has access to the same full scope of student success workflows.

## Tools

### list_contacts
Gathers a list of all student contacts in your Mainstay system.

### get_contact_details
Pulls the complete profile and specific details for one individual student contact.

### list_campaigns
Provides a list of all current and past engagement campaigns run by your institution.

### list_messages
Retrieves the message logs, showing conversations between students and your AI chatbot.

### list_custom_fields
Lists all available custom metadata fields you use to segment or personalize student interactions.

## Prompt Examples

**Prompt:** 
```
Search for a student contact with the name 'Jane Smith'.
```

**Response:** 
```
I've found one student matching 'Jane Smith'. She is currently active in the 'First-Year Orientation' campaign and has replied to 3 nudges this week. Would you like to see her full profile details?
```

**Prompt:** 
```
List all active engagement campaigns.
```

**Response:** 
```
I've retrieved your active campaigns. You have 4 live initiatives, including 'Financial Aid Reminders' and 'Campus Housing Nudges'. Would you like to check the message logs for any of them?
```

**Prompt:** 
```
Show me the last 10 messages from today.
```

**Response:** 
```
I've retrieved the latest 10 messages. They show active inquiries about registration deadlines and scholarship applications. The AI bot successfully resolved 8 out of 10 requests. Would you like to see the transcripts?
```

## Capabilities

### Manage Student Records
List and retrieve specific details for any student contact in your system.

### Review Engagement Campaigns
Check the status of active or past outreach campaigns and their scheduled nudges.

### Audit Communication Logs
Pull detailed logs of every conversational exchange between students and your chatbot.

### Personalize Data Fields
View and manage the custom metadata used to segment student groups for targeted messaging.

## Use Cases

### Finding At-Risk Students
A student success officer needs to know which students haven't logged into the portal since orientation. They ask their agent to cross-reference `list_contacts` with behavioral data, immediately identifying a high-priority list for outreach.

### Reviewing Chatbot Performance
An admissions director wants to know if the bot is handling scholarship questions correctly. They use the MCP to `list_messages`, reviewing transcripts and confirming that 9 out of 10 inquiries were resolved successfully.

### Auditing Campaign Scope
An enrollment manager needs confirmation that all scheduled nudges for a new program are set up. They use the MCP to `list_campaigns` and verify both active initiatives and their metadata.

### Preparing Targeted Communications
A researcher wants to run an analysis on students who failed to open emails related to housing. The agent uses `list_custom_fields` and then pulls specific contact records using `get_contact_details` for the cohort.

## Benefits

- Stop manually compiling student lists. You can use the `list_contacts` tool to get a quick roster of every student contact, letting you immediately focus on who needs attention.
- Audit outreach effectiveness by running `list_campaigns`. This lets you quickly see if your recent 'Financial Aid Reminders' initiative is active and what its status is.
- Understand why students are struggling. By retrieving message logs using `list_messages`, you get a direct transcript of student conversations, identifying the exact questions they need answers to.
- Personalize every outreach effort. The ability to list custom metadata fields means your agent knows exactly how to segment and talk to different groups of potential students.
- Get full context on any single student using `get_contact_details`. You don't just get a name; you get their entire profile, history, and status in one place.

## How It Works

The bottom line is: you talk to your AI client normally; it handles the complex querying of student records and campaign metadata for you.

1. Subscribe to this MCP in Vinkius and enter your Mainstay API Token.
2. Reference the connection within your AI client, telling it exactly what data you need (e.g., 'Show me all contacts in Campaign X').
3. Your agent executes the request, retrieving structured data like contact profiles or message histories directly into the chat.

## Frequently Asked Questions

**How does Mainstay (AdmitHub) MCP handle large lists of students?**
It manages large lists by allowing your agent to pull and filter contacts using the `list_contacts` tool. You can narrow down groups based on specific criteria, like campaign enrollment or custom fields.

**Can Mainstay (AdmitHub) MCP tell me if a student is engaged?**
Yes. Your agent reviews the message logs via `list_messages` to see recent conversational activity. It also checks your campaign status using `list_campaigns` to gauge current involvement.

**What kind of data can I retrieve with Mainstay (AdmitHub) MCP?**
You can pull contact details, full message transcripts, metadata fields used for segmentation, and active campaign statuses. It covers the entire student lifecycle record.

**Is this MCP useful for admissions teams?**
Absolutely. Admissions teams use it to audit prospective student inquiries through `list_messages` and track how well their recruitment campaigns are performing using `list_campaigns`.