# Liaison MCP

> Liaison connects your AI client to WebAdMIT so you can pull applicant data, check enrollment statuses, and review admission batches without opening the dashboard. It gives admissions officers and data teams direct access to application records, program details, and custom fields for faster decision making during peak enrollment cycles.

## Overview
- **Category:** human-resources
- **Price:** Free
- **Tags:** admissions-management, student-applications, enrollment-management, applicant-tracking, higher-education, batch-processing

## Description

Liaison gives your AI client direct access to your WebAdMIT admissions database. Instead of clicking through tabs to find a specific applicant or check batch progress, you just ask your agent. It pulls the exact application record, reads the current status, and returns the details you need. Admissions cycles are chaotic. You need to track thousands of applicants, verify document uploads, and monitor batch processing. This MCP handles the heavy lifting of querying the database. You can ask for a summary of all pending applications or drill down into a specific student file. It reads custom fields and program designations so you can filter by exact criteria. When you connect this through the Vinkius catalog, your AI agent bridges the gap between your raw enrollment data and your daily workflow. You stop acting as a manual router between spreadsheets and the WebAdMIT interface. You just ask for the data, and the agent fetches it in seconds. This keeps your team focused on evaluating candidates rather than hunting for their files. You get immediate visibility into your pipeline without waiting for IT to build custom reports.

## Tools

### check_liaison_status
Pings the WebAdMIT API to confirm your connection is active and credentials are valid.

### get_application
Pulls the full record for a specific applicant, including their status and test scores.

### get_batch
Returns the details and current processing status of a specific application batch.

### get_export
Fetches the metadata and status for a specific data export job.

### get_program
Retrieves the details and applicant counts for a single academic program.

### list_applications
Returns a list of all applications in the system, which you can filter by status.

### list_batches
Shows all application batches currently in the system for processing.

### list_custom_fields
Lists all the custom data fields configured in your WebAdMIT instance.

### list_designations
Returns the application designations and tags used to categorize students.

### list_exports
Shows all data export jobs, including their creation dates and completion status.

### list_programs
Lists every academic program in your database along with their basic details.

## Prompt Examples

**Prompt:** 
```
List all pending applications.
```

**Response:** 
```
You have 342 applications: 128 under review, 89 pending documents, 78 complete, 47 awaiting decision.
```

**Prompt:** 
```
Show details for application app_2891.
```

**Response:** 
```
Application app_2891: Jane Doe, Applied to 'MBA Program', submitted 2024-03-15, status: Under Review. GPA: 3.8, GMAT: 720.
```

**Prompt:** 
```
List all academic programs.
```

**Response:** 
```
8 programs: MBA (234 applicants), MS Computer Science (189), MS Data Science (156), JD Law (98).
```

## Capabilities

### Pull applicant records
Fetch complete details for any specific student application on demand.

### Track batch progress
Check the status and contents of application processing batches.

### Query enrollment data
List all applications to see exactly how many are pending, under review, or complete.

### Browse academic programs
Get details on specific degree programs and their applicant counts.

### Review data exports
Check the status of large data exports and pull the details when they finish.

### Map custom fields
Read your specific database designations and custom field definitions to understand the data structure.

## Use Cases

### The morning pipeline check
An admissions director asks their agent for a status update. The agent runs list_applications and returns a breakdown of the 400 pending files, highlighting the 50 missing transcripts.

### The live phone call
An enrollment officer is on the phone with a prospective MBA student. They ask the agent to run get_application for that specific ID, instantly reading back the applicant's GMAT score and submission date.

### The nightly sync verification
A data engineer needs to confirm the batch job finished. They tell the agent to use list_batches to find the latest run, then get_batch to verify the record count matches the source system.

### The program capacity review
A department head wants to know which degrees are over-enrolled. The agent runs list_programs to pull all active degrees, then uses get_program to check the exact applicant count for the Data Science track.

## Benefits

- You stop clicking through WebAdMIT tabs to find a student. Your agent uses get_application to pull the exact file, GPA, and status in seconds.
- You know exactly where your data exports stand. Instead of guessing, you use list_exports and get_export to check if the nightly sync actually finished.
- You track application batches in real time. list_batches and get_batch let your agent report exactly how many files are stuck in processing.
- You understand your database schema without asking IT. list_custom_fields and list_designations give your agent the context it needs to filter data correctly.
- You get a live count of your admissions pipeline. list_applications feeds your agent the exact numbers for pending, review, and accepted students.

## How It Works

The bottom line is you stop logging into the WebAdMIT dashboard to run basic queries and just ask your agent for the data.

1. Connect your AI client to the Liaison MCP and authenticate your WebAdMIT credentials.
2. Ask your agent to pull application lists, check batch statuses, or fetch specific student records.
3. Read the structured applicant data your agent returns directly in your chat window.

## Frequently Asked Questions

**Does the Liaison MCP let me update applicant statuses?**
No, it is a read-only integration. You can use tools like get_application to pull records and list_applications to check statuses, but you cannot modify the data in WebAdMIT through this connection.

**How do I check if my WebAdMIT data export finished using the Liaison MCP?**
Ask your agent to run list_exports to see all jobs, then use get_export with the specific export ID to check its exact completion status and metadata.

**Can the Liaison MCP show me custom fields I created in WebAdMIT?**
Yes. Your agent can run list_custom_fields to see every custom column configured in your instance, and list_designations to view your application tags.

**How do I track application batches with the Liaison MCP?**
Tell your agent to use list_batches to see all active processing queues, then use get_batch to pull the details and record counts for a specific batch.

**Will the Liaison MCP slow down if I have thousands of records?**
No, it queries the WebAdMIT API directly. If you need a large dataset, use list_applications with status filters rather than pulling the entire unfiltered database at once.

**How do I know if my AI client is actually connected to the Liaison MCP?**
Use the `check_liaison_status` tool to verify the connection. It pings the WebAdMIT API and returns a success message if your credentials are valid and the connection is live.

**Can the Liaison MCP pull details about specific academic programs?**
Yes. Use `list_programs` to see all available degrees and applicant counts, then call `get_program` with a specific ID to drill into individual program metrics.

**How do I find out what designations are available in the Liaison MCP?**
Run `list_designations` to see them. This pulls all configured tags from your WebAdMIT account so you can filter applications or organize your enrollment data.

**Can my AI browse admissions applications?**
Yes. `list_applications` returns all applications and `get_application` shows full details for any one.

**Can I access data exports?**
Yes. `list_exports` and `get_export` let you find and download configured data exports.

**How do I view academic programs?**
`list_programs` shows all programs and `get_program` returns full details including requirements.