gradebook-mcp
by songsterq
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| TZ | No | Timezone for current reporting period calculation. | UTC |
| HOST | No | Interface for the MCP listener inside the container. | 0.0.0.0 |
| PORT | No | Port for the MCP listener inside the container. | 3000 |
| UI_HOST | No | Dashboard listener interface inside the container. Defaults to the value of HOST. | |
| UI_PORT | No | Dashboard listener port. Blank disables the dashboard. | |
| DATA_DIR | No | Directory where gradebook.sqlite lives. | ./data |
| LOG_LEVEL | No | pino log level. Logs are JSON lines. | info |
| ACCESS_AUD | No | Cloudflare Access application AUD tag for authentication mode B. | |
| UI_BIND_ADDR | No | Host address Compose publishes the dashboard port on. | 127.0.0.1 |
| MCP_BIND_ADDR | No | Host address Compose publishes the MCP port on. | 127.0.0.1 |
| ALLOWED_EMAILS | No | Comma-separated allowlist of user emails for Cloudflare Access mode. | |
| MCP_BEARER_TOKEN | No | Static bearer token for authentication mode A (min 16 chars). | |
| ACCESS_TEAM_DOMAIN | No | Cloudflare Access team domain (with scheme) for authentication mode B. | |
| GRADEBOOK_STUDENTS | No | Optional comma-separated student-name allowlist. Default: all students. | |
| DEV_INSECURE_NO_AUTH | No | Local development only; disables authentication. Only honored when NODE_ENV is not production and bound to loopback. | false |
| ALLOWED_SERVICE_TOKENS | No | Comma-separated allowlist of service-token Client IDs for Cloudflare Access mode. | |
| GRADEBOOK_SYNC_ENABLED | No | Opt-in switch for the automatic scheduler. | false |
| GRADEBOOK_PARENTVUE_HOST | No | District ParentVUE host, e.g. <district>.edupoint.com. | |
| GRADEBOOK_PARENTVUE_PASS | No | Parent login password. | |
| GRADEBOOK_PARENTVUE_USER | No | Parent login username. | |
| GRADEBOOK_SYNC_INTERVAL_HOURS | No | Hours between automatic syncs; 0 disables. | 24 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Server capabilities have not been inspected yet.
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
No tools | |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
This server cannot be deployed
Maintenance
ActivityMaintained
ResponsivenessNo issues