Smartschool MCP Server
PYPI · SMARTSCHOOL-MCP · SCANNED OCT 3
Access Smartschool courses, grades, assignments, and messages through the Model Context Protocol
Available components
How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score → Why this is hard to score →
Supply Chain Security99
- No malware found by supply-chain analysis.Pass
- Known CVEs were checked across the 49 of 50 dependencies we could resolve, so this covers what we could see, not the whole tree.Partial
- Runs hatchling.build at install time, a recognised build step with no custom scripting around it. View diagnostics → Pass
- Dependency health was assessed across the 49 of 50 dependencies we could resolve, so this covers what we could see, not the whole tree. View diagnostics → Partial
Provenance & Transparency74
- Repository check failed: no source repository is declared. See how to fix → View diagnostics → Fail
- Cryptographically verified build provenance (signed, bound to MauroDruwel/Smartschool-MCP). View diagnostics → Pass
- Clear OSI-approved license (MIT).Pass
- Actively maintained (last published 10 days ago).Pass
- Publishes a security disclosure policy (SECURITY.md).Pass
Schema Quality & AI Usability75
- AI-judged instruction clarity (good).Pass
- Tool/resource definitions use about 1327 tokens (~102/item across 13 items; 13 tools + 0 resources), lean.Pass
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management37
- Stability observed for 11 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage71
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 0% of tool parameters carry a description.Fail
- Structured output schemas are declared (100% of tools); any adoption earns full credit.Pass
Tool Safety100
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- We read all 13 captured tool definition(s), and no name or description among them implies an irreversible operation.Pass
- An AI judge read all 13 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
- Implements a current MCP spec version (2026-07-28).Pass
How do I install the Smartschool MCP Server server?
Smartschool MCP Server runs locally as a PyPI package, launched with uvx smartschool-mcp. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.
pypi · smartschool-mcp
claude mcp add maurodruwel-smartschool-mcp -- uvx smartschool-mcp
{
"mcpServers": {
"maurodruwel-smartschool-mcp": {
"command": "uvx",
"args": [
"smartschool-mcp"
]
}
}
} {
"servers": {
"maurodruwel-smartschool-mcp": {
"command": "uvx",
"args": [
"smartschool-mcp"
]
}
}
} codex mcp add maurodruwel-smartschool-mcp -- uvx smartschool-mcp
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"maurodruwel-smartschool-mcp": {
"type": "local",
"command": [
"uvx",
"smartschool-mcp"
],
"enabled": true
}
}
} openclaw mcp add maurodruwel-smartschool-mcp --command uvx --arg smartschool-mcp
mcp_servers:
maurodruwel-smartschool-mcp:
command: "uvx"
args: ["smartschool-mcp"] {
"McpServers": {
"maurodruwel-smartschool-mcp": {
"Transport": "stdio",
"Command": "uvx",
"Arguments": [
"smartschool-mcp"
]
}
}
} assistant mcp add maurodruwel-smartschool-mcp -t stdio -c uvx -a smartschool-mcp
{
"mcpServers": {
"maurodruwel-smartschool-mcp": {
"command": "uvx",
"args": [
"smartschool-mcp"
]
}
}
} Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 3 Oct 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 33 to 37. That category is still filling its 30-day observation window: 10 days of observed history at the previous scan, 11 at this one. The score rises as the window fills, whether or not the server changes.
- 1 Oct 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 27 to 30. That category is still filling its 30-day observation window: 8 days of observed history at the previous scan, 9 at this one. The score rises as the window fills, whether or not the server changes.
- 30 Sept 26 +18
- Malware scan: unverified → pass ▲ security
- Stability: unverified → 0.27 ▲ functional
- 29 Sept 26 −4
- Malware scan: pass → unverified ▼ security
- Provenance: unverified → pass ▲ security
- The attested source repository moved: MauroDruwel/Smartschool-MCP security
- 28 Sept 26 +15
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
- 25 Sept 26 0
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
- 23 Sept 26 −15
- Malware scan: pass → unverified ▼ security
- 22 Sept 26 +44
- Injection markers: unverified → pass ▲ security
- Malware scan: unverified → pass ▲ security
- First check of Judged manipulation: pass security
- Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window). security
- Tool safety: Tool safety not yet verified: we do not have a sandbox capture of the tool definitions this version of the package serves yet. security
- Stability: Stability not yet verified: we do not have a sandbox capture of the MCP schema this version of the package serves yet. security
- Tool coverage: unverified → 100 ▲ functional
- MCP protocol: unverified → pass ▲ functional
- First check of Tool coverage: 0 functional
- First check of Schema quality: fail functional
- First check of Destructive annotations: pass functional
- First check of Schema quality: pass functional
- First check of Schema quality: good functional
- First check of Tool coverage: 100 functional
- Capabilities: Protocol version not yet verified: we do not have a sandbox capture of the MCP handshake this version of the package performs yet. functional
- Tool coverage: Tool coverage not yet verified: we do not have a sandbox capture of the tool definitions this version of the package serves yet. functional
- Schema quality: Schema quality not yet verified: we do not have a sandbox capture of the MCP schema this version of the package serves yet. functional
- Package version: 0.1.4 → 0.3.0 functional
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 3 Oct 2026 · Analysed pypi/smartschool-mcp@0.3.0
Provenance Verified
A signed build attestation was found and verified, binding this exact artifact to the source repository it claims to come from.
| Result | Verified |
|---|---|
| Ecosystem | pypi |
| Reason | Verified |
| Discovered via | Registry attestation endpoint |
| Source repo | MauroDruwel/Smartschool-MCP |
| Certificate issuer | https://token.actions.githubusercontent.com |
| Certificate SAN | https://github.com/MauroDruwel/Smartschool-MCP/.github/workflows/publish.yml@refs/tags/v0.3.0 |
| Rekor log index | 2910334344 |
| Predicate type | PyPI publish attestation https://docs.pypi.org/attestations/publish/v1 |
| Subject digest | sha256:b1322f61e62ba45c860cb886087d3969d4c8813c90d6c249142b75799fae1af7 |
Background: How many MCP packages publish verified provenance →
Install scripts 1 script
| Hook | Tier | Command |
|---|---|---|
| build_backend | allowlisted | hatchling.build |
Background: Why install scripts are a supply-chain risk →
Dependencies 49 packages
| Packages resolved | 49 |
|---|---|
| Stale | 5 |
| No linked repository | 2 |
| Tree resolution | Partial |
The dependency tree was only partially resolved, so these counts may be incomplete.
Background: SBOMs and build attestations, explained →
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
download_attachment ~199
Download a specific attachment from a message. Files are saved to *save_path* when provided, otherwise to ~/Downloads/smartschool/. The directory is created automatically. Existing files are never overwritten — a counter suffix is appended instead (e.g. ``report (1).pdf``). Args: message_id: The ID of the message containing the attachment. file_id: The file ID of the attachment to download (from get_attachments). save_path: Optional directory to save the file into. Returns: Dictionary with the saved file path, filename, mime type, and bytes written. Examples: - download_attachment(249184, 12345) -> Download to ~/Downloads/smartschool/ - download_attachment(249184, 12345, "/tmp") -> Download to /tmp/
| Name | Type | Req | Description |
|---|---|---|---|
| file_id | integer | yes | – |
| message_id | integer | yes | – |
| save_path | – | – | – |
Structured output declared, but exposes no named fields.
No examples provided.
download_homepage_image ~110
Download an image embedded in a homepage block. Use the URLs returned in ``get_homepage_blocks()["blocks"][*]["images"]``. Only assets on the configured Smartschool host are accepted. Args: image_url: Image URL from get_homepage_blocks. save_path: Optional directory to save into (default: ~/Downloads/smartschool/). Returns: Dictionary with the saved file path and bytes written.
| Name | Type | Req | Description |
|---|---|---|---|
| image_url | string | yes | – |
| save_path | – | – | – |
Structured output declared, but exposes no named fields.
No examples provided.
get_attachments ~89
List all attachments for a specific message. Args: message_id: The ID of the message to get attachments for (from get_messages results). Returns: Dictionary with attachment list including file names, sizes, and IDs for downloading. Examples: - get_attachments(249184) -> List attachments for message 249184
| Name | Type | Req | Description |
|---|---|---|---|
| message_id | integer | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
get_courses ~29
Retrieve all available courses with their teachers. Returns: List of courses with name and teacher information.
Input schema present but exposes no named parameters.
| Name | Type | Req | Description |
|---|---|---|---|
| result | array | yes | – |
No examples provided.
get_future_tasks ~29
Retrieve upcoming assignments and tasks. Returns: Dictionary with future tasks organized by date and course.
Input schema present but exposes no named parameters.
Structured output declared, but exposes no named fields.
No examples provided.
get_homepage_blocks ~184
Retrieve the "in de kijker" blocks pinned to the Smartschool homepage. Schools use these blocks for recurring content that is never sent as a message and never lands in a document module — a monthly lunch menu ("Maandmenu"), a monthly calendar ("Maandkalender"), announcements. The content is frequently an embedded image rather than text, so ``images`` is usually where the information actually lives. Args: include_html: Also return each block's raw inner HTML (default: False). Returns: Dictionary with the list of blocks. Each block has a title, its news_id, plain text, and absolute URLs for any embedded images and links. Examples: - get_homepage_blocks() -> [{"title": "Maandmenu", "images": [...]}, ...]
| Name | Type | Req | Description |
|---|---|---|---|
| include_html | boolean | – | – |
Structured output declared, but exposes no named fields.
No examples provided.
get_messages ~264
Retrieve messages from the specified mailbox with filtering options. Args: limit: Maximum number of messages to return (default: 15) offset: Number of messages to skip from the beginning (default: 0) box_type: Type of mailbox - "INBOX", "SENT", "DRAFT", "SCHEDULED", "TRASH" (default: "INBOX") search_query: Search in subject and body content (case-insensitive) sender_filter: Filter messages by sender name (partial match, case-insensitive) include_body: Whether to include full message body (default: False for performance) Returns: Dictionary with messages list and pagination info. Examples: - get_messages() -> First 15 inbox messages (headers only) - get_messages(search_query="homework") -> Messages containing "homework" - get_messages(sender_filter="teacher") -> Messages from senders containing "teacher" - get_messages(include_body=True) -> Full messages with body content
| Name | Type | Req | Description |
|---|---|---|---|
| box_type | string | – | – |
| include_body | boolean | – | – |
| limit | integer | – | – |
| offset | integer | – | – |
| search_query | – | – | – |
| sender_filter | – | – | – |
Structured output declared, but exposes no named fields.
No examples provided.
get_periods ~37
Retrieve academic periods/terms for the current school year. Returns: List of academic periods with name, dates, and active status.
Input schema present but exposes no named parameters.
| Name | Type | Req | Description |
|---|---|---|---|
| result | array | yes | – |
No examples provided.
get_planned_elements ~68
Retrieve planned assignments and to-dos from the Smartschool planner. Args: days_ahead: Number of days ahead to fetch (default: 34) Returns: Dictionary with planned elements including dates, courses, and assignment types.
| Name | Type | Req | Description |
|---|---|---|---|
| days_ahead | integer | – | – |
Structured output declared, but exposes no named fields.
No examples provided.
get_reports ~34
Retrieve available academic report cards. Returns: List of report cards with name, date, class, and school year label.
Input schema present but exposes no named parameters.
| Name | Type | Req | Description |
|---|---|---|---|
| result | array | yes | – |
No examples provided.
get_results ~180
Retrieve student results/grades with detailed information. Args: limit: Maximum number of results to return (default: 15) offset: Number of results to skip from the beginning (default: 0) course_filter: Filter results by course name (partial match, case-insensitive) include_details: Whether to fetch detailed info (teacher, average, median) - saves API calls if False Returns: Dictionary with results list and pagination info. Examples: - get_results() -> First 15 results with details - get_results(course_filter="Math") -> Results from courses containing "Math" - get_results(include_details=False) -> Basic info only, faster response
| Name | Type | Req | Description |
|---|---|---|---|
| course_filter | – | – | – |
| include_details | boolean | – | – |
| limit | integer | – | – |
| offset | integer | – | – |
Structured output declared, but exposes no named fields.
No examples provided.
get_schedule ~70
Retrieve the lesson schedule for a given day. Args: date_offset: Days from today (0=today, 1=tomorrow, -1=yesterday, default: 0) Returns: Dictionary with the lessons scheduled for the given date.
| Name | Type | Req | Description |
|---|---|---|---|
| date_offset | integer | – | – |
Structured output declared, but exposes no named fields.
No examples provided.
get_student_support_links ~34
Retrieve student support links and resources. Returns: List of visible support links with name, description, and URL.
Input schema present but exposes no named parameters.
| Name | Type | Req | Description |
|---|---|---|---|
| result | array | yes | – |
No examples provided.
What is the Smartschool MCP Server server?
Smartschool MCP Server is listed in the public MCP registry as io.github.MauroDruwel/smartschool-mcp. Access Smartschool courses, grades, assignments, and messages through the Model Context Protocol. This page covers its PyPI package (smartschool-mcp).
Is the Smartschool MCP Server server safe to use?
Smartschool MCP Server scores 79 out of 100 on VerifyMCP. Its build provenance is signed and verified. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.
What tools does the Smartschool MCP Server server expose?
Smartschool MCP Server exposes 13 tools: get_courses, get_results, get_future_tasks, get_messages, get_schedule, and 8 more. Their descriptions and schemas cost roughly 1,327 tokens of context every time the server is loaded.
Is the Smartschool MCP Server server still maintained?
Smartschool MCP Server is still listed as active in the MCP registry. We last reached this channel on 3 October 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.
What licence is the Smartschool MCP Server server under?
Smartschool MCP Server declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.