Comprehensive Model Context Protocol server for managing Home Assistant through AI assistants.
Nothing to run from here
Somtoday (unofficial) is installed from its publisher's own source and answers where it runs, so this marketplace is not in the path of a single call. There is no address here to send one to, and a panel that pretended otherwise would be showing you an answer we made up. Install it and call it from your own client — the Installation tab has the entry for each one.
94/100
trust score
15
downloads a day
local
runs on your machine
895
downloads in 30d
What it does
Unofficial read-only Somtoday parent portal: timetable, homework, grades, assignments, messages
Quickstart
# 1 — add it to Claude Code
claude mcp add --scope user somtoday-unofficial-mcp '--' npx -y somtoday-mcp
# 2 — ask your agent for something these tools do
# whoami, lessons, schedule and 22 more
Somtoday (unofficial) costs nothing on mcprush: there is no plan to choose here, no cap to set and nothing mcprush can bill you for.
Publishernot claimed
BAAll 2 servers
barzoj2 servers
2 categories
Collected from a public index. Nobody has claimed this account, so nothing here was written by its author — claim it if it is yours.
Installation
Where are you running it?
Every route below installs the same thing and ends at the same approval screen. This one runs on your machine: your client starts Somtoday (unofficial) as a process under your own user, with your files and your network, so the tool surface below is what it can do to your computer rather than to a server somewhere else. Its scan result is on the Security tab — read the surface before you approve it.
Claude Codedeclared by this listing
This is a public server: you run it yourself and this marketplace is not in the path. You need Node.js — the current LTS (24) is the safe choice; npx comes with it. Claude Code registers it in one command; --scope user makes it available in every project. The '--' is in quotes so that PowerShell passes it on.
claude mcp add --scope user somtoday-unofficial-mcp '--' npx -y somtoday-mcpReconnect, or start a new session, and the tools appear in the model’s tool list.
Free on mcprush, and it runs from its publisher’s own package: this marketplace is not in the path, so there is no key of ours to hold and no card to add.
What it writes
One config entry your client uses to start the process locally. A local server runs with your file system and your network, which is why it is priced without metering.
What you approve
25 tools, with what each one reads, writes and reaches shown before you agree — the same list on every route above. Read the tool surface.
Tool surface
What the model actually sees. Descriptions are diffed on every release — see version history.
Read from its source code. A server that builds its tool list when it starts can list more tools than this.
Start here: the school label, the numeric leerling ids to pass as leerlingId to other tools, and which parent-portal sections are visible. Use children for full profiles. No tokens.
No parameter schema on file.
Timetable for one Amsterdam date, plus whether that date is a holiday. Each lesson has type (ROOSTERTOETS or EXAMEN marks a test in the timetable) and uitgevallen=true when cancelled. Homework and the test topic per lesson are not here: call homework for the same date.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| date | string | no | Amsterdam calendar date. Defaults to tomorrow. |
| leerlingId | yes | — |
Timetable for a date range, per day: lessons, tests and other appointments with time, lesson hour, subject, room, teachers, type (e.g. ROOSTERTOETS, EXAMEN, OUDERAVOND), lesson notes, changes and cancellations (wijziging, uitgevallen=true, meldingen with real warnings only; the routine…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| leerlingId | yes | — |
What to do and learn on which day: every studiewijzer item (lesson, day and week items) for a date range, grouped by day, with description, learning goals, time estimate, test type, teacher note, attachments (file links), external links, hand-in window and status, and the done tick. Also lists…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| leerlingId | yes | — |
All hand-in assignments with their window, status (AANKOMEND, IN_TE_LEVEREN, IN_AFWACHTING, AKKOORD), teLaat (always a boolean: true only for an open hand-in past its deadline), description, attachments and links. status=open keeps upcoming and to-do ones, and by default hides past-due items where…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| status | string | no | Default all. |
| includeNoHandIn | boolean | no | — |
| dedupe | boolean | no | — |
| leerlingId | yes | — |
One hand-in assignment as the parent portal shows it: instruction text, learning goals, files (fileUrl) and links, hand-in window, status, late flag and group. Submitted files and teacher reactions are only visible to the student in Somtoday, so they are not returned.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| toekenningId | yes | — | |
| leerlingId | yes | — |
Studiemateriaal per subject: lesson material from the study planner (by date), year attachments by folder (file links), external links, and methods/publisher links (book fund). Without arguments: the subjects that have material, plus personal learning products when the school allows it. vak =…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| vak | yes | — | |
| all | boolean | no | Fetch material for every subject. |
| leerlingId | yes | — |
Quick grade summary: the newest progress-dossier results (capped at 30) plus the average per subject. Use grades_latest for more or exam (SE) results, grades_overview for a whole school year, subject_grades for one subject in depth, and exam_grades for the PTA/SE dossier.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| leerlingId | yes | — |
Newest results first, with subject, column, description, grade, weight, test type, period, date, remarks and resit info. limit defaults to 50 (max 1000, paged). dossier=examen gives school-exam (SE) results. Also the next publication moment when the school uses one. Use this for "what grades came…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| limit | integer | no | — |
| dossier | string | no | Default voortgang. |
| leerlingId | yes | — |
The full grade overview (cijferoverzicht) for a school year: every subject with every result per period, report grades, weights and remarks. Defaults to the current placement; schooljaar like 2025/2026 picks another year. Use this for a whole-year report view or earlier years; use subject_grades…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| schooljaar | string | no | School year name, e.g. "2025/2026". |
| leerlingId | yes | — |
Everything for one subject: every result column (tests, assignments, period and report averages, SE averages) with weights and remarks, column definitions (also not-yet-graded ones), and the parts of composite tests. Both progress and exam dossier unless dossier is set. Without vak: the list of…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| vak | yes | — | |
| dossier | string | no | — |
| leerlingId | yes | — |
School-exam dossier (PTA/SE) overview: per subject the SE average, every SE result, tests still to come, and test-type averages. Says so when the child has no exam dossier yet. Use this for exam-year progress and upcoming SE tests; use grades_latest with dossier=examen for only the newest SE…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| examenjaar | integer | no | Exam year; defaults to the latest. |
| leerlingId | yes | — |
Registrations for the school year (or current grading period): unexcused and excused absence, late, removed from class, homework not done, materials missing — counts and every entry with date, lesson and remark — plus active measures (e.g. detention).
| Parameter | Type | Required | Notes |
|---|---|---|---|
| periode | string | no | Default SCHOOLJAAR. |
| leerlingId | yes | — |
Somtoday messages (berichten), read-only: newest conversations with subject, sender, date, unread flag and a preview; filter with zoek or ongelezen. Pass conversatieId for the full thread (text, sender, recipients, attachments). Never marks anything as read. Use this for personal messages from…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| conversatieId | yes | — | |
| limit | integer | no | Default 25. |
| zoek | string | no | Search in subject, sender and preview. |
| ongelezen | boolean | no | Only unread conversations. |
News items the school publishes to all parents (nieuwsberichten), newest first, as text, plus the unread count. Use messages for personal conversations and announcements for Somtoday-wide notices from the platform itself.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| limit | integer | no | Default 25. |
Somtoday-wide announcements (landelijke mededelingen) from the platform itself, such as maintenance notices, with their publication window. Not school news (use news) or personal messages (use messages).
No parameter schema on file.
Linked children with profile (name, student number, class), school data (school, location, mentor(s), year, programme), current placement, and which portal sections the school shows. Use whoami when you only need leerling ids.
No parameter schema on file.
School contact data per child and the school's published information pages. Pass paginaId for one page with its topics and documents. Use teachers for staff and children for mentors.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| paginaId | yes | — |
Teachers and other staff you can message in Somtoday, with the subjects they teach your child. Use children for the mentor(s) and school_info for general school contact data.
No parameter schema on file.
Digital signing requests (ondertekenverzoeken) waiting for you or done. Each item has document {tool:'signing_document', id, available}: pass id to signing_document to read the (signed) PDF. Read-only; nothing is signed.
No parameter schema on file.
Read the document (PDF) of one signing request, as the portal's download button does: pass document.id from signing_requests. Returns extracted text (max 10 MB). The document needs your login, so it is not a fileUrl for download_attachment. Usually available once signed; not for requests still to…
| Parameter | Type | Required | Notes |
|---|---|---|---|
| id | yes | — |
Parent-evening (ouderavond) details: invitation, time slots and chosen teachers. Without id, finds invitations linked in your messages. Read-only; nothing is booked.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| id | yes | — |
Consents (toestemmingen) as set in the portal: each consent item (e.g. use of photos) with the answer recorded in the portal. Read-only; answers cannot be changed here.
No parameter schema on file.
Read an attachment (fileUrl from homework, assignments, study material or messages). Only https Somtoday file hosts; max 10 MB; returns extracted text for PDF/text/HTML/CSV/JSON, metadata otherwise.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| url | string | yes | — |
Whether a Somtoday session is stored, where (keychain or file), and the outcome of the last token renewal. Never returns tokens. Set check=true to renew the token and call the API once.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| check | boolean | no | Renew the access token and call GET /account/me once. |
Free
$0 forever
- Every tool, no call limit
- No card, and mcprush charges nothing for it
- Source published under MIT
- Runs on your machine — nothing of it reaches our gateway
- Nothing to cap, because mcprush bills nothing
What counts against your monthly calls
| Tool | Unit | Calls used | Out of the allowance |
|---|
Nothing here is billable: mcprush charges nothing to install Somtoday (unofficial) or to call it, at any volume.
Call allowance · this installenforced at the gateway
Monthly allowance, in calls
—
—
Alert at 80% · then the tool returns a normal MCP error
Used this month: —
ATrust score 94 / 100
Release 0.3.2 · scanned 28 Oct 2026
Two independent axes, because powerful and malicious are different questions. The grade is threat only. The capability level is blast radius, and it is never a penalty on the grade — it is priced as one subtract-only term in the score, where you can see it.
Threat score100
Client score94
Findings1 threat · 1 capability
Capabilityhigh
Coveragesource
Verificationsource
Surface digeste9b55726d9a62acbd698797b9c3aa8422d28a751c60f1b67164eef794a94a535
Score vectorthreat 100 → client 94
| Term | Level | What it prices | Points |
|---|---|---|---|
| capability-exposure | high | capability blast radius (high) — client exposure if the model is manipulated | −6 |
| verification-discount | source | publisher verification (provenance) — cryptographic build provenance ties the artifact to its source | −0 |
| coverage-honesty | source | inspection depth (source) — how much of the target the scan could see | −0 |
score = clamp(round(threatScore − E_cap − E_ver − E_cov), 0, 100). No model, no opinion, no network call at scoring time: the same methodology version against the same bytes always produces this number, and every line above is a field of the report rather than a summary of it.
What the scan could actually read
A grade is only as meaningful as its coverage, so the scanner publishes its own depth before it publishes its result.
Tool surfaceread
Implementation sourceread
Package metadataread
Live transportnot available
Tools were statically extracted from the published source (25 recovered), not enumerated from a running server. Tool-poisoning, Unicode-smuggling, capability and toxic-flow analysis ran on this inferred surface, but a mis-parsed registration could be missed or mis-attributed, so tool-derived findings are capped below “confirmed”. To grade the real runtime surface, scan the running server: --command "npx -y <package>".
Capability — what it could do if the model were manipulated
Tags derived from each tool’s schema and the implementation, not from what the tool calls itself. high is the level these add up to.
| Tool | Capability tags | Why the tag was assigned |
|---|---|---|
| whoami | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| lessons | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| schedule | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| homework | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| assignments | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| assignment_detail | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| study_material | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| grades | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| grades_latest | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| grades_overview | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| subject_grades | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| exam_grades | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| absence | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| messages | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| news | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| announcements | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| children | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| school_info | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| teachers | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| signing_requests | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| signing_document | untrusted-input | untrusted-input: keyword "download", declares openWorldHint: true (interacts with entities outside the server) |
| parent_evening | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| consents | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
| download_attachment | untrusted-input | untrusted-input: keyword "download", declares openWorldHint: true (interacts with entities outside the server) |
| auth_status | untrusted-input | untrusted-input: declares openWorldHint: true (interacts with entities outside the server) |
Toxic-flow graph
The lethal trifecta, checked as a graph rather than as a checklist: untrusted input, a sensitive source and an external sink have to meet before there is a path worth worrying about.
The public result for this release does not print the flow graph, so there is nothing to show here. That is not the same as "no paths were found": what the scan did read is above, under coverage.
Supply chain and provenance
Integrityfirst-seen
Surface digeste9b55726d9a62acb
Scanned2026-10-28
This is the first scan of this surface here, so there is nothing yet to compare it against.
Every result on this tab comes from one deterministic pass over the published package — offline, rule by rule, and auditable line by line above. Same methodology version, same bytes, same score.
Release history
Always latest — the install command names no version, so it installs the newest release when it runs; the current release on file is 0.3.2. Pin a release below and the command asks for exactly that one.
0.3.2
25 Oct 2026
latestNo release note was published with this version.
0.3.1
undated
- The version this listing was on when mcprush began following its releases. The registry was not asked when it shipped, so this row carries no date.
—
no reviews yet
Who can review
One review per account, from a signed-in account that does not publish this listing. Nothing else is asked — you can say what you think before you install it. Publishers can reply once per review, and a review can be edited or deleted by whoever wrote it.
Sign in to write one
Any signed-in account that does not publish Somtoday (unofficial) can review it, once — before installing it or after. A review from an account that has installed it is marked as one.
No reviews yet
Nobody has reviewed this listing. The rating on the card is the mean of the reviews written here and nothing else, so there is no rating until somebody writes the first — which takes a signed-in account that does not publish it, and nothing else.