Skip to main content
Glama

college-roi-mcp

MCP server for U.S. college-ROI data: 30-year net present value (NPV) for 500 four-year colleges, lifetime ROI for 19 major categories + 115 CIP subfields, per-state best-value rankings, and the out-of-state tuition penalty ranking.

Wraps the free, keyless LE TEEN College ROI API (static JSON, CC BY 4.0). No API key, no signup, no rate limits beyond CDN sanity. Data derives from FREOPP program-level ROI estimates, IPEDS institutional data, and BEA price deflators — methodology at le-teen.com/methodology. Dataset DOI: 10.5281/zenodo.21351602.

Install

Requires Node ≥ 18.

Claude Desktop / Claude Code (claude_desktop_config.json or .mcp.json):

{
  "mcpServers": {
    "college-roi": {
      "command": "npx",
      "args": ["-y", "college-roi-mcp"]
    }
  }
}

Claude Code CLI:

claude mcp add college-roi -- npx -y college-roi-mcp

Any other MCP client: run npx -y college-roi-mcp over stdio.

Related MCP server: uk-he-data-mcp

Tools

Tool

What it returns

list_majors

Compact ROI rows for 19 categories / 115 subfields — median & mean lifetime ROI, share of graduates in programs that never break even, median break-even age among programs that break even, AI-exposure band (category rows only). Filter by kind/parent, sort, limit.

get_major

Full record for one major: ROI distribution (p25/median/mean/p75), completion-adjusted & dropout ROI, graduates/programs, AI-exposure detail.

search_colleges

Search the 500 positive-NPV-envelope colleges by name/state/control — resident & non-resident 30-yr NPV, cost of attendance, median earnings, break-even age.

get_college

Full record for one college, incl. IPEDS unitid and FREOPP coverage.

best_value_colleges

Each state's best-value four-years at resident pricing (top 15 per state), or a nationwide top-pick summary.

out_of_state_penalty

Public four-years ranked by how much 30-yr NPV a non-resident gives up vs a resident.

get_api_info

Metadata for the underlying API: endpoints, license, DOI, attribution.

All dollar figures are lifetime/30-year totals in USD. List responses are compact projections with limit controls so they stay small in agent contexts; detail tools return the full upstream record.

Note the envelope: this server's college list holds only the 500 four-year colleges with the largest FREOPP program coverage that also clear our data gates and show a positive 30-year net value. Absence from the list is a coverage statement, not a verdict.

Example prompts

  • "Is a nursing degree worth it compared to computer science?"

  • "Best-value colleges in Michigan for a resident."

  • "How much does going out-of-state to UVA cost me over 30 years?"

  • "Which majors have the worst odds of ever breaking even?"

Data freshness & caching

The upstream API is static JSON regenerated with the dataset; this server caches responses in-process for 24 h (matching the API's CDN cache). Nothing is written anywhere; the server is read-only.

License & attribution

  • Code: MIT.

  • Data: CC BY 4.0 — free to use with attribution. Cite LE TEEN, le-teen.com (and FREOPP/IPEDS/BEA as upstream sources).

Available Tools

7 tools
best_value_collegesBest-value colleges by stateA

Each U.S. state's best-value four-year colleges at resident pricing, ranked by 30-year NPV (top 15 per state). Pass a state for its full list; omit it for a nationwide summary (every state's top pick).

Inputs: state.

get_api_infoAbout the College ROI APIA

Metadata for the underlying LE TEEN College ROI API: description, license, attribution, DOI, docs URL, and the list of raw endpoints.

Inputs: no named parameters.

get_collegeGet one college's full recordA

Full record for one college by slug (e.g. 'university-of-michigan-ann-arbor'): 30-year NPV at resident and non-resident pricing, total cost of attendance both ways, median earnings 10 years after entry, break-even age, IPEDS unitid, and FREOPP program coverage. Accepts a plain name and will slugify it; use search_colleges to discover slugs.

Inputs: slug (required).

get_majorGet one major's full ROI detailA

Full lifetime-ROI record for one major category or CIP subfield by slug (e.g. 'nursing', 'computer-science', 'philosophy-and-religious-studies'): ROI distribution (p25/median/mean/p75), never-break-even %, break-even age, completion-adjusted and dropout ROI, graduates/programs counts, and AI-exposure detail. Accepts a plain name and will slugify it; use list_majors to discover exact slugs.

Inputs: slug (required).

list_majorsList majors by lifetime ROIA

List bachelor's-degree majors (19 broad categories and/or 115 CIP subfields) with lifetime-ROI stats: median/mean lifetime ROI (USD), % of programs that never break even, median break-even age, and AI-exposure band. Returns compact rows sorted by the chosen field. Use the returned slug with get_major for full detail.

Inputs: kind, limit, parent, sort_by.

out_of_state_penaltyOut-of-state tuition penalty rankingA

U.S. public four-year colleges ranked by the out-of-state penalty: how much 30-year NPV a non-resident gives up versus a resident at the same school. Includes both NPVs and both tuition figures per row.

Inputs: limit, state.

search_collegesSearch colleges by name/stateA

Search the 500 largest-coverage U.S. four-year colleges that clear the positive-NPV envelope. Each row: 30-year NPV at resident and non-resident pricing, total cost of attendance, median earnings 10 years after entry, and break-even age. Filter by name substring, state, and control; sorted by resident NPV descending unless overridden. Use the returned slug with get_college.

Inputs: limit, query, state, control, +1 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.3/5.0

    Scored across 7 tools

    Disambiguation5/5

    Each tool targets a distinct aspect of college ROI data (search, detail, majors, reports, API info) with no functional overlap. Even similar tools like search_colleges and best_value_colleges have clearly different purposes.

    Naming Consistency4/5

    Most tools follow a verb_noun pattern (search_colleges, list_majors, get_college), but best_value_colleges and out_of_state_penalty are noun phrases. The inconsistency is minor and still readable.

    Tool Count5/5

    Seven tools is well-scoped for a college ROI data server, covering search, detail, listing, and special reports without being excessive or insufficient.

    Completeness5/5

    The set covers all major access patterns: search colleges, get full college/major details, list majors, state best-value summaries, out-of-state penalty analysis, and API metadata. No obvious gaps for the stated purpose.

    Maintenance

    ActivityMaintained
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers