Skip to main content
Glama

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>&1

Key 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-run

Match 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

search_courses

Full-text search the catalog

get_course

Full detail: prereqs, sections, core codes

get_prereq_tree

Prereq AST annotated with course titles

check_eligibility

Which courses you can take given your transcript

get_sections

Sections with meeting times, instructors, open status

get_professor

RMP rating + match confidence + courses they teach

get_fill_stats

Historical fill rate for a section index

get_requirements_progress

CS BS degree progress by bucket

solve_semester_schedule

Top-k conflict-free schedules with CP-SAT

validate_plan

Check a manually-edited schedule for conflicts

solve_degree_plan

Multi-semester degree plan with prereq ordering

get_user_profile / set_user_profile

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 strings

Tests use synthetic in-memory SQLite — no network, no real DB required.

Install Server
F
license - not found
A
quality
B
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

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