create_subjectLABSCO SUMMARY
The rules of the household, written where the tutor can apply them.
Grades turn into game minutes by a table you set, homework pays a bonus when it is on time, and weak topics keep coming back until they have been repeated enough. Because it is one database per child, the tutoring session and the incentive scheme stay in step.
What it is
A per-student learning workflow server backed by SQLite. Subjects, grades on the 5-point European scale, topics needing work, homework with deadlines and bonus tasks all live in one database, and grades convert to game minutes through a map you configure. Each instance serves a single student; a second child gets a second instance.
What you get
- School subjects created, listed and updated, with multi-country support (UA, CZ, DE and others)
- Grades recorded on a 5-point scale where 1 is best and 5 is worst
- Topics opened for weak areas, listed, and closed once they stop needing review
- Homework tracked against deadlines, with on-time and overdue minute adjustments
- Bonus tasks that reward game minutes, capped at 4 pending and 15 completed in a rolling week
- Game minutes kept as an immutable ledger of what was earned and spent
- A textbook library with markdown summaries and indexed content
- Topic reviews that keep a weak area open until the repetition threshold for its grade is met
- Escalation notices to parents on a bad grade
- Pluggable sync providers — EduPage, PRONOTE — with credentials held in a secrets table
Requirements
Python with Poetry, plus one Alembic migration to create the database. It defaults to ./data/learning_hub.db, and an environment variable points it somewhere else. Runtime behaviour — the grade-to-minutes map, review thresholds, homework bonuses, default deadline time — lives in the database and is set through tools rather than a config file. The project describes itself as beta, tested with one family.
Setup effort
Build from source — git clone https://github.com/genyk1p/learning-hub-mcp.git
USE CASES
01
Setting up a child's school year
Create the subjects for the country's curriculum, then list them back to check nothing is missing.
02
Recording a grade and its consequence
Enter the grade; the configured map turns it into game minutes earned or lost and the ledger records the movement.
03
Tracking what still needs work
Open a topic for the material that went badly, so it shows up in review instead of being forgotten.
04
Closing out something that's been learned
Close the topic once the repetition threshold for its grade has been met, rather than guessing when it is done.
05
Keeping the subject list current
Adjust a subject when the timetable changes, without editing the database by hand.
72 tools
Listed in project docs. Your client may show a different list.
list_subjectsupdate_subjectcreate_topiclist_topicsclose_topicadd_gradelist_gradescreate_bonus_tasklist_bonus_tasksget_bonus_taskget_latest_bonus_taskapply_bonus_task_resultcancel_bonus_taskcheck_pending_bonus_taskget_balanceadd_played_minutescreate_ad_hoc_transactionlist_transactionscreate_homeworklist_homeworkscomplete_homeworkupdate_homeworkclose_overdue_homeworksget_pending_homework_remindersmark_homework_reminders_sentadd_booklist_booksget_bookupdate_bookdelete_booklist_topic_reviewsget_pending_reviews_for_topicmark_topic_reinforcedincrement_topic_repeat_countget_priority_topic_for_reviewcreate_family_memberlist_family_membersupdate_family_memberdelete_family_memberget_studentcreate_gatewaylist_gatewaysupdate_gatewaydelete_gatewaylookup_gatewayget_configset_configlist_configsset_secretlist_secretslist_sync_providersupdate_sync_providerrun_syncfind_edupage_subdomaincheck_system_readinessget_grades_pending_escalationmark_grades_escalatedget_grade_escalation_instructionsget_learning_system_instructionsget_student_request_router_instructionsget_bonus_task_assignment_instructionsget_submission_routing_instructionsget_bonus_task_evaluation_instructionsget_homework_evaluation_instructionsget_book_lookup_instructionsget_books_workflow_instructionsget_homework_manual_instructionsget_grade_manual_instructionsget_student_content_policy_instructionsget_topic_review_curation_instructionsget_base_crons_setup_instructionsBEFORE YOU INSTALL
What to know first
Tools you get
72 tools named in the project's documentation.
Requires
poetry on PATH
Where it runs
Both documented clients run the server on your machine.
INSTALLATION
Connect your client
You clone this one yourself.
Server setup
TERMINAL
git clone https://github.com/genyk1p/learning-hub-mcp.git
cd learning-hub-mcp
poetry install
poetry run alembic upgrade headMCP Clients
Any MCP client
ANY MCP CLIENT · JSON
{
"mcpServers": {
"learning-hub": {
"command": "poetry",
"args": [
"run",
"learning-hub-mcp"
],
"cwd": "<YOUR_PATH_TO_LEARNING_HUB_MCP>"
}
}
}OpenClaw — bridge plugin
OPENCLAW — BRIDGE PLUGIN · JSON
{
"plugins": {
"entries": {
"learning-hub": {
"enabled": true,
"config": {
"command": "/bin/bash",
"args": [
"-lc",
"cd <YOUR_PATH_TO_LEARNING_HUB_MCP> && exec .venv/bin/learning-hub-mcp"
],
"cwd": "<YOUR_PATH_TO_LEARNING_HUB_MCP>",
"toolPrefix": "learning_hub"
}
}
}
}
}
