College Scorecard Mcp Server
by cyanheadscommunityv0.1.7
1
An MCP server for searching, comparing, and analyzing U.S. College Scorecard data, including school costs, admissions, outcomes, financial aid, programs, and earnings. It supports STDIO and Streamable HTTP transports and includes tools plus static CIP and field catalog lookups.
From the registry: Search, compare, and analyze U.S. college data — costs, earnings, programs, and outcomes.
Install & configure
Prerequisites
- requiredInstall Node.jsInstall Node.js v24 or higher to use the recommended npx-based launch method.https://nodejs.org/
- requiredGet a College Scorecard API keyCreate a free API key from api.data.gov for access to the U.S. Department of Education College Scorecard API.https://api.data.gov/signup/
Install in your client
Paste into the AI you're chatting with — it will figure out the rest
Please install the `college-scorecard-mcp-server` MCP server into my current AI client (that's you).
Required prerequisites (do these first if not already done):
- **Install Node.js** — Install Node.js v24 or higher to use the recommended npx-based launch method. (https://nodejs.org/)
- **Get a College Scorecard API key** — Create a free API key from api.data.gov for access to the U.S. Department of Education College Scorecard API. (https://api.data.gov/signup/)
Canonical MCP server config (stdio transport):
- command: `npx`
- args: ["-y","@cyanheads/college-scorecard-mcp-server@latest"]
- required environment variables:
- `SCORECARD_API_KEY`: API key for the College Scorecard API from api.data.gov. (example: `<your-api-key>`)
- optional environment variables:
- `MCP_TRANSPORT_TYPE`: Transport type. For stdio usage, set to stdio. Defaults to stdio. (example: `stdio`)
- `MCP_LOG_LEVEL`: Log level for server logging. (example: `info`)
- `MCP_HTTP_PORT`: HTTP server port when using HTTP transport. (example: `<your-http-port>`)
- `MCP_HTTP_ENDPOINT_PATH`: HTTP endpoint path where the MCP server is mounted when using HTTP transport. (example: `<your-http-endpoint-path>`)
- `MCP_PUBLIC_URL`: Public origin override for TLS-terminating reverse-proxy deployments. (example: `<your-public-url>`)
- `MCP_AUTH_MODE`: Authentication mode: none, jwt, or oauth. (example: `<your-auth-mode>`)
- `MCP_GC_PRESSURE_INTERVAL_MS`: Opt-in forced-GC pressure loop interval in milliseconds (Bun only). (example: `<your-gc-pressure-interval-ms>`)
- `LOGS_DIR`: Directory for log files when running under Node.js. (example: `<your-logs-dir>`)
- `STORAGE_PROVIDER_TYPE`: Storage backend type such as in-memory, filesystem, supabase, or cloudflare-kv/r2/d1. (example: `<your-storage-provider-type>`)
- `OTEL_ENABLED`: Enable OpenTelemetry instrumentation. (example: `<true-or-false>`)
Note: README also documents Streamable HTTP support, started separately with MCP_TRANSPORT_TYPE=http. Example endpoint is /mcp on a configurable port, but the canonical client config examples provided use stdio, so stdio is the preferred portable configuration.
Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.Note: README also documents Streamable HTTP support, started separately with MCP_TRANSPORT_TYPE=http. Example endpoint is /mcp on a configurable port, but the canonical client config examples provided use stdio, so stdio is the preferred portable configuration.
Tools (9)
scorecard_search_schools
Search and filter institutions by name, location, type, size, acceptance rate, proximity, and CIP code.
scorecard_get_school
Fetch a full institutional profile for one or more school IDs, including costs, admissions, outcomes, aid, demographics, and completion rates.
scorecard_compare_schools
Compare 2–5 schools on costs, admissions, outcomes, or aid with normalized rows, percentile ranks, and relative deltas.
scorecard_get_programs
List all programs at one school with earnings, debt, enrollment, and optional CIP or credential filters.
scorecard_search_programs
Search programs by CIP code or keyword across institutions and rank results by median earnings.
scorecard_get_earnings
Get institution-level post-graduation earnings at 6, 8, and 10 years after entry, optionally by gender.
scorecard_value_analysis
Compute ROI-style analysis for a school using cost, debt, repayment, earnings, and peer comparison data.
scorecard_lookup_cip
Search CIP codes by keyword or partial name from embedded static data.
scorecard_list_fields
Search the Scorecard field catalog and return field paths, descriptions, data types, and sort support.
Environment variables
SCORECARD_API_KEYrequiredAPI key for accessing the College Scorecard API.Prerequisites
- • Node.js v24+
Packages
@cyanheads/college-scorecard-mcp-server
npmv0.1.7transport: stdio
@cyanheads/college-scorecard-mcp-server
npmv0.1.7transport: streamable-http
Details
- Language
- TypeScript
- Released
- Jun 20, 2026
- Last commit
- Jun 20, 2026
- Registry name
- io.github.cyanheads/college-scorecard-mcp-server