Skip to main content
Glama

FCPS School MCP

Schoology, StudentVUE, and TJHSST Ion, directly inside your AI assistant.

MIT License Node 22.13+ MCP

Local or self-hosted · No developer keys · No shared database · No developer-operated backend

An unofficial, open-source Model Context Protocol server for Fairfax County Public Schools students. It gives ChatGPT, desktop AI apps, and other MCP-compatible assistants live, read-only access to Schoology courses and materials plus official grades from SIS StudentVUE. TJHSST students can also connect Ion, the TJ intranet, for the bell schedule, announcements, and eighth period signups.

One command for local and remote apps

One-command setup

You need Node.js 22.13 or newer, an FCPS student account, and a free Vercel account. Run this in PowerShell, Command Prompt, Terminal, or any Linux shell:

npx --yes --allow-remote=all --ignore-scripts --package=https://github.com/jibberswrld/fcps-school-mcp/archive/refs/tags/v1.2.0.tar.gz fcps-school-mcp deploy

The command downloads the Vercel CLI, opens Vercel sign-in, and privately asks for your FCPS credentials once. It saves them only on your computer, configures any detected copy of Claude Desktop, Cursor, or Windsurf, creates a deployment in your Vercel account, and prints your private remote MCP URL.

Paste the printed URL into any AI app that supports adding a custom remote MCP server. Choose Streamable HTTP and No authentication if the app asks. The secret key is already part of the URL, so keep it private.

For ChatGPT, you need a plan that supports Developer mode. Enable Settings → Security → Developer mode, create a new app, choose No authentication, and paste the URL.

Your FCPS username, password, and URL key are sent directly to your Vercel project as Secret environment variables. They are not saved in this repository or sent to the project author. The deployment is dedicated to your account; there is no shared student database.

Related MCP server: Canvas MCP for students

Local-only setup

You need Node.js 22.13 or newer and an existing FCPS student account. Then run this in PowerShell, Command Prompt, Terminal, or any Linux shell:

npx --yes --allow-remote=all --ignore-scripts --package=https://github.com/jibberswrld/fcps-school-mcp/archive/refs/tags/v1.2.0.tar.gz fcps-school-mcp setup

Enter your FCPS username and password when prompted. Setup then asks whether you are a TJHSST student; answer yes to add your Ion username and password, or no to skip Ion entirely. The setup command saves credentials only on your computer and automatically configures any detected copy of Claude Desktop, Cursor, or Windsurf. Restart your AI app, and fcps-school will appear as an MCP server.

That is the entire local setup. You do not need a Schoology developer key, Supabase, Vercel, Docker, or a browser session.

What it can do

  • Show current StudentVUE grades, percentages, categories, and assignment scores.

  • Show full course history, cumulative GPA, credits earned toward the diploma, and past report cards.

  • Report whether each Schoology assignment has been submitted, when, and whether it was late.

  • Merge official StudentVUE scores into Schoology course and assignment results.

  • List Schoology courses, assignments, due dates, calendar events, and announcements.

  • Browse nested course-material folders, pages, documents, and assignment attachments.

  • Read Schoology PDF, DOCX, and PPTX attachments as text and page images, preserving diagrams, charts, equations, tables, and scanned worksheets. DOCX/PPTX files use Schoology’s PDF conversion.

  • View PNG, JPEG, and other supported image attachments directly, including drawings and photos.

  • For TJHSST students with Ion connected: read the bell schedule, school announcements, eighth period blocks and activities, your own signups, and sign you up for an eighth period activity.

Available tools

Tool

Purpose

schoology_get_profile

Signed-in Schoology profile

schoology_list_sections

Courses with official StudentVUE grades

schoology_get_assignments

Assignments, submission status, attachments, and matched scores

schoology_get_materials

List course materials or search titles, filenames, links, and folder paths

schoology_read_document

Read files, pages, assignments, and discussion prompts, including PDF page images

schoology_get_upcoming_events

Upcoming deadlines and events

schoology_get_calendar

Calendar events between two dates

schoology_get_recent_activity

Account-wide announcements and updates

schoology_get_section_updates

Updates for one course

studentvue_get_grades

Official current course marks and percentages

studentvue_get_assignments

Official assignment grades and category weights

studentvue_get_course_history

Past courses with final marks and credits, GPA, and credits toward the diploma

studentvue_list_documents

Report cards from past years and test score reports

studentvue_read_document

Text and page images from a report card or score report

