cyanheads/college-scorecard-mcp-server
Search, compare, and analyze U.S. college data — costs, earnings, programs, and outcomes — via MCP. STDIO or Streamable HTTP.
Changelog
All notable changes to this project. Each entry links to its full per-version file in changelog/.
0.5.0 — 2026-11-03
Page program inventories and compare college outcomes with explicit populations, pooling, and price periods.
0.4.0 — 2026-10-14 · ⚠️ Breaking
Correct Scorecard earnings, availability, and program comparisons.
0.3.0 — 2026-10-13 · ⚠️ Breaking
Preserve requested profile data and classify Scorecard failures with actionable recovery.
0.2.0 — 2026-09-30 · ⚠️ Breaking
Program enrollment output is removed in favor of ipeds_awards_year1 and ipeds_awards_year2, with program debt and earnings counts read from the correct Scorecard fields. School search gains sort and single-sex filters, and the value-analysis net-price ratio is no longer inflated sixfold.
0.1.9 — 2026-09-21
Stateless HTTP serving by default; scorecard_get_programs matches dotted and undotted CIP codes and reports correct credential levels; every upstream failure now carries an api_error reason and recovery hint.
0.1.8 — 2026-08-21
Adopt @cyanheads/mcp-ts-core ^0.12.3 (MCP SDK ^2.0.0 era) with a TypeScript 7 / Bun 1.4 toolchain refresh; fix enrichment truncation fields failing output validation, resources/list discovery, and empty-ID error classification.
0.1.7 — 2026-06-19
Adopt @cyanheads/mcp-ts-core ^0.10.8 — devcheck fresh-scaffold guards, check-skill-versions worktree-deletion guard, seven re-synced skills, biome 2.5; plus @types/node ^26 and a dependency refresh. No tool surface changes.
0.1.6 — 2026-06-19
Repayment field corrected and renamed (repayment_rate_3yr → repayment_progress_3yr; was a borrower count rendering as ~1078%), and net price by income bracket now populates via the correct ownership-keyed API paths (was always null). Dependency refresh.
0.1.5 — 2026-06-12
Adopt @cyanheads/mcp-ts-core ^0.10.6: out-of-band enrichment (ctx.enrich) replaces notice/pagination output fields, with new truncation and total-count signals on list and search tools. Plugin manifests, Dockerfile healthcheck, dependency refresh.
0.1.4 — 2026-05-26
Package metadata alignment: author, funding, FUNDING.yml, README install badges, Dockerfile build stage, manifest.json, server.json, scripts use bun run.
0.1.3 — 2026-05-25
Dockerfile build stage switched to node:24-slim for tsx compatibility.
0.1.2 — 2026-05-25
Add mcpName field and publish-mcp script for MCP Registry publication.
0.1.1 — 2026-05-25
Field-test fixes — CIP code filtering, repayment rate scaling, credential level path, and format output cleanup.
0.1.0 — 2026-05-25
Initial release — 9 College Scorecard tools (institution search, program earnings, school comparison, value analysis), 2 resources, 1 prompt, embedded CIP taxonomy and field catalog.