# com.le-teen/college-roi-mcp (npm · college-roi-mcp)

U.S. college ROI data: 30-yr NPV for 500 colleges, lifetime ROI for 134 majors. Keyless.

- Trust score: 68/100 (medium)
- Change this week: +23
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- npm · `college-roi-mcp`: 68/100 (this document), [markdown](https://verifymcp.io/servers/com-le-teen-college-roi-mcp/college-roi-mcp.md), [page](https://verifymcp.io/servers/com-le-teen-college-roi-mcp/college-roi-mcp)

## Channel facts

- Registry: `npm`
- Package: `college-roi-mcp`
- Version: `1.0.1`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Supply Chain Security**: 87/100
  - No malware found by supply-chain analysis.
  - Only part of the dependency tree could be resolved (95 of 99), so this covers what we could see, not the whole tree.
  - No install/post-install scripts declared.
  - Only part of the dependency tree could be resolved (95 of 99), so this covers what we could see, not the whole tree.
- **Provenance & Transparency**: 45/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 18 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 74/100
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 906 tokens (~129/item across 7 items; 7 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 27/100
  - Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 95/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 86% of tool parameters carry a description.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### Claude

```bash
claude mcp add com-le-teen-college-roi-mcp -- npx -y college-roi-mcp
```

### Codex

```bash
codex mcp add com-le-teen-college-roi-mcp -- npx -y college-roi-mcp
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "com-le-teen-college-roi-mcp": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "college-roi-mcp"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add com-le-teen-college-roi-mcp --command npx --arg -y --arg college-roi-mcp
```

### Hermes

```yaml
mcp_servers:
  com-le-teen-college-roi-mcp:
    command: "npx"
    args: ["-y", "college-roi-mcp"]
```

### Other

```json
{
  "mcpServers": {
    "com-le-teen-college-roi-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "college-roi-mcp"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-02 (score 68, +48)

- [security regression] Provenance: unverified → fail
- [security improvement] Install scripts: unverified → pass
- [security improvement] Known CVEs: unverified → partial
- [security improvement] Malware scan: unverified → pass
- [functional improvement] Schema quality: unverified → excellent
- [functional improvement] License: unverified → pass
- [functional improvement] Dependency health: unverified → partial
- [functional improvement] Maintenance: unverified → pass
- [functional improvement] MCP protocol: unverified → pass
- [functional improvement] Stability: unverified → 0.23
- [functional] Licence: MIT

### 2026-07-31 (score 20, −7)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-30 (score 27, +3)

- [security regression] Malware scan: pass → unverified
- [functional improvement] Tool coverage: unverified → 100

### 2026-07-28 (score 24, −21)

- [functional regression] Tool coverage: 100 → unverified
- [functional] First check of Schema quality: unverified

### 2026-07-27 (score 45)

First indexed and scored.

## MCP tools (7)

### `get_api_info` (~38 tokens)

About the College ROI API

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

### `list_majors` (~151 tokens)

List majors by lifetime ROI

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.

Input parameters:

- `kind` (string): Filter to broad categories (19), CIP subfields (115), or all 134.
- `limit` (integer): Max rows returned.
- `parent` (string): Only subfields of this category slug, e.g. 'engineering'.
- `sort_by` (string): Sort field. ROI sorts are descending; name ascending.

### `get_major` (~131 tokens)

Get one major's full ROI detail

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.

Input parameters:

- `slug` (string, required): Major slug or name, e.g. 'computer-science' or 'Computer Science'.

### `search_colleges` (~149 tokens)

Search colleges by name/state

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.

Input parameters:

- `control` (string)
- `limit` (integer): Max rows returned.
- `query` (string): Case-insensitive substring of the college name.
- `sort_by` (string)
- `state` (string): Two-letter state code, e.g. 'MI'.

### `get_college` (~120 tokens)

Get one college's full record

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.

Input parameters:

- `slug` (string, required): College slug or name, e.g. 'university-of-michigan-ann-arbor'.

### `best_value_colleges` (~84 tokens)

Best-value colleges by state

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).

Input parameters:

- `state` (string): Two-letter state code, e.g. 'CA'. Omit for all states' #1.

### `out_of_state_penalty` (~84 tokens)

Out-of-state tuition penalty ranking

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.

Input parameters:

- `limit` (integer): Max rows returned (77 total).
- `state` (string): Filter to one state's public colleges.

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/com-le-teen-college-roi-mcp/college-roi-mcp#diagnostics

## Score history

- 2026-08-03: 68
- 2026-08-02: 68
- 2026-08-01: 20
- 2026-07-31: 20
- 2026-07-30: 27
- 2026-07-28: 24
- 2026-07-27: 45

## Links

- npm package: https://www.npmjs.com/package/college-roi-mcp
- Socket report: https://socket.dev/npm/package/college-roi-mcp
- Repository: https://github.com/thomasthinks/college-roi-mcp
- Website: https://le-teen.com/api
- Changelog RSS feed: https://verifymcp.io/servers/com-le-teen-college-roi-mcp/college-roi-mcp/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/com-le-teen-college-roi-mcp/college-roi-mcp/changelog.json
- HTML version of this page: https://verifymcp.io/servers/com-le-teen-college-roi-mcp/college-roi-mcp