school_check_login

Tests every login and reports exactly why one fails

TJHSST students who answered yes to the Ion question also get these tools:

Tool

Purpose

ion_get_profile

Signed-in Ion profile

ion_get_schedule

Bell schedule for a date or the next few days

ion_get_announcements

School announcements, newest first, searchable

ion_get_announcement

One announcement in full

ion_list_blocks

Eighth period blocks from a date

ion_get_block_activities

Activities offered in one block with capacity and restrictions

ion_get_my_signups

Your eighth period signups

ion_signup_eighth_period

Sign up for (or switch to) an eighth period activity. Changes real Ion state.

Submission status

Every assignment from schoology_get_assignments carries a submission object:

  • platform: "schoology" — a normal Schoology dropbox assignment. status is submitted (with submittedAt, late, revisions, and the submitted file names) or not_submitted.

  • platform: "external_tool" — the work is turned in inside an embedded tool such as Google Assignments. Schoology never records that turn-in, so status stays unknown until a grade appears.

  • platform: "assessment_v2" — a Schoology assessment. Its attempt state is not exposed by the API, so status is unknown.

Manual setup for another local MCP client

The setup command stores credentials even when it does not recognize your client. Add this stdio server entry to any client that accepts standard mcpServers configuration:

{
  "mcpServers": {
    "fcps-school": {
      "command": "npx",
      "args": [
        "--yes",
        "--allow-remote=all",
        "--ignore-scripts",
        "--package=https://github.com/jibberswrld/fcps-school-mcp/archive/refs/tags/v1.2.0.tar.gz",
        "fcps-school-mcp"
      ]
    }
  }
}

On Windows, use "command": "cmd" and put "/c", "npx" before the other arguments.

You can also skip stored credentials and provide SCHOOLOGY_USERNAME and SCHOOLOGY_PASSWORD as environment variables in your MCP client configuration.

Privacy and security

  • Local access runs only over stdio. The deploy command also creates an HTTPS remote MCP inside your own Vercel account.

  • During use, sends your FCPS credentials only to the official FCPS ForgeRock login service at aic.fcps.edu, and Ion credentials only to ion.tjhsst.edu; remote setup first stores them in your Vercel project as described above.

  • Makes read-only requests to official FCPS Schoology and StudentVUE services, plus Schoology's signed file CDN for requested attachments. The only write is ion_signup_eighth_period, which changes your own Ion eighth period signup when you ask for it.

  • Local setup stores credentials in your operating system's user configuration directory. On macOS and Linux, the file is created with 0600 permissions. A session.json cookie cache is kept next to it (also 0600) so restarting your AI client reuses the FCPS session instead of logging in again.

  • Remote setup stores credentials and the URL key as Vercel Secret environment variables and never writes them into the temporary deployment files.

  • Includes no telemetry, analytics, shared database, bundled student data, or developer-controlled backend.

  • Pauses logins for 15 minutes only when FCPS or Ion explicitly rejects the username or password (an hour when FCPS warns about a lockout). Network errors and expired sessions are retried immediately from a clean session, so a passing blip no longer blocks you.

Treat your local credential file and private MCP URL like passwords. Do not commit or share them. School data returned by the MCP is provided to the AI client you connect, so review that client's privacy terms and follow your school's technology policies.

Troubleshooting

The MCP does not appear after setup

Fully quit and reopen the MCP client. If your client was not detected, use the manual configuration above.

A tool says a login failed or is paused

Ask your assistant to run school_check_login. It tries Schoology, StudentVUE, and Ion and returns the exact reason for each failure, for example the message FCPS returned. A pause means FCPS or Ion rejected the password; re-run the setup command with the correct one. The pause is intentional because repeated FCPS login failures can lock an account.

Finding a specific course resource

Use schoology_get_materials with a section ID and a short query such as "unit 3 slides". Matches include their folder paths. Use readWith to open a match and nextSearchWith to continue a long result list. External tools are returned as browser links and may require a separate sign-in.

Reading diagrams, scans, and longer documents

schoology_read_document returns actual MCP image content alongside the existing text metadata. A vision-capable assistant can inspect diagrams, graph axes, formulas, handwriting, and scanned pages directly; the server does not send files to a separate OCR or AI service. The client must support image tool results and a vision-capable model.

