Skip to content
Back to search

il-school-marketplace

MarketplaceWorks with Claude CodeGitHub

Israeli school portal (Mashov & Webtop) MCP plugin for parents

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 20 Nov 2026. Its scripts were only partly scanned.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/hagaija/il-school-mcp with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/hagaija/il-school-mcp'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/hagaija--il-school-mcp/badge.svg)](/listings/hagaija--il-school-mcp)

HTML

<a href="/listings/hagaija--il-school-mcp"><img src="/api/listings/hagaija--il-school-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

1. Claude (Claude Desktop App, Cowork & Claude Code)

* **Claude Desktop Chat (1-Click Desktop Extension `.mcpb` — Recommended for non-developers):** Regular Claude Desktop Chat does **not** run `.mcp.json` `stdio` servers from GitHub marketplace plugins (it only syncs their `SKILL.md`s). Instead, download `il-school-mcp.mcpb` from [GitHub Releases](https://github.com/hagaija/il-school-mcp/releases) and open/drop it in **Claude Desktop → Settings → Extensions**. Claude Desktop will prompt you for Mashov/Webtop credentials directly in a native GUI form on install. * **Claude Code / Cowork (GitHub marketplace):**

  /plugin marketplace add hagaija/il-school-mcp
  /plugin install il-school@il-school-marketplace

*(On first question, Claude will provide a `http://127.0.0.1:...` setup link via `school_open_setup` if no accounts are configured yet.)* * **Manual MCP entry (`claude_desktop_config.json`):**

  {
    "mcpServers": {
      "il-school": {
        "command": "node",
        "args": ["/ABS/PATH/TO/il-school-mcp/bundle/server.cjs"]
      }
    }
  }

2. Antigravity

Clone and install directly via CLI:

git clone https://github.com/hagaija/il-school-mcp.git
agy plugin install ./il-school-mcp

Restart Antigravity after installing a new plugin directory, then ask one of the starter prompts or invoke `/il-school-assistant` / `/il-school-setup`.

3. ChatGPT / OpenAI Agent Plugins & Codex

* **Codex / Agent Plugin marketplace:** Uses root `plugin.json` + `mcp.json`, `.agents/plugins/marketplace.json`, and `.codex-plugin/plugin.json` + `.mcp.json`:

  codex marketplace add hagaija/il-school-mcp

Or manually in `~/.codex/config.toml`:

  [mcp_servers.il-school]
  command = "node"
  args = ["/ABS/PATH/TO/il-school-mcp/scripts/launch-mcp.mjs"]

* **Standard ChatGPT Desktop chat mode:** Requires a remote HTTPS MCP endpoint. Run the built-in Streamable HTTP server locally with a bearer token and expose it privately over Tailscale Funnel or Cloudflare Tunnel:

  node /ABS/PATH/TO/il-school-mcp/dist/index.js --http --port 3333 --token "your-secret-token"

Endpoint: `https://<your-tunnel-host>/mcp`

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 16 lines
  1. {
  2. "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
  3. "name": "il-school-marketplace",
  4. "description": "Israeli school portal (Mashov & Webtop) MCP plugin for parents",
  5. "owner": {
  6. "name": "il-school-mcp contributors"
  7. },
  8. "plugins": [
  9. {
  10. "name": "il-school",
  11. "description": "Read-only Mashov and Webtop assistant for lesson schedules, homework, exams, behavior logs, and school messages",
  12. "version": "0.2.0",
  13. "source": "./"
  14. }
  15. ]
  16. }
README.md · README · 107 lines
  1. # il-school-mcp
  2. Local-first, read-only **agentic plugin & MCP server** for Israeli school portals (**Mashov / משו״ב** and **Webtop / SmartSchool**), packaged to install cleanly in **Claude**, **Antigravity**, and **ChatGPT / Codex**.
  3. ## Features
  4. - **Cross-Platform Plugin Structure:** Includes native manifests and skills for Claude Code / Marketplace (`.claude-plugin/` + `.mcp.json`), Claude Desktop (`manifest.json`), Antigravity (`.antigravity-plugin/` + `mcp_config.json` + `rules/AGENTS.md`), and ChatGPT / OpenAI Agent Plugins & Codex (`plugin.json` + `mcp.json` + `.codex-plugin/`), sharing portable `skills/`.
  5. - **Zero-Redundant-Login Session Store:** Persists Mashov (`X-Csrf-Token` + cookies) and Webtop (`webToken`) sessions for 12 hours, re-authenticates once on expiration, and enforces a 30-minute / 2-hour circuit breaker on failures so parents don't get spammed with login SMS alerts.
  6. - **Multi-Account & Auto-Discovery:** Supports any combination of Mashov and Webtop parent/student accounts and automatically discovers linked children, grades, and classes.
  7. - **Smart Enrichment:**
  8. - Infers missing homework due dates from the child's weekly timetable (skipping Shabbat).
  9. - Classifies behavior & attendance events (`positive`, `negative`, `attendance`, `note`).
  10. - Downloads and extracts text from `.pdf` and `.docx` message attachments and links study materials to upcoming exams.
  11. - Optional per-student public Google Exam Calendar `.ics` filtering by grade, class, and tracks.
  12. ---
  13. ## Installing as a Plugin
  14. ### 1. Claude (Claude Desktop App, Cowork & Claude Code)
  15. * **Claude Desktop Chat (1-Click Desktop Extension `.mcpb` — Recommended for non-developers):**
  16. Regular Claude Desktop Chat does **not** run `.mcp.json` `stdio` servers from GitHub marketplace plugins (it only syncs their `SKILL.md`s). Instead, download `il-school-mcp.mcpb` from [GitHub Releases](https://github.com/hagaija/il-school-mcp/releases) and open/drop it in **Claude Desktop → Settings → Extensions**. Claude Desktop will prompt you for Mashov/Webtop credentials directly in a native GUI form on install.
  17. * **Claude Code / Cowork (GitHub marketplace):**
  18. ```text
  19. /plugin marketplace add hagaija/il-school-mcp
  20. /plugin install il-school@il-school-marketplace
  21. ```
  22. *(On first question, Claude will provide a `http://127.0.0.1:...` setup link via `school_open_setup` if no accounts are configured yet.)*
  23. * **Manual MCP entry (`claude_desktop_config.json`):**
  24. ```json
  25. {
  26. "mcpServers": {
  27. "il-school": {
  28. "command": "node",
  29. "args": ["/ABS/PATH/TO/il-school-mcp/bundle/server.cjs"]
  30. }
  31. }
  32. }
  33. ```
  34. ### 2. Antigravity
  35. Clone and install directly via CLI:
  36. ```bash
  37. git clone https://github.com/hagaija/il-school-mcp.git
  38. agy plugin install ./il-school-mcp
  39. ```
  40. Restart Antigravity after installing a new plugin directory, then ask one of the starter prompts or invoke `/il-school-assistant` / `/il-school-setup`.
  41. ### 3. ChatGPT / OpenAI Agent Plugins & Codex
  42. * **Codex / Agent Plugin marketplace:**
  43. Uses root `plugin.json` + `mcp.json`, `.agents/plugins/marketplace.json`, and `.codex-plugin/plugin.json` + `.mcp.json`:
  44. ```bash
  45. codex marketplace add hagaija/il-school-mcp
  46. ```
  47. Or manually in `~/.codex/config.toml`:
  48. ```toml
  49. [mcp_servers.il-school]
  50. command = "node"
  51. args = ["/ABS/PATH/TO/il-school-mcp/scripts/launch-mcp.mjs"]
  52. ```
  53. * **Standard ChatGPT Desktop chat mode:** Requires a remote HTTPS MCP endpoint. Run the built-in Streamable HTTP server locally with a bearer token and expose it privately over Tailscale Funnel or Cloudflare Tunnel:
  54. ```bash
  55. node /ABS/PATH/TO/il-school-mcp/dist/index.js --http --port 3333 --token "your-secret-token"
  56. ```
  57. Endpoint: `https://<your-tunnel-host>/mcp`
  58. ---
  59. ## First-Time Setup & Modifying Config
  60. Credentials are kept **strictly local** in `~/.config/il-school-mcp/config.json` (`0600`) and are never entered into LLM chat.
  61. ```bash
  62. node scripts/launch-mcp.mjs setup
  63. ```
  64. - **On first run (no config yet):** Launches the onboarding flow to search Mashov schools by name (or enter `semel`), add Mashov/Webtop credentials, test login live, and show discovered students.
  65. - **When run again:** Opens a reconfiguration menu to **add**, **edit** (update password/`semel`/label), or **remove** accounts, configure **student overrides** (nicknames, aliases, exam `.ics` calendar URLs, tracks), and adjust **general settings** (timezone, cache TTL, quiet hours, attachment downloads).
  66. Verify connectivity anytime:
  67. ```bash
  68. node scripts/launch-mcp.mjs doctor
  69. ```
  70. ---
  71. ## Bundled Skills & Agent Guide
  72. * `AGENTS.md`: Instructions for running, configuring, and testing the MCP server.
  73. * `skills/il-school-assistant/SKILL.md`: Daily briefings, schedules, homework, exam prep, and behavior reporting rules.
  74. * `skills/il-school-setup/SKILL.md`: First-time onboarding & reconfiguration workflow when `needsSetup: true` is detected.
  75. * `rules/AGENTS.md`: Always-on Antigravity plugin rules.
  76. ## Available MCP Tools
  77. 1. `school_list_students` — Lists auto-discovered children, classes, and portals (or `needsSetup: true` before initial setup).
  78. 2. `school_get_schedule` — Timetable for `today`, `tomorrow`, weekday name, `YYYY-MM-DD`, or `week`.
  79. 3. `school_get_homework` — Homework assignments (with `dueDateInferred` estimation).
  80. 4. `school_get_behavior` — Behavior & attendance events (`positive`, `negative`, `attendance`, `note`).
  81. 5. `school_get_exams` — Upcoming exams + linked study materials (`provided` vs. `missing`).
  82. 6. `school_get_messages` — School inbox messages + extracted PDF/DOCX attachment text.
  83. 7. `school_get_digest` — Consolidated daily/tomorrow family briefing.
  84. 8. `school_open_setup` — Opens a local `127.0.0.1` browser setup page so GUI users can configure or edit Mashov/Webtop accounts without using a terminal or sharing passwords in chat.
  85. ---
  86. ## Acknowledgments, Disclaimer & License
  87. - **Credits:** Webtop (SmartSchool) API endpoint integration was informed by Tomer Klein's open-source [`pywebtop`](https://github.com/t0mer/pywebtop) (MIT License) as well as community-documented Mashov API conventions.
  88. - **Disclaimer:** This project is an unofficial, independent read-only client and is not affiliated with, endorsed by, or supported by Mashov or SmartSchool/Webtop.
  89. - **License:** [MIT](LICENSE) © 2026 Hagai Jacobson.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.