Skip to content

cyanheads/college-scorecard-mcp-server

v0.5.0Apache-2.0

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.