accueil / serveurs / Dev & Code / io.github.cyanheads/college-scorecard-mcp-server
io.github.cyanheads/college-scorecard-mcp-server
serveur MCP (Model Context Protocol) · college-scorecard-mcp-server 0.4.0
Référencé dans l'annuaire. Seul le pentest comportemental fait foi, et il n'a pas encore été exécuté sur ce serveur.
Est-ce que io.github.cyanheads/college-scorecard-mcp-server est sûr ?
Au dernier audit MCP Hub, le serveur MCP « io.github.cyanheads/college-scorecard-mcp-server » est classé « Non encore testé ». Référencé dans l'annuaire. Seul le pentest comportemental fait foi, et il n'a pas encore été exécuté sur ce serveur. Le verdict est réévalué en continu ; consultez la fiche pour l'état à jour.
Méthode : MCP Hub analyse la description de chaque outil (couche 1) et, pour le verdict fort, exécute le serveur dans une micro-VM isolée avec leurres et réseau bloqué (couche 2). On publie des noms et des compteurs, jamais le contenu brut renvoyé par un outil.
Les 9 outils
- scorecard_compare_schools≈ 1391 tokens
Side-by-side comparison of 2–5 schools with ordinal competition ranks within the selected set (ties share a rank). Topics: costs (tuition, net price by income bracket, debt), admissions (acceptance rate, SAT/ACT, enrollment), outcomes (completion, earnings, repayment), aid (Pell grants, federal loans, debt, repayment). Use scorecard_get_school for full profiles.
Paramètres, retour & exemple (2)
Paramètresids· array · requis
Array of 2–5 school unit IDs to compare.topic· string · requis · costs | admissions | outcomes | aid
Comparison topic: costs, admissions, outcomes, or aid.
Exemple d'appel{"name": "scorecard_compare_schools", "arguments": {"ids": [], "topic": "costs"}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"rows": [], "error": {}, "topic": "texte", "notice": "texte", "schools": [], "summary": "texte"}} - scorecard_get_earnings≈ 2156 tokens
Institution-level earnings of federally aided undergraduate entrants working and not enrolled, regardless of completion. Reports medians at 6/8/10 years after entry, 6/10-year percentiles, and non-male/male 6-year medians. For graduate program earnings use scorecard_get_programs. years selects API data-file start years (1996–2025), including files without earnings observations. Per-metric availability and official cohort/measurement/dollar context accompany values; unknown metadata stays absent. No re-inflation is performed.
Paramètres, retour & exemple (2)
Paramètresid· ? · requis
School ID from scorecard_search_schools.years· array · optionnel
Optional API data-file start years from 1996–2025 (e.g. [2003, 2011, 2020]); valid files may lack observations. Omit or pass [] for snapshot only.
Exemple d'appel{"name": "scorecard_get_earnings", "arguments": {"id": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"error": {}, "trend": [], "current": {}, "school_id": 1, "suppressed": true, "school_name": "texte", "current_context": {}, "suppression_note": "texte", "current_availability": {}}} - scorecard_get_programs≈ 1669 tokens
All field-of-study programs at one school with median earnings 1 year after the highest credential, cumulative Stafford/Grad PLUS debt, and IPEDS awards for each year of the pooled debt cohort. Institution-level 6/8/10-year earnings are available via scorecard_get_earnings. Null or absent earnings have unknown cause; suppressed=true requires an explicit provider privacy marker. Use scorecard_lookup_cip to find CIP codes by name.
Paramètres, retour & exemple (4)
Paramètresid· ? · requis
School ID from scorecard_search_schools.cip_code· string · optionnel
Filter to one 4-digit CIP code, dotted or undotted (e.g. "11.07" or "1107" for Computer Science). Returns one row per credential level the school offers in that program.min_earnings· number · optionnel
Minimum 1-year post-graduation median earnings filter.credential_level· integer · optionnel
Filter by credential level: 1=undergraduate certificate, 2=associate, 3=bachelor, 4=post-baccalaureate certificate, 5=master, 6=doctoral, 7=first professional, 8=graduate/professional certificate, 99=non-credential.
Exemple d'appel{"name": "scorecard_get_programs", "arguments": {"id": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"error": {}, "query": {}, "total": 1, "notice": "texte", "programs": [], "school_id": 1, "school_name": "texte", "suppressed_count": 1, "unavailable_count": 1}} - scorecard_get_school≈ 2296 tokens
Institutional profiles for one or more school IDs. Accepts up to 1,000 elements, deduplicates normalized IDs, serves the first 100 distinct IDs, and reports missing and unprocessed IDs separately. Use scorecard_compare_schools for comparisons. Custom fields return requested paths and their JSON values in selected_fields, absent paths in absent_fields, and real identity; default profiles include costs, admissions, outcomes, aid, and completion rates.
Paramètres, retour & exemple (2)
Paramètresid· ? · requis
Positive safe integer school ID or up to 1,000 raw elements. First 100 distinct normalized IDs served; discover IDs with scorecard_search_schools.fields· string · optionnel
Optional comma-separated list of custom field paths from scorecard_list_fields. Overrides the default field set.
Exemple d'appel{"name": "scorecard_get_school", "arguments": {"id": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"error": {}, "notice": "texte", "schools": [], "missing_ids": [], "total_found": 1, "total_requested": 1, "unprocessed_ids": []}} - scorecard_list_fields≈ 980 tokens
Search the College Scorecard field catalog by keyword. Returns matching field paths, descriptions, data types, and whether each field supports API-side sorting. Use before passing custom field paths to the fields parameter on scorecard_get_school to find a supported path. Served entirely from embedded static data — no API call, no rate limit impact.
Paramètres, retour & exemple (2)
Paramètreslimit· integer · optionnel
Requested limit; serving cap 100, hard ceiling 1,000.query· string · requis
Keyword to search the field catalog (e.g. "tuition", "earnings", "admissions", "debt"). Matches against field paths, descriptions, and category names.
Exemple d'appel{"name": "scorecard_list_fields", "arguments": {"query": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"cap": 1, "tip": "texte", "error": {}, "query": "texte", "shown": 1, "notice": "texte", "results": [], "guidance": "texte", "truncated": true, "queryContext": {}, "totalMatches": 1}} - scorecard_lookup_cip≈ 898 tokens
Search the Classification of Instructional Programs (CIP) taxonomy by keyword or partial name. Returns matching CIP codes with standard titles. Use this before passing cip_code filters to scorecard_search_programs or scorecard_get_programs when you know a program by name but not its code. Served entirely from embedded static data — no API call, no rate limit impact.
Paramètres, retour & exemple (2)
Paramètreslimit· integer · optionnel
Requested limit; serving cap 50, hard ceiling 1,000.query· string · requis
Search term — program name keyword (e.g. "computer science", "nursing", "business"). Matches against CIP titles and family names.
Exemple d'appel{"name": "scorecard_lookup_cip", "arguments": {"query": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"cap": 1, "error": {}, "query": "texte", "shown": 1, "notice": "texte", "results": [], "guidance": "texte", "truncated": true, "queryContext": {}, "totalMatches": 1}} - scorecard_search_programs≈ 2080 tokens
Find programs by CIP code across institutions, ranked by median earnings within the fetched school page. Accepts school-side filters (state, ownership, max cost). Minimum earnings is applied locally; totals and pagination count schools before local program filtering. Use scorecard_lookup_cip to convert program names to CIP codes. Returns school names and IDs alongside program earnings, cumulative Stafford/Grad PLUS debt, and IPEDS awards for follow-up calls to scorecard_get_school or scorecard_get_programs.
Paramètres, retour & exemple (10)
Paramètrespage· integer · optionnel
Zero-indexed page number.state· string · optionnel
Comma-separated two-letter state codes; case and whitespace normalized, blanks unset.cip_code· string · optionnel
CIP 4-digit code to search for (e.g. "11.07" for Computer Science). Use scorecard_lookup_cip to find codes.max_debt· number · optionnel
Maximum median cumulative Stafford/Grad PLUS debt across institutions at the same academic level, inclusive; excludes unavailable debt.per_page· integer · optionnel
Schools per page (max 100); program rows may exceed this count.ownership· integer · optionnel
Restrict to school type: 1=public, 2=private nonprofit, 3=for-profit.min_earnings· number · optionnel
Minimum 1-year median earnings, inclusive. Filters this school page locally and excludes unavailable earnings; school totals are unchanged.program_name· string · optionnel
Case-insensitive title substring matched within the fetched school page. Ignored when cip_code is provided; use cip_code for upstream program matching.max_net_price· number · optionnel
Maximum average net price at the school.credential_level· integer · optionnel
Provider credential selector: 1=undergraduate certificate, 2=associate, 3=bachelor, 4=post-baccalaureate certificate, 5=master, 6=doctoral, 7=first professional, 8=graduate/professional certificate, 99=non-credential; other integer levels may return no matches.
Exemple d'appel{"name": "scorecard_search_programs", "arguments": {"page": 1, "state": "texte", "cip_code": "texte", "max_debt": 1, "per_page": 1, "ownership": 1}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"cap": 1, "page": 1, "error": {}, "query": {}, "shown": 1, "total": 1, "notice": "texte", "per_page": 1, "programs": [], "truncated": true, "totalCount": 1, "total_programs": 1}} - scorecard_search_schools≈ 1977 tokens
Search and filter U.S. colleges and universities by name, location, type, size, and acceptance rate. Returns core identity and cost metrics. Use scorecard_get_school for profiles or scorecard_search_programs for program rankings. Geographic distance requires a U.S. ZIP; ZIP alone uses the provider default radius. State accepts comma-separated two-letter codes (e.g. WA,CA). Ownership: 1=public, 2=private nonprofit, 3=for-profit. Degree level: 0=non-degree, 1=certificate, 2=associate, 3=bachelor, 4=graduate.
Paramètres, retour & exemple (14)
Paramètreszip· string · optionnel
Five-digit U.S. ZIP or ZIP+4. Alone uses the provider default radius; blank is unset.page· integer · optionnel
Zero-indexed page number for pagination.sort· string · optionnel
Upstream sort expression on an indexed field, e.g. "latest.cost.avg_net_price.overall:asc" or ":desc" for reverse order. Use scorecard_list_fields for sort support; omission keeps API ordering.query· string · optionnel
School name search — partial or full name; all words must appear.state· string · optionnel
Comma-separated two-letter state codes; case and whitespace normalized, blanks unset.cip_code· string · optionnel
Filter to schools offering this CIP 4-digit program code (e.g. "11.07"). Use scorecard_lookup_cip to find codes.distance· string · optionnel
Nonnegative radius: bare miles, mi, or km, including decimals. Requires meaningful zip.men_only· boolean · optionnel
True selects men-only institutions; false selects institutions explicitly marked not men-only. Omit to include unknown values.per_page· integer · optionnel
Results per page (max 100).ownership· integer · optionnel
Control type: 1=public, 2=private nonprofit, 3=private for-profit.size_range· object · optionnel
Undergraduate enrollment size range. Omit for no size filter.women_only· boolean · optionnel
True selects women-only institutions; false selects institutions explicitly marked not women-only. Omit to include unknown values.degree_level· integer · optionnel
Predominant degree: 0=non-degree/certificate, 1=certificate, 2=associate, 3=bachelor, 4=graduate.acceptance_rate_range· object · optionnel
Acceptance rate range as decimals (0–1). Omit for no filter.
Exemple d'appel{"name": "scorecard_search_schools", "arguments": {"zip": "texte", "page": 1, "sort": "texte", "query": "texte", "state": "texte", "cip_code": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"cap": 1, "page": 1, "error": {}, "query": {}, "shown": 1, "total": 1, "notice": "texte", "schools": [], "per_page": 1, "truncated": true, "totalCount": 1}} - scorecard_value_analysis≈ 1410 tokens
Analyze costs, debt, repayment progress, and earnings for one school. Returns debt-to-earnings and net-price-to-annual-earnings ratios alongside the source figures. family_income selects the applicable net-price bracket. Repayment progress is the share of borrowers paying down principal 3 years after entering repayment.
Paramètres, retour & exemple (2)
Paramètresid· ? · requis
School ID from scorecard_search_schools.family_income· number · optionnel
Annual family income in dollars. When provided, net price is shown for the applicable income bracket.
Exemple d'appel{"name": "scorecard_value_analysis", "arguments": {"id": "texte"}}Exemple de retour{"content": [{"type": "text", "text": "…"}], "structuredContent": {"error": {}, "school_id": 1, "data_notes": [], "list_price": 1, "median_debt": 1, "school_name": "texte", "family_income": 1, "graduation_rate": 1, "net_price_basis": "income_bracket", "net_price_overall": 1, "earnings_6yr_median": 1, "effective_net_price": 1}}
C'est votre serveur ?
Revendiquez-le sur l'espace créateur (preuve GitHub, domaine ou npm) pour afficher le badge « propriétaire vérifié » et lancer un pentest comportemental à la demande afin d'obtenir le badge « Vérifié ».