You have a Slate MCP Server that connects Technolutions Slate with Claude to query and analyze student enrollment demographics data through natural language. Use it to retrieve demographic summaries, track enrollment funnels, compare across years, and run targeted queries against Slate data fields.

How to use

Launch and connect your client to the server using the MCP interface you normally rely on, then start asking natural language questions about enrollment data. You can request comprehensive demographics for a specific incoming class, pull diversity metrics, view enrollment funnel counts, or compare year-over-year trends. Use the available tools to shape precise queries such as filtering by entry year, entry term, or status, and receive structured results suitable for reporting.

How to install

# Prerequisites
Node.js 18.0.0 or higher
Access to a Technolutions Slate instance with API credentials

# Clone the server repository
git clone https://github.com/your-org/slate-mcp-server.git
cd slate-mcp-server

# Install dependencies
npm install

# Build the project
npm run build

Start in development mode (if applicable)

npm run dev "}]} ,{

## Configuration

Configure the server to connect to your Slate instance and your Claude desktop. Set up the environment variables as shown in the example below. This section includes the required Slate credentials and how to wire the server into Claude Desktop so you can issue natural language prompts.

## Environment variables

SLATE_BASE_URL=https://yourschool.technolutions.net SLATE_USERNAME=your_username SLATE_PASSWORD=your_password SLATE_API_KEY=YOUR_API_KEY # optional, if your instance uses key-based auth

```json
{
  "mcpServers": {
    "slate": {
      "command": "node",
      "args": ["/path/to/slate-mcp-server/dist/index.js"],
      "env": {
        "SLATE_BASE_URL": "https://yourschool.technolutions.net",
        "SLATE_USERNAME": "your_username",
        "SLATE_PASSWORD": "your_password"
      }
    }
  }
}

Note: ensure the path in args points to the built MCP server entry file on your system."}]} ,{

## Slate configuration

Configure the necessary Slate queries to support the MCP server. You will typically set up the following queries in Slate to return the required fields and enable the tools to fetch the right data.

## Required Slate queries

- enrollment\_demographics: Returns enrolled student data with demographics (fields: id, first\_name, last\_name, email, gender, ethnicity, race, citizenship, first\_generation, state, country, intended\_major, entry\_year, entry\_term, enrollment\_status)
- enrollment\_funnel: Returns funnel counts (fields: prospects, inquiries, applicants, admitted, deposited, enrolled)
- students\_by\_status: Returns students filtered by application status (same required fields as enrollment\_demographics)
## Query parameters

The server passes these parameters to your Slate queries: entry\_year, entry\_term, application\_status.

## Available Tools

The MCP server exposes a set of tools you can call to get structured information from Slate data.

## Tools and usage guidelines

- get\_enrollment\_demographics: Get a comprehensive demographics summary for enrolled students. Parameters: entry\_year (required), entry\_term (optional: defaults to Fall). Example: Show demographics for Fall 2024.

- get\_diversity\_metrics: Get detailed diversity metrics including diversity index and URM percentages. Parameters: entry\_year (required), entry\_term (optional). Example: What are the diversity metrics for our 2024 freshman class?

- get\_enrollment\_funnel: Get enrollment funnel data with conversion rates. Parameters: entry\_year (required), entry\_term (optional). Example: Show the enrollment funnel and yield rates for Fall 2024.

- compare\_enrollment\_years: Compare demographics across multiple years. Parameters: years (required) as an array, entry\_term (optional). Example: Compare enrollment demographics from 2022 to 2024.

- get\_demographics\_report: Generate a formatted, readable demographics report. Parameters: entry\_year (required), entry\_term (optional). Example: Generate a demographics report for Fall 2024.

- get\_demographics\_by\_category: Get enrollment breakdown by a specific category. Parameters: entry\_year (required), category (one of gender, ethnicity, state, country, admit\_type, major, college, first\_generation, international), entry\_term (optional). Example: Show me enrollment by state for Fall 2024.

- search\_students: Search for students matching criteria. Parameters: entry\_year (optional), entry\_term (optional), state, country, major, first\_generation, international, limit. Example: Find all first-generation students from California in Fall 2024.

## Example conversations

User: What does our incoming Fall 2024 class look like demographically? Claude: I’ll pull the enrollment demographics for Fall 2024... Here’s a summary of your Fall 2024 incoming class: total enrolled, gender distribution, first generation, international status, and more.

User: How has our diversity changed over the past 3 years? Claude: I’ll compare the demographics across 2022, 2023, and 2024. Here’s the year-over-year comparison for key metrics like First Generation, International, and URM.

## Development

To run or test locally, execute the development workflow: npm run dev, npm run typecheck, npm run lint, and npm run build. This ensures type safety, code quality, and a production-ready build.

## Security considerations

- Never commit .env files containing credentials. - Use read-only API credentials when possible. - The server anonymizes personally identifiable information in search results. - Consider implementing rate limiting for production use.

## License

MIT

## Support

For issues with this MCP server, please open a GitHub issue. For Slate-specific questions, contact Technolutions Support.

## Available tools

### get\_enrollment\_demographics

Returns a comprehensive demographics summary for enrolled students for a given year and term. Includes fields such as id, first\_name, last\_name, email, gender, ethnicity, race, citizenship, first\_generation, state, country, intended\_major, entry\_year, entry\_term, and enrollment\_status.

### get\_diversity\_metrics

Provides detailed diversity metrics for a given year and term, including diversity index and URM percentages.

### get\_enrollment\_funnel

Retrieves the enrollment funnel data with counts for prospects, inquiries, applicants, admitted, deposited, and enrolled.

### compare\_enrollment\_years

Compares demographics across multiple years and returns a year-over-year view of key metrics.

### get\_demographics\_report

Generates a formatted, readable demographics report for a specific year and term.

### get\_demographics\_by\_category

Returns enrollment breakdown by a chosen category such as gender, ethnicity, state, country, admit\_type, major, college, first\_generation, or international.

### search\_students

Searches for students matching criteria such as year, term, state, country, major, first\_generation, international, and limits results.