FCPS School MCP
Read-only MCP access to FCPS Schoology and StudentVUE data, plus login diagnostics for configured accounts.
View the signed-in Schoology profile.
List Schoology sections with official StudentVUE course grades.
List Schoology assignments, including submission status, attachments, and matched StudentVUE scores.
Browse course materials (folders, documents, pages, assignments) and read document/assignment text.
Get upcoming Schoology events, calendar events by date range, account-wide recent activity, and per-section updates.
Get current StudentVUE course marks/percentages and official assignment grades, optionally filtered by class or title.
Run login checks that test Schoology/StudentVUE and configured Ion credentials and report failure reasons.
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., "@FCPS School MCP what are my current grades and upcoming assignments?"
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.
FCPS School MCP
Schoology, StudentVUE, and TJHSST Ion, directly inside your AI assistant.
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 deployThe 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 setupEnter 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 |
| Signed-in Schoology profile |
| Courses with official StudentVUE grades |
| Assignments, submission status, attachments, and matched scores |
| List course materials or search titles, filenames, links, and folder paths |
| Read files, pages, assignments, and discussion prompts, including PDF page images |
| Upcoming deadlines and events |
| Calendar events between two dates |
| Account-wide announcements and updates |
| Updates for one course |
| Official current course marks and percentages |
| Official assignment grades and category weights |
| Past courses with final marks and credits, GPA, and credits toward the diploma |
| Report cards from past years and test score reports |
| Text and page images from a report card or score report |
| Tests every login and reports exactly why one fails |
TJHSST students who answered yes to the Ion question also get these tools:
Tool | Purpose |
| Signed-in Ion profile |
| Bell schedule for a date or the next few days |
| School announcements, newest first, searchable |
| One announcement in full |
| Eighth period blocks from a date |
| Activities offered in one block with capacity and restrictions |
| Your eighth period signups |
| 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.statusissubmitted(withsubmittedAt,late,revisions, and the submitted file names) ornot_submitted.platform: "external_tool"— the work is turned in inside an embedded tool such as Google Assignments. Schoology never records that turn-in, sostatusstaysunknownuntil a grade appears.platform: "assessment_v2"— a Schoology assessment. Its attempt state is not exposed by the API, sostatusisunknown.
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
deploycommand 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 toion.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
0600permissions. Asession.jsoncookie cache is kept next to it (also0600) 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 testRun 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 toolsschool_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
Scored across 12 tools
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.
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.
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.
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
Related MCP Connectors
Secure AI access to OpenOak tasks, notes, and Kanban boards.
Connect AI assistants to Edusign attendance, courses, learners, documents, and API docs via OAuth.
Your personal data for AI — Telegram, bank, courses, Zoom & more, scoped to you.
Connect AI assistants to your approved computer for files, commands, browser and desktop tasks.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to access Canvas LMS course content, including assignments, modules, announcements, and files, to help students manage their coursework.11 npmISC
- AlicenseAqualityBmaintenanceEnables AI apps to read a student's courses, due dates, grades, missing work, announcements, modules, discussions, syllabus, and calendar events in a read-only way. It cannot submit, edit, or delete anything, and credentials go only to the user's own school.21177 npmMIT
- AlicenseAqualityBmaintenanceEnables AI assistants to read a user's own Canvas account data—courses, deadlines, assignments, announcements, files, syllabus, grades, and discussions—through a read-only, locally run MCP connector.20MIT
- AlicenseAqualityCmaintenanceEnables an AI assistant to view a student's own course enrollments, deadlines, assignments, announcements, submission status, and released grades from their learning management system through read-only, policy-gated access.10Apache 2.0