{
  "markdown": "# college-roi-mcp\n\nMCP 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.\n\nWraps the free, keyless [LE TEEN College ROI API](https://le-teen.com/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](https://le-teen.com/methodology). Dataset DOI: [10.5281/zenodo.21351602](https://doi.org/10.5281/zenodo.21351602).\n\n## Install\n\nRequires Node ≥ 18.\n\n**Claude Desktop / Claude Code** (`claude_desktop_config.json` or `.mcp.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"college-roi\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"college-roi-mcp\"]\n    }\n  }\n}\n```\n\n**Claude Code CLI:**\n\n```sh\nclaude mcp add college-roi -- npx -y college-roi-mcp\n```\n\nAny other MCP client: run `npx -y college-roi-mcp` over stdio.\n\n## Tools\n\n| Tool | What it returns |\n|---|---|\n| `list_majors` | Compact ROI rows for 19 categories / 115 subfields — median & mean lifetime ROI, % never break even, break-even age, AI-exposure band. Filter by kind/parent, sort, limit. |\n| `get_major` | Full record for one major: ROI distribution (p25/median/mean/p75), completion-adjusted & dropout ROI, graduates/programs, AI-exposure detail. |\n| `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. |\n| `get_college` | Full record for one college, incl. IPEDS unitid and FREOPP coverage. |\n| `best_value_colleges` | Each state's best-value four-years at resident pricing (top 15 per state), or a nationwide top-pick summary. |\n| `out_of_state_penalty` | Public four-years ranked by how much 30-yr NPV a non-resident gives up vs a resident. |\n| `get_api_info` | Metadata for the underlying API: endpoints, license, DOI, attribution. |\n\nAll 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.\n\nNote the envelope: only colleges that clear a positive-NPV bar appear (500 of ~1,656 U.S. four-years). A school being *absent* is itself a signal.\n\n## Example prompts\n\n- \"Is a nursing degree worth it compared to computer science?\"\n- \"Best-value colleges in Michigan for a resident.\"\n- \"How much does going out-of-state to UVA cost me over 30 years?\"\n- \"Which majors have the worst odds of ever breaking even?\"\n\n## Data freshness & caching\n\nThe 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.\n\n## License & attribution\n\n- **Code:** MIT.\n- **Data:** CC BY 4.0 — free to use with attribution. Cite **LE TEEN, le-teen.com** (and FREOPP/IPEDS/BEA as upstream sources).\n",
  "bytes": 3108,
  "sha": "af88fbd0105816509689b54a24c08c5f91acedf554ef34a612881c183e7ef76b",
  "repo_slug": "thomasthinks/college-roi-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_com_le_teen_college_roi_mcp_58658b80/readme"
}