ScarletPlan
ScarletPlan is a Rutgers course planning assistant that combines live course catalog data, prerequisite checking, degree requirements tracking, schedule optimization, professor ratings, and section fill statistics to help students plan their academic career.
Course Search & Details (
search_courses,get_course): Search the catalog by free text, subject, level, and term; get full course info including prerequisites, sections, core codes, and credits.Prerequisite Analysis (
get_prereq_tree,check_eligibility): View annotated prerequisite trees for any course and check which courses a student is eligible to take based on their completed transcript.Section Information (
get_sections): List all sections for a course in a given term, including meeting times, instructors, and open/closed status.Professor Ratings (
get_professor): Look up RateMyProfessors data (avg rating, difficulty, would-take-again %) with match confidence scores and courses taught.Fill Rate Statistics (
get_fill_stats): Historical fill-rate stats showing how quickly sections fill, how long they stay closed, and how often they reopen.Degree Requirements Progress (
get_requirements_progress): Track per-bucket progress toward the CS BS degree, including satisfied and remaining courses and credits.Conflict-Free Schedule Optimization (
solve_semester_schedule): Generate up to k conflict-free schedules using CP-SAT, with preferences for start/end times, days off, and campus.Schedule Validation (
validate_plan): Check a manually edited schedule for time conflicts.Degree Plan Generation (
solve_degree_plan): Create a multi-semester plan respecting prereq ordering, credit limits, and pinned course placements toward a target graduation term.Student Profile Management (
get_user_profile,set_user_profile): Persistently store and retrieve student data (completed courses, graduation target, preferences) across sessions.
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.
HTTP transport (website / remote clients)
The server also speaks MCP over streamable HTTP for the planned web frontend — stateless with JSON responses, so multiple workers can run behind a load balancer:
uv run scarletplan-server --transport streamable-http --host 127.0.0.1 --port 8765
# endpoint: POST http://127.0.0.1:8765/mcpConfiguration (flags override env vars):
Env var | Flag | Default |
|
|
|
|
|
|
|
|
|
|
|
|
| — |
|
There is no auth on the HTTP transport: keep it bound to localhost and put the
website's authenticated backend in front of it. Every tool returns structured
JSON with error/caveats[] contracts (see docs/PRODUCTION_AUDIT.md), and a
health tool reports version, schema, and catalog freshness.
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
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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