Populi API v2 for student information systems: search the API, read data, optionally write
Connect Runs on your machine
claude mcp add populi-mcp -e POPULI_BASE_URL=<POPULI_BASE_URL> -e POPULI_API_KEY=<POPULI_API_KEY> -e POPULI_ALLOW_WRITES=<POPULI_ALLOW_WRITES> -e POPULI_FILES_DIR=<POPULI_FILES_DIR> -e POPULI_TIMEOUT_MS=<POPULI_TIMEOUT_MS> -- npx -y @kisasa/[email protected]{
"mcpServers": {
"populi-mcp": {
"command": "npx",
"args": [
"-y",
"@kisasa/[email protected]"
],
"env": {
"POPULI_BASE_URL": "<POPULI_BASE_URL>",
"POPULI_API_KEY": "<POPULI_API_KEY>",
"POPULI_ALLOW_WRITES": "<POPULI_ALLOW_WRITES>",
"POPULI_FILES_DIR": "<POPULI_FILES_DIR>",
"POPULI_TIMEOUT_MS": "<POPULI_TIMEOUT_MS>"
}
}
}
}{
"mcpServers": {
"populi-mcp": {
"command": "npx",
"args": [
"-y",
"@kisasa/[email protected]"
],
"env": {
"POPULI_BASE_URL": "<POPULI_BASE_URL>",
"POPULI_API_KEY": "<POPULI_API_KEY>",
"POPULI_ALLOW_WRITES": "<POPULI_ALLOW_WRITES>",
"POPULI_FILES_DIR": "<POPULI_FILES_DIR>",
"POPULI_TIMEOUT_MS": "<POPULI_TIMEOUT_MS>"
}
}
}
}{
"servers": {
"populi-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@kisasa/[email protected]"
],
"env": {
"POPULI_BASE_URL": "<POPULI_BASE_URL>",
"POPULI_API_KEY": "<POPULI_API_KEY>",
"POPULI_ALLOW_WRITES": "<POPULI_ALLOW_WRITES>",
"POPULI_FILES_DIR": "<POPULI_FILES_DIR>",
"POPULI_TIMEOUT_MS": "<POPULI_TIMEOUT_MS>"
}
}
}
}Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.
Tools
This server runs locally, so its tools are listed by your MCP client once it starts.
Environment variables
| Name | Description |
|---|---|
POPULI_BASE_URLRequired | Your Populi instance URL, with or without the /api2 suffix |
POPULI_API_KEYRequired, secret | Populi API key token (Account & Settings > API > Keys). Use an sk_sandbox_ key against a sandbox instance while evaluating |
POPULI_ALLOW_WRITESOptional | Set to true to enable the populi_write tool (create, update, delete). Default is read-only |
POPULI_FILES_DIROptional | Folder for downloads and uploads (the only place files are read from or written to). Default ~/populi-mcp-files |
POPULI_TIMEOUT_MSOptional | Per-request timeout in milliseconds, 1000 to 600000. Default 120000 |
Details
| Package | @kisasa/[email protected] (NPM, stdio) |
| First published | 10 Nov 2026 |
| Last updated | 10 Nov 2026 |
| Registry name | io.github.kisasa/populi-mcp |
More search and web servers See all
Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.