cvc-mcp
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., "@cvc-mcp Find online biology courses at City College of San Francisco"
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.
California Virtual Campus (CVC) MCP Server
An open-source Model Context Protocol (MCP) server for California Virtual Campus (CVC) course search. It lets Claude Desktop and other MCP clients find online classes at California community colleges and retrieve course details, prerequisites, sections, available seats, instructors, tuition, meeting times, and zero-textbook-cost status.
This server wraps the unofficial
CaliforniaVirtualCampusAPI
Python library and public data from CVC Course Search.
No API key is required.
Features
Search California Virtual Campus course IDs by college, C-ID, local course code, or title
Retrieve structured CVC course and section data for AI assistants
Find online California community college classes from Claude Desktop
Return source URLs so users can verify current information on CVC
Limit results to protect the model context window
Offer optional Selenium browser-search fallbacks for difficult queries
Run locally over stdio; no hosted service, account, or API key required
Deploy as a stateless Streamable HTTP MCP server on Vercel
Related MCP server: University Course Catalog MCP Server
MCP tools
Tool | Description |
| Search one college by C-ID, course symbol, or course name using CVC's public search endpoint |
| Get course information, sections, and available seats per section by CVC course ID |
| Experimental headless-browser course search |
| Experimental headless-browser search with full course details |
For reliable results, call search_course_ids first and pass an ID to get_course.
The two scrape_* tools require a local Chrome or Chromium installation and a compatible
ChromeDriver. They are slower and more sensitive to CVC website changes.
Requirements
Python 3.10 or newer
uv(recommended) orpipInternet access to
search.cvc.eduChrome/Chromium only when using the experimental
scrape_*tools
Install
git clone https://github.com/SanjayMarathe/cvc-mcp.git
cd cvc-mcp
uv sync --frozenRun the server locally:
uv run --frozen cvc-mcpThe process waits for MCP messages on standard input; a blank terminal is expected.
Install with pip
python -m venv .venv
source .venv/bin/activate
python -m pip install .
cvc-mcpAdd CVC MCP to Claude Desktop
Open the Claude Desktop configuration file:
Operating system | Configuration path |
macOS |
|
Windows |
|
Linux |
|
Add this entry under mcpServers, replacing both paths with absolute paths on your
computer:
{
"mcpServers": {
"cvc": {
"command": "/absolute/path/to/uv",
"args": [
"--directory",
"/absolute/path/to/cvc-mcp",
"run",
"--frozen",
"cvc-mcp"
]
}
}
}Fully quit and reopen Claude Desktop. Ask Claude to list its tools if the CVC tools do not appear immediately.
Hosted MCP and documentation
This repository includes a Vercel-compatible Python ASGI deployment:
/— browsable setup and tool documentation/docs— redirects to the documentation homepage/health— JSON health check/mcp— stateless Streamable HTTP MCP endpoint
Deploy your own copy with the Vercel CLI:
vercel
vercel --prodVercel supplies the deployment hostname automatically. The server uses it to enforce
MCP host and origin checks. If you deploy through another ASGI platform, set
CVC_MCP_HOST to its hostname without https://.
Connect a remote MCP client with:
{
"mcpServers": {
"cvc": {
"url": "https://your-project.vercel.app/mcp"
}
}
}The hosted MCP endpoint is public and read-only. No API key is required. The
scrape_* tools require Chrome and therefore are intended for local use; use
search_course_ids and get_course on Vercel.
Production deployment: cvc-mcp.vercel.app
Streamable HTTP endpoint: https://cvc-mcp.vercel.app/mcp
Example prompts for Claude
“Search CVC for online computer science courses at Pasadena City College.”
“Find the CVC course IDs for COMP 122 and show me the available sections.”
“Does this California community college course have open seats or zero textbook cost?”
“Compare the instructors, meeting times, and tuition for these CVC course IDs.”
“Find an online California community college class that matches C-ID COMP 122.”
Tool examples
Search for matching IDs:
{
"college_name": "Pasadena City College",
"course_symbol": "COMP 122",
"max_results": 10
}Retrieve course details:
{
"course_id": 12345
}Each item in the returned sections array includes an integer available_seats value:
{
"section": "78499",
"semester": "Fall 2026",
"available_seats": 8
}How it works
The server uses the official Python SDK for the Model Context Protocol and delegates CVC
lookups to CaliforniaVirtualCampusAPI 0.0.2. The upstream library reads public CVC web
pages and a public search endpoint, then this MCP server converts its Python course and
section objects into stable, model-friendly JSON.
All requests run locally from your computer. There is no API key, analytics service, or intermediate hosted backend in this project.
Limitations and data accuracy
This is an independent, unofficial project. It is not affiliated with or endorsed by California Virtual Campus, the California Community Colleges Chancellor's Office, or Anthropic.
The upstream wrapper is alpha software and depends on CVC's current HTML structure.
Course availability, seat counts, tuition, dates, transferability, and prerequisites can change. Always verify results on the returned
search.cvc.edusource URL and with the teaching college before enrolling.College-name matching is performed by the upstream package and may select a similarly named institution when given an ambiguous or misspelled name.
CVC can change or restrict its public endpoints at any time.
Development
uv sync --all-groups
uv run pytest
uv run ruff check .
uv run ruff format --check .Run the opt-in end-to-end suite against the production deployment:
CVC_MCP_RUN_E2E=1 uv run pytest tests/e2eOverride CVC_MCP_E2E_URL to test another deployment.
Run the HTTP deployment locally:
uv run uvicorn app:app --reload
# Documentation: http://127.0.0.1:8000/
# MCP endpoint: http://127.0.0.1:8000/mcpData source and attribution
Course data is provided by California Virtual Campus and is described by the upstream project as available under the Creative Commons Attribution 4.0 International license. The wrapper dependency is licensed under Apache-2.0. This MCP server's original code is available under the MIT License.
Related terms
California Virtual Campus API, CVC API, CVC Exchange, CVC Course Finder, California community college online courses, California online classes, Claude Desktop MCP server, Model Context Protocol course search, community college course availability.
Available Tools
4 toolsget_courseB
Get a CVC course and its sections, including available seats for each section.
Inputs: course_id (required). Returns: object
scrape_course_idsA
Search CVC course IDs through a headless Chrome browser.
This experimental fallback is slower and requires Chrome/Chromium plus a compatible driver. Prefer search_course_ids for ordinary searches.
Inputs: college_name (required), c_id, course_name, max_results, +1 more. Returns: object
scrape_coursesA
Search CVC in a headless browser and return detailed matching courses.
This experimental operation can be slow because it loads a page for every result. It requires Chrome/Chromium and a compatible driver. Prefer search_course_ids followed by get_course when possible.
Inputs: college_name (required), c_id, course_name, max_results, +1 more. Returns: object
search_course_idsA
Search CVC course IDs at a California community college.
Use a college name plus at least one filter. C-ID is the statewide Course Identification Numbering System value; course_symbol is the local code such as COMPSCI001; course_name is a title phrase. This is the preferred, lightweight search.
Inputs: college_name (required), c_id, course_name, max_results, +1 more. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
get_course and scrape_courses are clearly distinct, but search_course_ids and scrape_course_ids both search for CVC course IDs and differ mainly by implementation. The descriptions help by marking one as preferred and the other as experimental fallback, but the boundary is still somewhat blurred.
All tools follow a consistent snake_case verb_noun pattern: get_course, search_course_ids, scrape_course_ids, scrape_courses. The verbs vary by operation type, but the structure is uniform and predictable.
Four tools is slightly small but well-scoped for a course search server. Each tool serves a clear retrieval or search purpose, and the count does not feel excessive or artificially padded.
The server covers ID search, course detail retrieval, and a detailed search fallback. A minor gap is the lack of a direct non-scrape detailed course search, but the existing combination of search_course_ids plus get_course and scrape_courses covers the core workflow.
Maintenance
Related MCP Connectors
Read-only access to Epivo's live course catalogue for AI agents.
Search disc golf courses worldwide, find nearby courses, and retrieve course details and updates.
Search Australian CRICOS courses, education providers and ANZSCO skilled occupations using One U Education (万友教育)'s public catalogue, including tuition, intakes, English requirements, campuses and study pathways. Provides six read-only tools with source links; no API key is required, and tuition fees are indicative and shown in AUD.
Search and load AI datasets, prompts and few-shot contexts from the ContexteTech catalogue.
Related MCP Servers
- FlicenseAqualityNot gradedmaintenanceEnables interaction with Canvas LMS courses and assignments directly from your LLM, allowing you to retrieve, search, and summarize course information, check due dates, and access assignment details without leaving your AI assistant.43,565 npm-
- FlicenseNot gradedqualityDmaintenanceProvides intelligent access to a university course catalog with full-text search, prerequisite tracking, instructor lookups, and course comparison prompts.-
- AlicenseAqualityBmaintenanceExposes USC's public course catalog API to AI agents, enabling natural-language queries about courses, GE requirements, schedules, and fees with optional filters for days, times, and open sections.161MIT
- FlicenseNot gradedqualityBmaintenanceEnables querying a local course catalog to list available courses and retrieve detailed records by course ID.-