home / mcp / csg portal mcp server
Provides secure access to the CSG Veracross portal, including directory search, calendar events, and lunch volunteer info via MCP clients.
Configuration
View docs{
"mcpServers": {
"bradgriffith-csg-portal-mcp": {
"command": "npx",
"args": [
"@bradgriffith/csg-portal-mcp@latest"
],
"env": {
"MONGODB_URI": "mongodb://localhost:27017",
"VERACROSS_BASE_URL": "https://portals.veracross.com/csg",
"LS_LUNCH_SIGNUP_URL": "https://www.signupgenius.com/go/10C084BADAA2BA2FFC43-57722061-lslunch#/",
"ENCRYPTION_MASTER_KEY": "your-secure-encryption-key-here"
}
}
}
}You can use this MCP server to securely access CSG Veracross portal features such as directory search, calendar events, and lunch volunteer information from Claude Desktop and other MCP-compatible assistants. It authenticates via a secure browser flow, keeps data isolated per user, and caches results to improve performance.
Authenticate once with your Veracross account to enable all features. After authentication, you can ask for directory lookups, upcoming events, and volunteer slots using natural prompts. You can also set a default user to avoid providing your email with every request.
Prerequisites: Node.js and npm installed on your machine.
npm install -g @bradgriffith/csg-portal-mcpAdd the MCP configuration to Claude Desktop so it can launch the server as an MCP source.
{
"mcpServers": {
"csg-portal": {
"command": "npx",
"args": ["@bradgriffith/csg-portal-mcp@latest"]
}
}
}Restart Claude Desktop after adding the MCP source.
# Quick start without installation
{
"mcpServers": {
"csg-portal": {
"command": "npx",
"args": ["@bradgriffith/csg-portal-mcp@latest"]
}
}
}Security and data handling are designed to protect your Veracross credentials. Authentication happens in a secure browser flow; no credentials are stored in Claude. Credentials are encrypted and user data is isolated by email.
CSG grade terminology is supported by the server so you can refer to Forms I–XII and the Lower, Middle, and Upper School divisions in prompts.
If you encounter issues, verify authentication status, ensure you have portal access, and refresh results if necessary.
Developer notes: environment variables and local setup are described in the Developer Setup section to help you run a local instance or customize the deployment.
No credential storage in Claude. All credentials are encrypted and sessions are stored securely. Each user’s data remains isolated to prevent cross-user access.
The server understands Columbus School for Girls forms: PYC, Lower School Forms I–V, Middle School Forms VI–VIII, and Upper School Forms IX–XII.
If you see authentication or calendar lookup errors, re-authenticate via the secure browser flow and check your portal access. Use the refresh option to bypass cache if calendar results seem out of date.
Note: This section is for developers who want to modify or contribute to the MCP server.
Required environment variables are defined for production use and encryption: MongoDB connection, encryption key, and Veracross base URL. Optional values include SignUpGenius URLs for lunch signups.
Log in to the Veracross portal through a secure browser flow; no credentials are stored in Claude.
Query the school directory for students, parents, and staff with optional filters such as firstName, lastName, city, postalCode, and gradeLevel.
Fetch upcoming school events within a specified number of months; supports default 3 months with an auto-fallback to 12 months.
Check Lower School lunch volunteer opportunities; shows only days with open slots and supports date/week filtering.
Set a default user email to avoid repeatedly providing it in prompts.
Verify if a valid stored authentication session exists.