npm college-roi-mcpstdioMITupdated 1mo ago
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.
What can you do with college roi mcp?
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.
Tools
| Tool | What it returns |
|---|---|
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. |
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: 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.
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).
Install
Add college roi mcp to your client. Pick the one you use.
claude mcp add college-roi-mcp -- npx -y college-roi-mcpcodex mcp add college-roi-mcp -- npx -y college-roi-mcpamp mcp add college-roi-mcp -- npx -y college-roi-mcp{
"mcpServers": {
"college-roi-mcp": {
"command": "npx",
"args": [
"-y",
"college-roi-mcp"
]
}
}
}Add to `claude_desktop_config.json`, then restart Claude Desktop.
{
"mcpServers": {
"college-roi-mcp": {
"command": "npx",
"args": [
"-y",
"college-roi-mcp"
]
}
}
}Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.
code --add-mcp '{"name":"college-roi-mcp","command":"npx","args":["-y","college-roi-mcp"]}'Or add the block manually to `.vscode/mcp.json` under `servers`.
{
"mcpServers": {
"college-roi-mcp": {
"command": "npx",
"args": [
"-y",
"college-roi-mcp"
]
}
}
}Add to `~/.codeium/windsurf/mcp_config.json`.
{
"mcpServers": {
"college-roi-mcp": {
"command": "npx",
"args": [
"-y",
"college-roi-mcp"
]
}
}
}Add to `cline_mcp_settings.json` via the MCP Servers panel.
{
"mcpServers": {
"college-roi-mcp": {
"command": "npx",
"args": [
"-y",
"college-roi-mcp"
]
}
}
}Add to `~/.gemini/settings.json`.
{
"mcpServers": {
"college-roi-mcp": {
"type": "local",
"command": "npx",
"args": [
"-y",
"college-roi-mcp"
],
"tools": [
"*"
]
}
}
}Add to `~/.copilot/mcp-config.json`, or run `/mcp add` inside the CLI.
{
"context_servers": {
"college-roi-mcp": {
"command": {
"path": "npx",
"args": [
"-y",
"college-roi-mcp"
]
}
}
}
}Add to your Zed `settings.json`.
npx -y college-roi-mcpRun `goose configure`, choose **Add Extension → Command-line Extension**, and paste this command.
7 tools
college roi mcp exposes 7 tools to a connected agent.
- 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.
- 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.
Score
69 / 100
Good
- Documentation22/25
- Maintenance16/25
- Trust13/20
- Capability6/15
- Install experience12/15
- Documents what it does and how to connect
- Has a resolvable package or endpoint
- Exposes at least one tool, prompt or resource
- README has substantive content
- Includes a code example
- Documents its configuration
- Mentions credentials or security posture
- Last commit 47 days ago
- Has a release history
- Repository is not archived
- Licensed MIT
- Namespace verified in the official MCP registry
- Claimed by its owner
- Published under an organisation
- 7 tool(s) documented
- Provides prompt templates
- Provides resources
- 12 documented install method(s)
- Published to a package registry
- Offers a hosted endpoint — no local install
Version history
| Versions | Published |
|---|---|
| 1.0.1Latest | Jul 15, 2026 |