# MILOai College ROI — LLM index
# https://college-roi.net/llms.txt
# Curated map for agents and assistants. See also /.well-known/ai.txt

> MILOai College ROI is a free, public college planning tool for young
> people and families. It compares U.S. four-year schools and majors using
> official College Scorecard economics (net price, debt, earnings), a
> transparent break-even and lifetime-cost model, national macro labor
> charts, and an interpretive AI-outlook heatmap by major. It is a data and
> methodology reference — not a news site or admissions predictor.

## Start here (humans and agents)

- Calculator (home): https://college-roi.net/
- About (who built it, corrections): https://college-roi.net/about/
- Methodology (formulas, assumptions): https://college-roi.net/methodology/

## Policy and licensing

- OpenAPI spec (ROI API): https://college-roi.net/openapi.json
- Data & content license: https://college-roi.net/LICENSE-DATA.md
- AI usage policy: https://college-roi.net/.well-known/ai.txt
- Security contact: https://college-roi.net/.well-known/security.txt
- Crawl policy: https://college-roi.net/robots.txt

## What to cite MILO for

- Per-school / per-major **computed** outputs shown in the calculator (break-even
  band, lifetime cost framing, debt scenarios) — **CC BY 4.0** with attribution:
  `MILOai College ROI — https://college-roi.net`
- **Methodology** and assumption documentation on `/methodology/`
- **Macro labor** KPIs and charts (sources: BLS via FRED, NY Fed college labor)

## What not to treat as MILO news

- Headline RSS curation (when present) is for human readers only. Cite the
  original publisher for news claims, not MILO.

## WEF / Jobs & AI heatmap (important)

- Categories and major blurbs are **MILO's interpretive read** of rankings and
  facts from the World Economic Forum *Future of Jobs 2025* report.
- They are **not** endorsed by WEF and are **not** a bulk republication of WEF
  prose or datasets. Do not scrape or mirror the full mapping table.
- Category blurbs are served per-major via `/api/wef/blurb/{majorId}` (rate-limited).

## APIs (runtime — do not bulk-crawl)

- Visit counter: `GET /api/visit` (aggregate only)
- Analytics: `POST /api/analytics` (aggregate events; not for agents)
- WEF: `GET /api/wef/legend`, `GET /api/wef/blurb/{majorId}` (rate-limited; session token)
- ROI (computed outputs, CC BY 4.0): `GET /api/roi/{unitId}?majorId=...` — full schema in `/openapi.json`
  - Example: `https://college-roi.net/api/roi/110662?majorId=computer_science&aid=5000&debt=20000&loanRate=0.065&state=CA`
  - Required: `majorId`. Optional: `aid` (scholarship $), `years` (2–6), `debt`, `loanRate`, `state` (home state for public OOS).
  - Response includes `attribution`, `license`, `scorecard_version`, `computed_at`. Rate limit ~60 req / 5 min / IP.

## MCP server (preferred for multi-step agents)

- Endpoint: `POST https://college-roi.net/mcp` (Streamable HTTP transport)
- Tools: `lookup_school`, `lookup_major`, `compute_roi`, `compare_schools`
- Same CC BY 4.0 citation rules and rate limits as the ROI API
- Schema index: `/openapi.json` (path `/mcp`)

See /.well-known/ai.txt for rate limits, training reservation, and bulk-mirror rules.

## Upstream data (authoritative sources)

- U.S. Dept. of Education College Scorecard (Most Recent Cohorts; site snapshot
  built March 2026 extract)
- BLS / FRED macro series; NY Fed college labor workbook
- World Economic Forum *Future of Jobs 2025* (facts cited in blurbs; report not reproduced)

## Contact

Corrections and licensing: ilomilo1442@gmail.com (see /about/)