Learning Hub

Beta— fully functional, tested with one family. Feedback and bug reports welcome viaGitHub Issues.

# Install dependencies poetry install # Initialize database poetry run alembic upgrade head

DATABASE_URL=sqlite+aiosqlite:///./data/learning_hub.db

{ "mcpServers": { "learning-hub": { "command": "poetry", "args": ["run", "learning-hub-mcp"], "cwd": "/path/to/learning-hub-mcp" } } }

- create_subject- create a new school subject
- list_subjects- list subjects (filter: school, is_active)
- update_subject- update subject details

- create_topic- create a topic for a subject
- list_topics- list topics (filter: subject_id, is_open)
- close_topic- close topic (reason: resolved/skipped/no_longer_relevant)

- add_grade- add a grade (1-5 scale, 1=best), auto-creates minute transaction
- list_grades- list grades (filter: subject, date range, school)

- create_bonus_task- create a bonus task linked to a topic (validates limits)
- list_bonus_tasks- list tasks (filter: status, topic)
- get_bonus_task- get a bonus task by ID
- get_latest_bonus_task- get the most recent bonus task
- apply_bonus_task_result- complete task, record grade, and update topic reviews
- cancel_bonus_task- cancel a task
- check_pending_bonus_task- check if there's a pending task to reuse

- get_balance- get current game minutes balance
- add_played_minutes- record played game time (deducts from balance)
- create_ad_hoc_transaction- create manual bonus or penalty
- list_transactions- list transactions (filter: date range, type)

- create_homework- create homework assignment
- list_homeworks- list homework (filter: status, subject)
- complete_homework- mark homework as done
- update_homework- update homework details
- close_overdue_homeworks- close overdue homework, auto-creates penalty transaction
- get_pending_homework_reminders- get reminders due (D-1, D-2)
- mark_homework_reminders_sent- mark reminders as sent

- add_book- add a book to the library
- list_books- list books (filter: subject, has_summary)
- get_book- get a book by ID
- update_book- update book details
- delete_book- delete a book

- list_topic_reviews- list topic reviews (filter: subject, status)
- get_pending_reviews_for_topic- get pending reviews for a topic
- mark_topic_reinforced- mark review as reinforced
- increment_topic_repeat_count- increment repeat count for a review
- get_priority_topic_for_review- pick a priority topic from top-4

- create_family_member- add a family member (student/parent/tutor/admin)
- list_family_members- list members (filter: role)
- update_family_member- update member details
- delete_family_member- delete a member
- get_student- get the student record

- create_gateway- register a messaging channel (Telegram, etc.)
- list_gateways- list gateways (filter: family_member, channel)
- update_gateway- update gateway details
- delete_gateway- delete a gateway
- lookup_gateway- find gateway by platform + external ID

- get_config- get a config value by key
- set_config- set a config value (existing keys only)
- list_configs- list all config entries

- set_secret- set a secret value (credentials, API keys)
- list_secrets- list secrets (keys only, values never exposed)

- list_sync_providers- list all sync providers with status
- update_sync_provider- activate/deactivate, link to school
- run_sync- run sync for all active providers (or a specific one)
- find_edupage_subdomain- detect EduPage school subdomain from stored credentials

- check_system_readiness- check if the system is properly configured (active schools, required configs)

- get_grades_pending_escalation- get grades needing parent notification
- mark_grades_escalated- mark grades as escalated (parent was notified)

- get_grade_escalation_instructions- escalate bad grades to tutor/admin
- get_learning_system_instructions- master instruction: full system rules
- get_student_request_router_instructions- classify student request (A/B/C scenarios)
- get_bonus_task_assignment_instructions- assign a new bonus task
- get_submission_routing_instructions- route submitted work to evaluator
- get_bonus_task_evaluation_instructions- evaluate completed bonus task
- get_homework_evaluation_instructions- evaluate homework submission
- get_book_lookup_instructions- find and deliver textbook pages
- get_books_workflow_instructions- process and register new books
- get_homework_manual_instructions- manually add homework (parent only)
- get_grade_manual_instructions- manually add a grade (adult only)
- get_student_content_policy_instructions- content safety filtering for external student content
- get_topic_review_curation_instructions- curate and close stale topic reviews
- get_base_crons_setup_instructions- instructions for setting up base cron jobs

Thelearning-hub-bridge/directory contains a TypeScript plugin that makes all MCP tools available as nativeOpenClawagent tools.

cp -r /path/to/learning-hub-mcp/learning-hub-bridge ~/.openclaw/extensions/learning-hub

cd ~/.openclaw/extensions/learning-hub npm install

{ "plugins": { "entries": { "learning-hub": { "enabled": true, "config": { "command": "/bin/bash", "args": ["-lc", "cd /path/to/learning-hub-mcp && exec .venv/bin/learning-hub-mcp"], "cwd": "/path/to/learning-hub-mcp", "toolPrefix": "learning_hub" } } } } }

Step 4.Allow tools for the agent inopenclaw.json:

{ "agents": { "list": [ { "id": "main", "tools": { "alsoAllow": ["learning-hub"] } } ] } }

When new tools are added to the MCP server, the bridge picks them up automatically on gateway restart — no bridge code changes needed. Just restart:

# Run tests poetry run pytest # Run tests with coverage poetry run pytest --cov=learning_hub # Lint code poetry run ruff check . # Fix lint issues poetry run ruff check --fix .

- Tested with a single family (one student, two schools: EduPage CZ + UA)
- PRONOTE sync implemented but minimally tested
- SQLite only — designed for single-family self-hosted use
- RequiresOpenClawas the AI agent runtime
- Edge cases with diverse school configurations are likely not yet covered

Hjarni includes a built-in MCP server for ChatGPT, Claude, and other compatible clients. Use this page as the protocol and capability reference. If you just want to connect an assistant, start with ChatGPT setup or Claude setup.