college-aid-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@college-aid-mcp find CS programs in California with tuition under $15k"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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
Go to api.data.gov/signup
Register — you'll receive a key by email immediately
Set as env var:
COLLEGE_SCORECARD_API_KEY=your_key
CareerOneStop API credentials
Register for a free account
You'll receive a User ID and Token
Set as env vars:
CAREERONESTOP_USER_ID=your_user_idandCAREERONESTOP_TOKEN=your_token
2. Install
git clone https://github.com/Fusingchart/college-aid-mcp.git
cd college-aid-mcp
npm install
npm run build3. 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.jsData sources
Source | Provider | Cost |
US Dept of Education | Free | |
US Dept of Labor | Free |
Available Tools
4 toolsget_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
Scored across 4 tools
Each tool has a clearly distinct purpose: general school search, deep college details, major-specific comparisons, and scholarship search. No overlap or ambiguity.
All tool names follow a consistent verb_noun pattern (e.g., search_colleges, get_college_details), making the set predictable and easy to navigate.
4 tools is well-scoped for the college aid domain, covering school search, detailed info, major analysis, and scholarships without being excessive or insufficient.
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
Related MCP Connectors
Search US colleges and compare historical admissions, costs and aid using public federal data.
Search, compare, and analyze U.S. college data — costs, earnings, programs, and outcomes.
Admission chances at 1,100+ U.S. colleges, college list scoring, and federal admissions data.
Fit-first college search and list-building. Research culture, real costs and odds for 400+ colleges.
Related MCP Servers
- AlicenseCqualityDmaintenanceProvides access to Urban Institute's Education Data API through Claude, enabling users to query and analyze detailed educational data from schools, districts, and universities.22MIT
- AlicenseNot gradedqualityDmaintenanceQuery 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
- AlicenseAqualityDmaintenanceEnables 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.9MIT
- AlicenseNot gradedqualityBmaintenanceEnables natural-language queries about US K-12 public schools, districts, per-pupil funding and spending, and child poverty estimates from keyless federal data.103 npmMIT