Calls using only sectionId and documentId keep working and now include up to three page images across all attachments. Images are labeled with their attachment index and page number. Each file reports totalPages, renderedPages, and exact nextReadWith arguments for omitted pages or attachments. Use fileIndex (zero-based), startPage (one-based), and pageCount (1–3) to inspect a particular attachment or continue through a longer file. Set includeImages: false for a text-only client.

Text is capped at 45,000 characters and the first 200 pages on an initial read, and reports textTruncated when shortened. A startPage greater than 1 focuses the returned text on that page range. Each file's readWith arguments let you read it separately if the combined text is truncated. Images are scaled to at most 1,800 pixels on the longest side and 1 MB each; downloads are limited to 25 MB. An unreadable attachment is reported per file while other attachments remain available. Refresh your MCP client's tool definitions if the new page controls are missing.

A document has no extractable text

The file is probably a scan or image-only PDF. Its page images are still returned for your assistant to read visually. In text-only mode, enable includeImages to inspect it.

Remove saved credentials

Delete credentials.json and session.json from the path printed by the setup command, then remove fcps-school from your MCP client config.

Remove a remote deployment

Delete the generated fcps-school-mcp-* project from your Vercel dashboard and remove its URL from every AI app where you added it.

Development

git clone https://github.com/jibberswrld/fcps-school-mcp.git
cd fcps-school-mcp
npm install
npm test

Run npm run setup for local-only configuration, npm run deploy for local configuration plus a private remote Vercel deployment, or npm start to start the stdio server.

Scope and disclaimer

This release is intentionally FCPS-specific. Other districts use different Schoology tenants, identity providers, and StudentVUE deployments, so they are not supported by this package.

This project is unofficial and is not affiliated with or endorsed by Fairfax County Public Schools, PowerSchool/Schoology, or Edupoint/StudentVUE. Use it only with your own account and follow your school's technology policies.

License

MIT © 2026 Jabir O. Mohamed

Available Tools

12 tools
school_check_loginA

Test the FCPS (Schoology, StudentVUE) and, when configured, TJHSST Ion logins and report exactly why any of them fails. Use this first when another tool reports a login problem.

Inputs: no named parameters.

schoology_get_assignmentsB

List Schoology assignments with submission status (submitted, not submitted, or unknown), attachments, and matched StudentVUE scores.

Inputs: sectionId.

schoology_get_calendarC

Get Schoology calendar events between two ISO dates.

Inputs: end, start.

schoology_get_materialsC

List a course's nested folders, documents, pages, and assignments.

Inputs: sectionId (required).

schoology_get_profileB

Get the signed-in student's Schoology profile.

Inputs: no named parameters.

schoology_get_recent_activityB

Get account-wide Schoology announcements and course updates.

Inputs: no named parameters.

schoology_get_section_updatesC

Get recent posts for one Schoology section.

Inputs: sectionId (required).

schoology_get_upcoming_eventsC

Get upcoming Schoology events within 1 to 180 days.

Inputs: days.

schoology_list_sectionsB

List enrolled Schoology sections with official StudentVUE course grades.

Inputs: no named parameters.

schoology_read_documentC

Read text from a Schoology document or assignment attachment.

Inputs: sectionId (required), documentId (required).

studentvue_get_assignmentsC

Get official assignment grades from FCPS StudentVUE, optionally filtered by class or title.

Inputs: query, classId.

studentvue_get_gradesB

Get official current course marks and percentages from FCPS StudentVUE.

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 12 tools

    Disambiguation4/5

    Most tools target clearly distinct resources (profile, sections, materials, grades, assignments), and the Schoology vs StudentVUE prefixes help separate sources. However, schoology_get_upcoming_events and schoology_get_calendar overlap on event retrieval, and schoology_get_recent_activity vs schoology_get_section_updates could be confused, plus assignment tools from both services have partially overlapping purposes.

    Naming Consistency5/5

    Tool names consistently use snake_case with a service/context prefix followed by a verb and noun (schoology_get_assignments, studentvue_get_grades, school_check_login). The pattern is predictable across all 12 tools.

    Tool Count5/5

    12 tools is well-scoped for a multi-service school portal covering login, identity, courses, materials, assignments, events, activity, and grades. Each tool appears to earn its place without excessive fragmentation.

    Completeness4/5

    The surface covers the core read-only student workflow: login diagnostics, profile, sections/courses, materials, documents, assignments, grades, calendar, and activity. Minor gaps remain, such as assignment-level detail or message/communication tools, and the overlapping event/calendar tools suggest a small amount of redundancy rather than a fully polished surface.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers