Skip to main content
Glama

college-aid-mcp

An MCP server that combines the US College Scorecard (Dept of Education) and CareerOneStop Scholarship Finder (Dept of Labor) so you can ask Claude to research colleges and matching scholarships in one conversation.

What it can do

search_colleges — search colleges by name, state, degree type, or max tuition. Returns for each school:

  • In-state / out-of-state tuition

  • Median debt at graduation

  • Median earnings 10 years after entry

  • 4-year graduation rate

  • Admission rate

search_scholarships — search 9,500+ scholarships and grants. Filter by keyword, state, study level. Returns award amount, deadline, provider, and direct link.

find_similar_colleges — given a reference school, generate a reach/target/safety list of alternatives with similar Carnegie classification. Filters by admission rate windows (reach = more selective, target = ±7%, safety = less selective), then sorts each bucket by earnings, tuition, or closest match. Falls back to adjacent Carnegie tiers if a bucket returns too few results.

compare_colleges — side-by-side comparison table for 2–5 schools. Runs all lookups in parallel and returns a single markdown table across 18 metrics: location, type, acceptance rate, SAT/ACT ranges, in-state/out-of-state tuition, net price at 3 income brackets, median debt, Pell rate, 4-yr grad rate, retention, 10-yr earnings, and first-gen student share.

search_careers — search careers by job title or keyword using CareerOneStop/O*NET data. Returns for each occupation:

  • Annual salary percentiles (P25 / median / P75 / P90), nationally and by state

  • Bright job outlook flag (above-average growth or openings)

  • Typical education required

  • Key job tasks

estimate_loan_repayment — pure computation, no API key needed. Given a loan balance and expected salary, calculates:

  • Standard 10-year plan: monthly payment, total interest

  • Extended 25-year plan: lower monthly cost, higher total interest

  • Income-driven repayment (IDR): payment as % of discretionary income, forgiveness after 20 years if balance remains

  • Debt-to-income health check and a recommendation on which plan makes sense

get_college_details — deep dive on a single school. Returns:

  • Net price broken down by family income bracket ($0–30k, $30–48k, $48–75k, $75–110k, $110k+)

  • SAT/ACT score ranges (25th–75th percentile)

  • Acceptance rate, enrollment, 1st-year retention, 4-year graduation rate

  • First-generation student share, Pell grant rate

  • Median debt at graduation and 10-year earnings

  • Institution type, Carnegie classification, locale

search_by_major — compare the same major across schools using program-specific data, not school-wide averages. Supports 60+ major aliases (e.g. "cs", "nursing", "mechanical engineering") or raw 4-digit CIP codes. Returns for each school:

  • Program-specific 4yr median earnings (vs. national benchmark for that program)

  • Program-specific median student debt

  • In-state tuition

  • Sortable by earnings, debt, or tuition

Example prompts

  • "Find CS-focused universities in Washington state with tuition under $15k and show me STEM scholarships I could apply to as a high schooler."

  • "Compare median debt vs earnings for the top 10 engineering schools."

  • "Find first-generation college student scholarships in California."

  • "Rank nursing bachelor programs in Texas by earnings — which schools beat the national median?"

  • "Show me mechanical engineering programs sorted by lowest debt in the midwest."

  • "Get full details for Georgia Tech — what would I actually pay if my family earns $60k/year?"

  • "Compare Georgia Tech and Carnegie Mellon on net price, SAT ranges, and 10-year earnings."

  • "I'll graduate with $28k in debt and expect to earn $55k — show me my repayment options."

  • "Find CS programs in California sorted by lowest debt, then estimate repayment for the top school."

  • "I'm targeting University of Washington — give me reach, target, and safety alternatives sorted by lowest cost."

  • "Compare MIT, Stanford, Georgia Tech, and Carnegie Mellon side by side on cost, debt, and earnings."

  • "What do software engineers actually earn in Washington state, and which CS programs give the best shot at hitting P75 salary?"

  • "Compare nursing salaries in Texas vs nationally, then find nursing programs with the lowest debt."


Related MCP server: lenderwiki

Setup

1. Get API keys (both free)

College Scorecard API key

  1. Go to api.data.gov/signup

  2. Register — you'll receive a key by email immediately

  3. Set as env var: COLLEGE_SCORECARD_API_KEY=your_key

CareerOneStop API credentials

  1. Go to api.careeronestop.org/api-explorer

  2. Register for a free account

  3. You'll receive a User ID and Token

  4. Set as env vars: CAREERONESTOP_USER_ID=your_user_id and CAREERONESTOP_TOKEN=your_token

2. Install

git clone https://github.com/Fusingchart/college-aid-mcp.git
cd college-aid-mcp
npm install
npm run build

3. Configure Claude Desktop

Add to your claude_desktop_config.json (usually at ~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "college-aid": {
      "command": "node",
      "args": ["/absolute/path/to/college-aid-mcp/build/index.js"],
      "env": {
        "COLLEGE_SCORECARD_API_KEY": "your_scorecard_key",
        "CAREERONESTOP_USER_ID": "your_user_id",
        "CAREERONESTOP_TOKEN": "your_token"
      }
    }
  }
}

4. Configure Claude Code

claude mcp add college-aid \
  -e COLLEGE_SCORECARD_API_KEY=your_key \
  -e CAREERONESTOP_USER_ID=your_user_id \
  -e CAREERONESTOP_TOKEN=your_token \
  -- node /absolute/path/to/college-aid-mcp/build/index.js

Data sources

Source

Provider

Cost

College Scorecard API

US Dept of Education

Free

CareerOneStop Scholarship Finder

US Dept of Labor

Free

Available Tools

4 tools
get_college_detailsA

Deep dive on a single school: net price broken down by family income bracket, SAT/ACT score ranges, retention rate, first-generation student share, financial aid stats, and 10-year earnings. Much more detail than search_colleges.

Inputs: name (required).

search_by_majorA

Compare the same major across different colleges using College Scorecard field-of-study data. Returns program-specific median earnings, median debt, and in-state tuition for each school — far more accurate than school-wide averages.

Inputs: major (required), limit, state, sort_by, +1 more.

search_collegesA

Search colleges by name, state, or degree type. Returns tuition, median debt, median earnings, graduation rate, and admission rate for each match.

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

search_scholarshipsA

Search 9,500+ scholarships and grants from the US Dept of Labor CareerOneStop database. Filter by keyword, state, study level, or major.

Inputs: limit, state, keyword, study_level.

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A4/5.0

    Scored across 4 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: general school search, deep college details, major-specific comparisons, and scholarship search. No overlap or ambiguity.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern (e.g., search_colleges, get_college_details), making the set predictable and easy to navigate.

    Tool Count5/5

    4 tools is well-scoped for the college aid domain, covering school search, detailed info, major analysis, and scholarships without being excessive or insufficient.

    Completeness4/5

    Covers core college search and scholarship lookup. Minor gaps like side-by-side comparison or financial aid calculators exist, but agents can work around them.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Query 13,000+ US consumer lenders with eligibility criteria, rates, CFPB complaints, and ratings. Find matching lenders by borrower profile, get full profiles, compare lenders, and check eligibility.
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Enables AI assistants to discover and explore university research, researchers, academic programs, and institutional data from OpenAlex and the U.S. College Scorecard, returning source-linked results without fabricating facts.
      9
      MIT