PAIDEIA MCP
PAIDEIA MCP is a local server that builds and manages a personalized study graph for exam preparation (math, physics, engineering), integrating with Alt to ingest course materials, analyze patterns, generate study artifacts, and orchestrate a local model — all via 27+ tools.
Course Setup & Management
Initialize a course folder with full skeleton (
init_course), or bootstrap with Alt notes in one call (bootstrap_alt_course)Check current study phase, days until exam, and top missed patterns (
course_phase)Diagnose install health, dependencies, and folder readiness (
paideia_doctor)
Content Ingestion
Import single or batch Alt note transcripts into course materials (
import_alt_note,import_alt_notes)OCR all course PDFs to markdown via Qwen3-VL (Ollama) or Tesseract (
ingest_pdfs)OCR a single hand-written answer PDF (
grade_pdf)Parse and import Exam Radar exports to update coverage and seed gold-zone weakmaps (
import_exam_radar,parse_exam_radar_export)
Course Analysis & Index
Draft a course index with summaries, patterns, and coverage from all converted materials (
build_course_index,save_course_index)Filter patterns by label or keyword (
pattern_lookup)Identify high-priority topics by homework density and exam relevance (
hwmap)Generate a compact, timestamped weakmap from the error log (
generate_weakmap)
Artifact Management & Error Tracking
List, read, and write any markdown artifact in the course folder (
list_artifacts,read_artifact,write_artifact)Save model-generated outputs (quizzes, mock exams, derivations, cheatsheet) to canonical paths (
save_action_artifact)Save grading reports and append structured error entries to
errors/log.md(save_grade_report,append_error)
PAIDEIA Action Orchestration (Alt Integration)
Parse a PAIDEIA repo into a canonical action catalog (
parse_paideia_repo)List all available PAIDEIA actions (
list_paideia_actions)Compose full instructions, workspace context, and output contract for Alt's local model to execute any action (
prepare_paideia_action)Return a machine-readable capability manifest mapping every action to required tools and steps (
alt_capability_manifest)Provide workflow guides for bootstrapping, lecture-to-quiz, first drill, and Exam Radar import (
alt_workflow_guide)
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@PAIDEIA MCP Initialize a new course folder for Calculus I"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Using Alt instead of Claude Code, Codex, or opencode? Same tool, same on-disk layout, same license — re-homed as a local MCP server. The original PAIDEIA is a Claude Code plugin; this edition is a self-contained stdio MCP server that owns the local folder contract, markdown artifact writes, Exam Radar imports, repo/skill parsing, and the deterministic heavy work, so Alt's local model can drive the same study graph. The graph it builds is byte-for-byte identical and portable across all editions.
Security notice. PAIDEIA MCP installs as a local stdio MCP server — a
pip install -e .Python package you point Alt at — and never asks you to download a.zip, run an.exe, or use any installer. Any other repository using the PAIDEIA name is not affiliated with this project unless it is explicitly linked from this README.
What Paideia means
In ancient Greece, Παιδεία was never the deposit of facts into a passive student. It was the lifelong formation of a complete human being — through structured encounter with primary texts, guided practice under a master, and reflective dialogue that folds feedback into deeper revision.
This MCP server implements that cycle for the specific, bounded problem of exam preparation in math, physics, and engineering courses:
ingest ──▶ analyze ──▶ drill ──▶ grade ──▶ weakmap ──▶ cheatsheet
▲ │
└────────────────── feedback loop ───────────────────────┘Every stage produces a markdown artifact that lives in your course folder forever. Nothing is ephemeral. Nothing is hidden behind an API. Nothing stops working when the next funding winter hits.
Related MCP server: rolldeep
Why an MCP edition
PAIDEIA was born as a Claude Code plugin. The heavy lifting — parallel vision ingest, strategy grading, pattern extraction from your solutions — never depended on Claude specifically; it depended on any host that can run instructions against a course folder. Alt captures lectures and runs a local model, but it is not an agentic CLI with skills and subagents. So instead of porting the verbs, this edition re-homes the deterministic core into a standalone local stdio MCP server.
Goal: make the same durable PAIDEIA course folder usable from Alt, not just Claude Code / Codex / opencode. The server owns the local folder contract, markdown artifact writes, Exam Radar imports, repo/skill parsing, and deterministic heavy work; Alt's local model supplies the generation step.
Alt chat / local model
|
v
PAIDEIA MCP (local stdio)
|
v
~/courses/my-course/
.course-meta
materials/ converted/ course-index/ errors/ weakmap/
quizzes/ mock/ twins/ chain/ derivations/ cheatsheet/The study graph on disk is byte-for-byte the same as every other edition. course-index/patterns.md, errors/log.md, weakmap/weakmap_<ts>.md, cheatsheet/final.md — all the artifacts the Claude edition writes, this edition also writes, in the same format. Fork a course folder between editions and the new runner picks up without friction.
Alt Setup
Install dependencies from this folder:
python3 -m pip install -e .On Homebrew-managed Python, use a virtual environment if pip reports an externally-managed environment:
python3 -m venv .venv
source .venv/bin/activate
python -m pip install -e .In Alt's MCP server dialog, choose the local stdio transport and use:
명령어: /absolute/path/to/PAIDEIA-mcp/.venv/bin/python
전송 방식: 로컬 (stdio)
인수:
-m
paideia_mcp.bootstrap
글로벌 채팅에서 사용: on
이름: PAIDEIA
작업 디렉터리: /absolute/path/to/PAIDEIA-mcp
환경 변수:
PAIDEIA_MCP_AUTO_INSTALL = 0You can print these exact fields for your current checkout:
python3 scripts/alt_setup.py
# or, after install
paideia-alt-setupImportant: the 인수 box takes one argument per line. Do not put
python3 -m paideia_mcp.bootstrap all in the 명령어 field.
If you did not create .venv, use this lighter setup instead:
명령어: python3
전송 방식: 로컬 (stdio)
인수:
-m
paideia_mcp.bootstrap
글로벌 채팅에서 사용: on
이름: PAIDEIA
작업 디렉터리: /absolute/path/to/PAIDEIA-mcp
환경 변수:
PAIDEIA_MCP_AUTO_INSTALL = 1If Alt asks for a single command string instead of command/args fields:
python3 -m paideia_mcp.bootstrapTransport/auth in Alt:
Transport: local / stdio
Auth: none
Server URL: leave empty for stdioThe bootstrap entrypoint installs missing Python package dependencies into the
current user's site-packages before importing the MCP server. Set
PAIDEIA_MCP_AUTO_INSTALL=0 to disable that behavior and fail with the manual
pip install command instead.
See examples/alt-local-stdio.json for a reference snippet. Treat it as a
field map, not a guaranteed Alt export format.
Before adding it to Alt, you can test the exact stdio path:
python3 scripts/smoke_stdio.pyTo diagnose an install or course folder:
python3 scripts/doctor.py --project-root /absolute/path/to/course
# or, after `python3 -m pip install -e .`
paideia-doctor --project-root /absolute/path/to/courseThe current Alt plugin SDK exposes notes/AI/storage/files, but not a plugin-side MCP client API. The intended bridge is:
Alt SDK reads notes with
alt.notes.list/alt.notes.getContent.Alt's MCP-enabled local model or host integration calls PAIDEIA MCP with those note payloads.
PAIDEIA MCP writes the durable local course folder.
See examples/alt-sdk-note-handoff.ts for the SDK-side payload shape.
How Alt Uses It
There are two classes of tools.
Deterministic tools
These tools write/read PAIDEIA artifacts directly:
Tool | Purpose |
| Create the course folder skeleton, |
| Render/OCR |
| Render/OCR one scanned answer PDF into |
| Draft |
| Return setup/diag/drill/mock/cram/cool, D-day, and top miss. |
| Parse Exam Radar's |
| Filter |
| Return HW-density exam-priority rows from |
| Write a compact timestamped weakmap from |
| Take an Alt active note title/transcript and write durable |
| Batch-import multiple Alt note payloads from |
| Initialize a PAIDEIA course folder and import an initial Alt note batch in one call. |
| Save model-generated PAIDEIA outputs to canonical paths such as |
| Save local-model analyze outputs to |
| Save local-model grading feedback under |
| Safe local artifact operations under the course root. |
| Return the same Alt operating policy as a tool for clients that do not expose MCP prompts. |
| Diagnose install health, dependencies, course readiness, action prerequisites, and next steps. |
PAIDEIA repo parser / action composer
These tools make all PAIDEIA actions available to Alt's local model:
Tool | Purpose |
| Parse |
| List the 16 PAIDEIA actions Alt can perform. |
| Return the original PAIDEIA instruction, current course context, required artifacts, output hints, and write-tool contract for one action. |
The parser understands the source formats used across OPTIMETA's PAIDEIA line:
Codex skill folders (plugins/paideia/skills/paideia-*/SKILL.md), Claude
command markdown (plugins/paideia/commands/*.md), PAIDEIA-Hermes command
markdown (commands/*.md) plus mapped Hermes skills, and opencode prompt files
(assets/prompts/*.md). Canonical PAIDEIA actions are normalized to the same
16-action surface; source-only helpers such as doctor are preserved as
extra_actions in the manifest/catalog.
The important pattern is:
Alt calls
bootstrap_alt_coursefor a new course with selected note transcripts, orimport_alt_notes/import_alt_notefor later lecture transcripts.Alt calls
prepare_paideia_action(action="quiz", args="weakmap 5").Alt's local model drafts the PAIDEIA artifact using the returned instruction.
Alt calls
save_action_artifactto save standard outputs, orwrite_artifactfor explicit paths likecourse-index/summary.md. For analyze, Alt callssave_course_index; for grading reports with mistakes, Alt callssave_grade_report.If a failed/revised attempt should shape future study, Alt calls
append_erroror includes the errors insave_grade_report.
This is how plugin-like PAIDEIA behavior becomes possible without Claude Code: MCP supplies the durable local graph, action recipes, and instructions; Alt's local model supplies the generation step.
For model-first integration, call alt_capability_manifest or read
paideia://alt/manifest. It returns a JSON map from every canonical PAIDEIA
action to the MCP tools and local-model steps needed to execute it.
MCP Prompts
If Alt exposes MCP prompts, the server publishes five ready-to-use operating prompts:
paideia-operating-guide
paideia-course-bootstrap
paideia-lecture-to-quiz
paideia-attempt-first-drill
paideia-exam-radar-importIf the client only exposes tools, call alt_workflow_guide with one of:
operating-guide, course-bootstrap, lecture-to-quiz,
attempt-first-drill, or exam-radar-import.
MCP Resources
If Alt exposes MCP resources, the server publishes:
paideia://alt/manifest JSON action/tool manifest for local-model orchestration
paideia://alt/system-prompt default operating prompt for Alt local modelsTool Inventory
Current tool discovery should show 54 tools: 27 canonical tool names plus 27
Alt-search namespace aliases. If Alt searches for PAIDEIA__init_course, use
the alias directly; it routes to the same handler as init_course.
ingest_pdfs
grade_pdf
build_course_index
course_phase
init_course
parse_paideia_repo
list_paideia_actions
prepare_paideia_action
list_artifacts
read_artifact
write_artifact
import_alt_note
import_alt_notes
bootstrap_alt_course
save_action_artifact
save_course_index
save_grade_report
append_error
parse_exam_radar_export
import_exam_radar
pattern_lookup
hwmap
generate_weakmap
alt_workflow_guide
alt_capability_manifest
alt_setup_instructions
paideia_doctorEvery canonical tool above is also exposed with a PAIDEIA__ prefix, for
example PAIDEIA__init_course, PAIDEIA__write_artifact, and
PAIDEIA__alt_setup_instructions. These aliases exist because Alt's tool
search may look for server-prefixed names.
In Alt chat, call PAIDEIA MCP tools directly by name. Do not use
alt_tool_search_bm25 with category: "alt" to find PAIDEIA tools; that
category searches Alt-native note tools, not connected MCP server tools.
Engines
Both engines OCR fully in-process — the MCP writes finished markdown to the course folder with no external agent's vision step. This matters for Alt, whose plugin sandbox cannot read page images: a host-vision engine would be inert here, so PAIDEIA MCP does the OCR itself.
Engine | Default? | Needs | Quality on handwriting | Quality on slides |
| yes |
| high, offline | high, offline |
| no |
| low | medium |
qwen3-vl is the default. When Ollama is unreachable or the model isn't
pulled, it falls back to tesseract automatically so a default install
still produces output; the provenance header and grade tier record which engine
actually ran. Pick tesseract outright for the lightest, no-download path.
Notes for Alt Integration
This MCP server can write markdown files and append YAML logs inside a local PAIDEIA course folder.
It does not automatically read Alt's private note database. Alt should pass active/selected note title/transcript/memo/summary payloads into
bootstrap_alt_course,import_alt_notes, orimport_alt_note.import_exam_radaralready accepts the fixed markdown emitted by Exam Radar's copy button.alt_capability_manifest/paideia://alt/manifestgives Alt's local model the complete action-to-tool recipe table.prepare_paideia_actionplussave_action_artifact,save_course_index, andsave_grade_reportis the bridge for the rest of PAIDEIA: quiz, twin, blind, chain, mock, derive, cheatsheet, weakmap, analyze, and grade workflows can all be driven by Alt's local model using the returned instructions plus canonical artifact writes.
What ships
paideia_mcp/
├── bootstrap.py dependency preflight + server launcher
├── server.py stdio entrypoint, tool registration
├── repo_parser.py parses PAIDEIA skills/prompts into an action catalog
├── action.py composes instructions/context for Alt local models
├── alt_manifest.py machine-readable Alt action/tool manifest
├── workspace.py safe course-folder read/write/init and typed artifact writers
├── exam_radar.py imports Exam Radar exam-radar:v1 exports
├── study_tools.py hwmap/pattern/weakmap helpers
├── ingest.py ingest_pdfs tool (render + in-process OCR → converted/**)
├── grade.py grade_pdf tool (render + in-process OCR → answers/converted/)
├── analyze.py build_course_index tool
├── phase.py course_phase tool
└── ocr/
├── __init__.py engine dispatch + qwen3-vl→tesseract fallback
├── qwen3vl.py local Ollama Qwen3-VL 8B
└── tesseract.py pytesseract eng and/or kor (whichever is installed)OCR runs entirely inside the MCP process via these two engines — there's no
host-vision (codex-native / openai_vision.py) path, because Alt's plugin
sandbox can't read page images, so an engine that defers OCR to the host would
produce nothing here. qwen3-vl (default) falls back to tesseract when Ollama
is unavailable, so the two-engine set is self-sufficient.
Connect
License
MIT. Use freely. Fork and modify for your own courses — the point of PAIDEIA is that the study graph it builds is yours to shape, not a fixed product you have to live with.
Available Tools
54 toolsalt_capability_manifestB
Return the machine-readable Alt manifest: setup, SDK boundary, PAIDEIA rules, and action-to-tool recipes for all 16 actions.
Inputs: repo_root, project_root.
alt_setup_instructionsA
Return exact field-by-field values for Alt's local (stdio) MCP server form: command, one-argument-per-line args, name, cwd, and env.
Inputs: prefer_venv, server_name, auto_install, package_root.
alt_workflow_guideC
Return an Alt-local-model PAIDEIA operating guide. This mirrors the MCP prompts for clients that only expose tools.
Inputs: scenario, project_root.
append_errorB
Append one canonical YAML error entry to errors/log.md.
Inputs: source (required), pattern (required), summary (required), error_type (required), +3 more.
bootstrap_alt_courseC
Create a PAIDEIA course folder and import an initial batch of Alt note transcripts in one call.
Inputs: exam_date (required), course_name (required), project_root (required), notes, +8 more.
build_course_indexC
Inventory converted/ markdown files and write a draft course-index/{summary,patterns,coverage}.md baseline.
Inputs: force, weak_zones, project_root.
course_phaseA
Return the artifact-derived course phase (setup/diag/drill/mock/cram/cool), days_until_exam, and top_miss_pattern.
Inputs: project_root.
generate_weakmapC
Generate a compact timestamped weakmap from errors/log.md.
Inputs: concept, project_root.
grade_pdfA
OCR a single hand-written answer PDF into answers/converted/.md with a confidence tier.
Inputs: path (required), engine, project_root.
hwmapB
Read course-index/coverage.md and return HW-density exam-priority rows.
Inputs: mode, project_root.
import_alt_noteC
Import an Alt active note/transcript into materials/ and optionally converted/ for PAIDEIA analysis.
Inputs: title (required), transcript (required), memo, note_id, +5 more.
import_alt_notesB
Batch-import Alt note payloads from alt.notes.getContent into materials/ and converted/.
Inputs: notes (required), category, overwrite, project_root, +2 more.
import_exam_radarC
Import Exam Radar into radar.md, coverage.md annotation, and a gold-zone weakmap.
Inputs: export_md (required), course_name, project_root.
ingest_pdfsA
Render every materials/**/*.pdf to markdown via the selected OCR engine. Idempotent unless force=True.
Inputs: force, engine, categories, project_root.
init_courseC
Create a PAIDEIA local course folder skeleton for Alt or any MCP client.
Inputs: exam_date (required), course_name (required), project_root (required), git_init, +3 more.
list_artifactsB
List markdown artifacts in a PAIDEIA course folder.
Inputs: glob_pattern, project_root.
list_paideia_actionsC
List PAIDEIA actions available to Alt's local model.
Inputs: repo_root.
PAIDEIA__alt_capability_manifestA
PAIDEIA namespace alias for alt_capability_manifest. Use this exact name when Alt searches for PAIDEIA__alt_capability_manifest. Return the machine-readable Alt manifest: setup, SDK boundary, PAIDEIA rules, and action-to-tool recipes for all 16 actions.
Inputs: repo_root, project_root.
PAIDEIA__alt_setup_instructionsC
PAIDEIA namespace alias for alt_setup_instructions. Use this exact name when Alt searches for PAIDEIA__alt_setup_instructions. Return exact field-by-field values for Alt's local (stdio) MCP server form: command, one-argument-per-line args, name, cwd, and env.
Inputs: prefer_venv, server_name, auto_install, package_root.
PAIDEIA__alt_workflow_guideA
PAIDEIA namespace alias for alt_workflow_guide. Use this exact name when Alt searches for PAIDEIA__alt_workflow_guide. Return an Alt-local-model PAIDEIA operating guide. This mirrors the MCP prompts for clients that only expose tools.
Inputs: scenario, project_root.
PAIDEIA__append_errorC
PAIDEIA namespace alias for append_error. Use this exact name when Alt searches for PAIDEIA__append_error. Append one canonical YAML error entry to errors/log.md.
Inputs: source (required), pattern (required), summary (required), error_type (required), +3 more.
PAIDEIA__bootstrap_alt_courseB
PAIDEIA namespace alias for bootstrap_alt_course. Use this exact name when Alt searches for PAIDEIA__bootstrap_alt_course. Create a PAIDEIA course folder and import an initial batch of Alt note transcripts in one call.
Inputs: exam_date (required), course_name (required), project_root (required), notes, +8 more.
PAIDEIA__build_course_indexB
PAIDEIA namespace alias for build_course_index. Use this exact name when Alt searches for PAIDEIA__build_course_index. Inventory converted/ markdown files and write a draft course-index/{summary,patterns,coverage}.md baseline.
Inputs: force, weak_zones, project_root.
PAIDEIA__course_phaseA
PAIDEIA namespace alias for course_phase. Use this exact name when Alt searches for PAIDEIA__course_phase. Return the artifact-derived course phase (setup/diag/drill/mock/cram/cool), days_until_exam, and top_miss_pattern.
Inputs: project_root.
paideia_doctorB
Diagnose PAIDEIA MCP install health, external dependencies, course-folder readiness, action prerequisites, and next steps.
Inputs: repo_root, project_root.
PAIDEIA__generate_weakmapC
PAIDEIA namespace alias for generate_weakmap. Use this exact name when Alt searches for PAIDEIA__generate_weakmap. Generate a compact timestamped weakmap from errors/log.md.
Inputs: concept, project_root.
PAIDEIA__grade_pdfA
PAIDEIA namespace alias for grade_pdf. Use this exact name when Alt searches for PAIDEIA__grade_pdf. OCR a single hand-written answer PDF into answers/converted/.md with a confidence tier.
Inputs: path (required), engine, project_root.
PAIDEIA__hwmapA
PAIDEIA namespace alias for hwmap. Use this exact name when Alt searches for PAIDEIA__hwmap. Read course-index/coverage.md and return HW-density exam-priority rows.
Inputs: mode, project_root.
PAIDEIA__import_alt_noteC
PAIDEIA namespace alias for import_alt_note. Use this exact name when Alt searches for PAIDEIA__import_alt_note. Import an Alt active note/transcript into materials/ and optionally converted/ for PAIDEIA analysis.
Inputs: title (required), transcript (required), memo, note_id, +5 more.
PAIDEIA__import_alt_notesC
PAIDEIA namespace alias for import_alt_notes. Use this exact name when Alt searches for PAIDEIA__import_alt_notes. Batch-import Alt note payloads from alt.notes.getContent into materials/ and converted/.
Inputs: notes (required), category, overwrite, project_root, +2 more.
PAIDEIA__import_exam_radarC
PAIDEIA namespace alias for import_exam_radar. Use this exact name when Alt searches for PAIDEIA__import_exam_radar. Import Exam Radar into radar.md, coverage.md annotation, and a gold-zone weakmap.
Inputs: export_md (required), course_name, project_root.
PAIDEIA__ingest_pdfsA
PAIDEIA namespace alias for ingest_pdfs. Use this exact name when Alt searches for PAIDEIA__ingest_pdfs. Render every materials/**/*.pdf to markdown via the selected OCR engine. Idempotent unless force=True.
Inputs: force, engine, categories, project_root.
PAIDEIA__init_courseC
PAIDEIA namespace alias for init_course. Use this exact name when Alt searches for PAIDEIA__init_course. Create a PAIDEIA local course folder skeleton for Alt or any MCP client.
Inputs: exam_date (required), course_name (required), project_root (required), git_init, +3 more.
PAIDEIA__list_artifactsC
PAIDEIA namespace alias for list_artifacts. Use this exact name when Alt searches for PAIDEIA__list_artifacts. List markdown artifacts in a PAIDEIA course folder.
Inputs: glob_pattern, project_root.
PAIDEIA__list_paideia_actionsA
PAIDEIA namespace alias for list_paideia_actions. Use this exact name when Alt searches for PAIDEIA__list_paideia_actions. List PAIDEIA actions available to Alt's local model.
Inputs: repo_root.
PAIDEIA__paideia_doctorB
PAIDEIA namespace alias for paideia_doctor. Use this exact name when Alt searches for PAIDEIA__paideia_doctor. Diagnose PAIDEIA MCP install health, external dependencies, course-folder readiness, action prerequisites, and next steps.
Inputs: repo_root, project_root.
PAIDEIA__parse_exam_radar_exportC
PAIDEIA namespace alias for parse_exam_radar_export. Use this exact name when Alt searches for PAIDEIA__parse_exam_radar_export. Parse an OPTIMETA Exam Radar exam-radar:v1 markdown export.
Inputs: export_md (required).
PAIDEIA__parse_paideia_repoC
PAIDEIA namespace alias for parse_paideia_repo. Use this exact name when Alt searches for PAIDEIA__parse_paideia_repo. Parse a PAIDEIA repo into the canonical action catalog.
Inputs: repo_root.
PAIDEIA__pattern_lookupC
PAIDEIA namespace alias for pattern_lookup. Use this exact name when Alt searches for PAIDEIA__pattern_lookup. Filter course-index/patterns.md by Pk label or keyword.
Inputs: query, max_chars, project_root.
PAIDEIA__prepare_paideia_actionC
PAIDEIA namespace alias for prepare_paideia_action. Use this exact name when Alt searches for PAIDEIA__prepare_paideia_action. Compose the original PAIDEIA instruction, current workspace context, and output contract for an Alt local model to execute.
Inputs: action (required), args, repo_root, project_root, +1 more.
PAIDEIA__read_artifactC
PAIDEIA namespace alias for read_artifact. Use this exact name when Alt searches for PAIDEIA__read_artifact. Read a PAIDEIA course artifact by relative path.
Inputs: path (required), max_chars, project_root.
PAIDEIA__save_action_artifactB
PAIDEIA namespace alias for save_action_artifact. Use this exact name when Alt searches for PAIDEIA__save_action_artifact. Save a local-model-generated PAIDEIA action output to canonical paths such as quizzes/, twins/, mock/, derivations/, or cheatsheet/final.md.
Inputs: action (required), content (required), slug, overwrite, +3 more.
PAIDEIA__save_course_indexC
PAIDEIA namespace alias for save_course_index. Use this exact name when Alt searches for PAIDEIA__save_course_index. Save model-generated analyze outputs to course-index/summary.md, course-index/patterns.md, and course-index/coverage.md in one call.
Inputs: summary_md (required), coverage_md (required), patterns_md (required), overwrite, +1 more.
PAIDEIA__save_grade_reportC
PAIDEIA namespace alias for save_grade_report. Use this exact name when Alt searches for PAIDEIA__save_grade_report. Save a model-generated grading report under answers/converted/ and append any canonical error-log entries.
Inputs: slug (required), report_md (required), errors, source, +2 more.
PAIDEIA__write_artifactC
PAIDEIA namespace alias for write_artifact. Use this exact name when Alt searches for PAIDEIA__write_artifact. Write/append/create a PAIDEIA markdown artifact under the course root.
Inputs: path (required), content (required), mode, project_root, +1 more.
parse_exam_radar_exportC
Parse an OPTIMETA Exam Radar exam-radar:v1 markdown export.
Inputs: export_md (required).
parse_paideia_repoB
Parse a PAIDEIA repo into the canonical action catalog.
Inputs: repo_root.
pattern_lookupB
Filter course-index/patterns.md by Pk label or keyword.
Inputs: query, max_chars, project_root.
prepare_paideia_actionC
Compose the original PAIDEIA instruction, current workspace context, and output contract for an Alt local model to execute.
Inputs: action (required), args, repo_root, project_root, +1 more.
read_artifactC
Read a PAIDEIA course artifact by relative path.
Inputs: path (required), max_chars, project_root.
save_action_artifactB
Save a local-model-generated PAIDEIA action output to canonical paths such as quizzes/, twins/, mock/, derivations/, or cheatsheet/final.md.
Inputs: action (required), content (required), slug, overwrite, +3 more.
save_course_indexC
Save model-generated analyze outputs to course-index/summary.md, course-index/patterns.md, and course-index/coverage.md in one call.
Inputs: summary_md (required), coverage_md (required), patterns_md (required), overwrite, +1 more.
save_grade_reportC
Save a model-generated grading report under answers/converted/ and append any canonical error-log entries.
Inputs: slug (required), report_md (required), errors, source, +2 more.
write_artifactC
Write/append/create a PAIDEIA markdown artifact under the course root.
Inputs: path (required), content (required), mode, project_root, +1 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 54 tools
Every unique tool has a distinct target, but the full PAIDEIA__ alias set duplicates all 27 tools with identical descriptions, forcing agents to choose between two names for the same operation. Pairs like build_course_index/save_course_index and parse_exam_radar_export/import_exam_radar also overlap in output paths, further muddying boundaries.
Base tool names are consistently snake_case and mostly follow a verb_noun pattern (import_alt_note, save_action_artifact, list_artifacts), with a systematic PAIDEIA__ prefix for aliases. A few names break the verb pattern, such as hwmap, course_phase, and alt_setup_instructions, so it is not a perfect 5.
54 tools is unnecessarily heavy because 27 are exact PAIDEIA__ aliases, and even the 27 unique tools exceed the 25-tool comfort threshold. Several meta/helper tools (alt_workflow_guide, alt_capability_manifest, alt_setup_instructions, paideia_doctor) could likely be consolidated or exposed as prompts/resources instead of tools.
The set covers the main PAIDEIA lifecycle: importing notes/PDFs/Exam Radar, building indexes, generating weakmaps/HW maps, saving artifacts, logging errors, grading, and Alt integration. It lacks artifact deletion/rename and an end-to-end action execution tool, but agents can work around these gaps with write_artifact and prepare_paideia_action.
Maintenance
Related MCP Connectors
PDF and image tools for AI agents: compress, merge, split, OCR, sign. Runs locally, never uploads.
Every EmpirioLabs model and platform feature as tools: chat, media, search, jobs, GPU Cloud, agents.
Your org's AI agents, tasks, runs, search, and brain files as MCP tools and resources.
Git-backed platform for skills, tools, and context for AI agents
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables AI assistants to interact with local documents (PDF, Markdown, TXT) through tools for discovery, reading, extraction, summarization, comparison, keyword extraction, search, and analysis, ensuring privacy and offline capability.-
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to operate a local study lab by rolling one-time topics, choosing a card, and completing it with proof, while managing syllabi and progress locally.MIT
- AlicenseNot gradedqualityBmaintenanceEnables fully local, end-to-end research automation: reproducing papers from PDF into runnable code and verified artifacts, writing papers section-by-section with LaTeX/PDF/DOCX export, and running an ideate→debate→design→verdict research pipeline—all without an API key.2MIT
- AlicenseCqualityBmaintenanceEnables local-first model routing and persistent tool library management, allowing automated workflow detection and conversion of stable patterns into reusable tools.40Mozilla Public 2.0