ScarletPlan
Click on "Install 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., "@ScarletPlanPlan my remaining semesters for CS BS degree"
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.
ScarletPlan
Local-first Rutgers course planning assistant. Answers "what should I take and when?" using a CP-SAT solver, your real transcript, and live SOC data — running entirely on your machine, connected to Claude Desktop or Claude Code via MCP.
Disclaimer: ScarletPlan is not an official Rutgers tool. Always verify plans with Degree Navigator and your academic advisor.
What it does
Question | How |
What courses am I eligible for? | Prereq tree evaluation against your transcript |
Build me a conflict-free schedule | CP-SAT section optimizer with time/campus preferences |
Plan my remaining semesters | CP-SAT degree planner against CS BS requirements |
Will this section fill? | openSections fill-rate stats (grows over time) |
Who's a good professor for 344? | Cached RateMyProfessors ratings with name matching |
Related MCP server: konbu
Setup (5 commands)
Requirements: Python 3.11+, uv, Claude Desktop or Claude Code.
# 1. Clone and install
git clone https://github.com/heetshah15/scarletplan && cd scarletplan
uv sync
# 2. Build the database (ingest current + next term for NB)
uv run python scripts/setup.py
# 3. Start the MCP server (test it works)
uv run scarletplan-server
# 4. Add to Claude Desktop config (see below)
# 5. Start the openSections poller cron (see below)Claude Desktop config
Add this to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"scarletplan": {
"command": "uv",
"args": ["run", "--directory", "/absolute/path/to/scarletplan", "scarletplan-server"],
"env": {
"SCARLETPLAN_DB": "/absolute/path/to/scarletplan/scarletplan.db"
}
}
}
}Or see docs/claude_desktop_config.snippet.json for a ready-to-copy snippet.
Claude Code / Project Instructions
Paste this into your Claude project instructions (or .claude/instructions.md):
You are a Rutgers course planning assistant powered by ScarletPlan tools.
Rules:
- Always resolve course facts via tools, never from memory (SOC data changes).
- On first use: gather completed courses, target graduation, preferences via
set_user_profile so the student doesn't repeat themselves.
- Planning flow: get_requirements_progress → solve_degree_plan → present → iterate.
- Scheduling flow: solve_semester_schedule (k=3) → present tradeoffs →
validate_plan after any manual edits.
- Always surface caveats[] to the user, especially low-confidence ratings.
- End every degree plan with: "Verify this plan with Degree Navigator and your
academic advisor. ScarletPlan is not an official Rutgers tool."
- For professor ratings: always show match_confidence; flag anything below 85%.openSections poller (start now)
The fill-rate stats dataset only grows if the poller runs during registration windows. Add this cron job so data starts accumulating:
# Edit crontab: crontab -e
*/5 * * * * cd /path/to/scarletplan && \
uv run python -m scarletplan.poller.poll_open \
--year 2026 --term 9 >> poller.log 2>&1Key registration windows (when fill-rate data is most valuable):
November 2026 — spring 2027 registration
April 2027 — fall 2027 registration
January / September — add/drop chaos
RateMyProfessors ratings (optional)
RMP uses an unofficial GraphQL endpoint. Isolated and optional — if it breaks, all other tools continue working.
# Scrape once per semester, cache in DB
uv run python -m scarletplan.ingest.rmp.rmp_scraper --year 2026 --term 9
# Dry run to check match quality first
uv run python -m scarletplan.ingest.rmp.rmp_scraper --year 2026 --term 9 --dry-runMatch confidence ≥0.85 is reliable. 0.70–0.85 is surfaced as low-confidence. Below 0.70 is not stored.
MCP tools
Tool | What it does |
| Full-text search the catalog |
| Full detail: prereqs, sections, core codes |
| Prereq AST annotated with course titles |
| Which courses you can take given your transcript |
| Sections with meeting times, instructors, open status |
| RMP rating + match confidence + courses they teach |
| Historical fill rate for a section index |
| CS BS degree progress by bucket |
| Top-k conflict-free schedules with CP-SAT |
| Check a manually-edited schedule for conflicts |
| Multi-semester degree plan with prereq ordering |
| Persistent student profile |
Dev
uv run pytest # all tests
uv run pytest -m "not network" # skip live SOC tests
uv run python scripts/report_parse_failures.py # see unparsed prereq stringsTests use synthetic in-memory SQLite — no network, no real DB required.
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/heetshah15/scarletplan'
If you have feedback or need assistance with the MCP directory API, please join our Discord server