Smartschool MCP Server

@AbriantoLabs

Basic information

About Smartschool MCP Server

A dynamic Model Context Protocol (MCP) server that provides AI assistants with secure access to Smartschool APIs. This server automatically discovers all available Smartschool methods and exposes them as MCP tools with comprehensive safety guardrails.

Smartschool MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "smartschool": {
      "command": "node",
      "args": [
        "/path/to/smartschool-mcp-server/build/mod.js"
      ],
      "env": {
        "SMARTSCHOOL_API_ENDPOINT": "https://your-school.smartschool.be/Webservices/V3",
        "SMARTSCHOOL_ACCESS_CODE": "your-access-code",
        "ALLOW_DESTRUCTIVE": "false",
        "REQUIRE_CONFIRMATION": "true"
      }
    }
  }
}

Smartschool MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Smartschool Mcp?

Smartschool Mcp is a Model Context Protocol (MCP) server that gives AI assistants secure, dynamically discovered access to Smartschool APIs. It automatically detects all available Smartschool methods and exposes them as MCP tools with built‑in safety guardrails.

How to use Smartschool Mcp?

Install via npm (npm install and build), set environment variables (SMARTSCHOOL_API_ENDPOINT, SMARTSCHOOL_ACCESS_CODE, and optionally ALLOW_DESTRUCTIVE and REQUIRE_CONFIRMATION), then configure your MCP client (e.g., Claude Desktop) to launch the server using npx -y @abrianto/smartschool-mcp or manually via node build/mod.js. The server communicates over stdio.

Key features of Smartschool Mcp

Dynamic auto-discovery of all Smartschool API methods
Enterprise safety with four protection levels (SAFE, MODERATE, DESTRUCTIVE, CRITICAL)
AI-optimized context including Belgian school conventions and absence codes
Zero maintenance – no manual tool definitions required
Future-proof – adapts automatically when Smartschool SDK updates
Built-in domain expertise for Belgian school systems

Use cases of Smartschool Mcp

Manage users (create, update, delete) with confirmation for destructive actions
Handle class and group assignments (save, delete classes, assign students)
Send messages to students and parents via Smartschool’s messaging system
Check attendance records and academic history
Perform system administration tasks like synchronisation and support tickets

Frequently asked questions

What are the safety levels and how do they work?

The server classifies operations into SAFE (read‑only, no restrictions), MODERATE (reversible changes, always allowed), DESTRUCTIVE (high‑impact changes, requires `ALLOW_DESTRUCTIVE=true`), and CRITICAL (permanent deletions, requires `ALLOW_DESTRUCTIVE=true` and the `confirmDestructiveAction` parameter).

What are the runtime requirements?

Node.js 18+ or a compatible JavaScript runtime, access to a Smartschool instance, valid API credentials (endpoint and access code), and network connectivity to the Smartschool API endpoint.

How do I enable destructive operations?

Set the environment variable `ALLOW_DESTRUCTIVE=true` and include `confirmDestructiveAction: true` in the tool call parameters. By default, destructive operations are blocked in production.

What data does the server access?

The server connects to Smartschool’s V3 API and requires permissions for user management, group/class management, messaging, and reporting. Credentials should be kept secure and not committed to version control.

How does the server handle authentication and transport?

It uses stdio transport per the MCP specification. Authentication is provided via the `SMARTSCHOOL_ACCESS_CODE` environment variable. No other transports or authentication methods are documented.

Comments

More Other MCP servers

Glasswarp

See and control a real Windows PC you own — from any MCP client, locally or remotely. Observe (UIA + screenshots), click/type/drag/scroll, launch apps, owner Live View. BYOH: your machine, your key.

Hindsight

vectorize-io

Hindsight: Agent Memory That Learns

50.4K

Soar Flight Booking MCP

Soar Flight Booking MCP is a remote MCP server available at https://mcp.soar.flights.

Next Generation Movers: free moving quotes (remote MCP)

Next Generation Movers

Free moving quotes for AI agents from Next Generation Movers, a licensed interstate mover (USDOT 3764697). US long-distance nationwide and local DC/MD/VA. Indicative ballpark price and booking options; optional $0.01 x40

Sequential Thinking

modelcontextprotocol

Model Context Protocol Servers

88.2K