@cyanheads/college-scorecard-mcp-server 0.1.1

package/dist/mcp-server/tools/definitions/get-programs.tool.d.ts

@@ -0,0 +1,46 @@
+/**
+ * @fileoverview Program outcomes tool. Returns all field-of-study programs at one school
+ * with earnings, debt, and enrollment figures.
+ * @module mcp-server/tools/definitions/get-programs.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const getProgramsTool: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    id: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
+    cip_code: z.ZodOptional<z.ZodString>;
+    min_earnings: z.ZodOptional<z.ZodNumber>;
+    credential_level: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    school_id: z.ZodNumber;
+    school_name: z.ZodString;
+    programs: z.ZodArray<z.ZodObject<{
+        code: z.ZodString;
+        title: z.ZodOptional<z.ZodString>;
+        credential_level: z.ZodString;
+        earnings_1yr_median: z.ZodOptional<z.ZodNumber>;
+        earnings_count: z.ZodOptional<z.ZodNumber>;
+        median_debt: z.ZodOptional<z.ZodNumber>;
+        enrollment: z.ZodOptional<z.ZodNumber>;
+        suppressed: z.ZodBoolean;
+        suppression_note: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    total: z.ZodNumber;
+    suppressed_count: z.ZodNumber;
+    notice: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, readonly [{
+    readonly reason: "school_not_found";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "No school record found for the requested ID.";
+    readonly recovery: "Verify the school ID using scorecard_search_schools and retry.";
+}, {
+    readonly reason: "no_programs";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "No programs matched the filters at this school.";
+    readonly recovery: "Remove the cip_code or min_earnings filter and retry to see all programs.";
+}, {
+    readonly reason: "api_error";
+    readonly code: JsonRpcErrorCode.ServiceUnavailable;
+    readonly when: "The College Scorecard API returned an error.";
+    readonly recovery: "Check SCORECARD_API_KEY validity and retry after a brief delay.";
+}]>;
+//# sourceMappingURL=get-programs.tool.d.ts.map

package/dist/mcp-server/tools/definitions/get-programs.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-programs.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-programs.tool.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAkCjE,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyL1B,CAAC"}

package/dist/mcp-server/tools/definitions/get-programs.tool.js

@@ -0,0 +1,194 @@
+/**
+ * @fileoverview Program outcomes tool. Returns all field-of-study programs at one school
+ * with earnings, debt, and enrollment figures.
+ * @module mcp-server/tools/definitions/get-programs.tool
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { getScorecardService } from '../../../services/scorecard/scorecard-service.js';
+const credentialLabel = (v) => {
+    if (v == null)
+        return 'Unknown';
+    const map = {
+        1: 'Certificate',
+        2: "Associate's",
+        3: "Bachelor's",
+        6: 'Post-baccalaureate certificate',
+        7: "Master's",
+        8: 'Doctoral',
+        17: 'Professional',
+    };
+    return map[v] ?? String(v);
+};
+const ProgramSchema = z.object({
+    code: z.string().describe('4-digit CIP program code.'),
+    title: z.string().optional().describe('Program title.'),
+    credential_level: z.string().describe('Degree/credential level.'),
+    earnings_1yr_median: z.number().optional().describe('Median earnings 1 year after graduation.'),
+    earnings_count: z.number().optional().describe('Number of Title IV students in earnings cohort.'),
+    median_debt: z.number().optional().describe('Median debt at graduation.'),
+    enrollment: z.number().optional().describe('IPEDS enrollment count.'),
+    suppressed: z
+        .boolean()
+        .describe('True when earnings data is suppressed due to small cohort (FERPA).'),
+    suppression_note: z
+        .string()
+        .optional()
+        .describe('Explains data suppression when suppressed=true.'),
+});
+export const getProgramsTool = tool('scorecard_get_programs', {
+    title: 'Get School Programs',
+    description: 'All field-of-study programs at one school with 1-year post-graduation earnings (P25/median/P75), debt at graduation, and enrollment figures. This is the primary source for program-level earnings — institution-level 6/8/10-year earnings are available via scorecard_get_earnings. Earnings may be suppressed (null) for programs with small cohorts due to FERPA privacy protection; suppressed=true flags this explicitly. Use scorecard_lookup_cip to find CIP codes by name.',
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
+    input: z.object({
+        id: z
+            .union([
+            z.string().describe('School unit ID as string.'),
+            z.number().describe('School unit ID as number.'),
+        ])
+            .describe('School unit ID from scorecard_search_schools.'),
+        cip_code: z
+            .string()
+            .optional()
+            .describe('Filter to a specific 4-digit CIP code (e.g. "11.07" for Computer Science). Returns only this program.'),
+        min_earnings: z
+            .number()
+            .optional()
+            .describe('Minimum 1-year post-graduation median earnings filter.'),
+        credential_level: z
+            .number()
+            .int()
+            .optional()
+            .describe('Filter by credential level: 1=certificate, 2=associate, 3=bachelor, 6=post-bac cert, 7=master, 8=doctoral, 17=professional.'),
+    }),
+    output: z.object({
+        school_id: z.number().describe('School unit ID.'),
+        school_name: z.string().describe('Institution name.'),
+        programs: z
+            .array(ProgramSchema.describe('Program outcome record.'))
+            .describe('All programs at this school matching the filters. Sorted by median earnings descending (suppressed programs at end).'),
+        total: z.number().describe('Total programs returned after filtering.'),
+        suppressed_count: z
+            .number()
+            .describe('Number of programs with earnings suppressed due to small cohort.'),
+        notice: z
+            .string()
+            .optional()
+            .describe('Guidance when no programs match the filters or all data is suppressed.'),
+    }),
+    errors: [
+        {
+            reason: 'school_not_found',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'No school record found for the requested ID.',
+            recovery: 'Verify the school ID using scorecard_search_schools and retry.',
+        },
+        {
+            reason: 'no_programs',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'No programs matched the filters at this school.',
+            recovery: 'Remove the cip_code or min_earnings filter and retry to see all programs.',
+        },
+        {
+            reason: 'api_error',
+            code: JsonRpcErrorCode.ServiceUnavailable,
+            when: 'The College Scorecard API returned an error.',
+            recovery: 'Check SCORECARD_API_KEY validity and retry after a brief delay.',
+        },
+    ],
+    async handler(input, ctx) {
+        ctx.log.info('Fetching school programs', { id: input.id, cip_code: input.cip_code });
+        const service = getScorecardService();
+        const response = await service.getSchoolPrograms(input.id, input.cip_code, input.min_earnings, input.credential_level, ctx);
+        const record = response.results[0];
+        if (!record) {
+            throw ctx.fail('school_not_found', `No school record found for ID ${input.id}.`, {
+                id: input.id,
+                recovery: { hint: 'Search for valid school IDs with scorecard_search_schools.' },
+            });
+        }
+        const rawPrograms = record['latest.programs.cip_4_digit'] ?? [];
+        // Filter programs by client-supplied criteria
+        let filtered = rawPrograms;
+        if (input.cip_code) {
+            filtered = filtered.filter((p) => p.code === input.cip_code);
+        }
+        if (input.credential_level != null) {
+            filtered = filtered.filter((p) => p.credential?.level === input.credential_level);
+        }
+        const programs = filtered.map((p) => {
+            const rawEarnings = p.earnings?.highest?.['1_yr']?.overall_median_earnings;
+            const suppressed = rawEarnings == null;
+            return {
+                code: p.code ?? 'Unknown',
+                ...(p.title && { title: p.title }),
+                credential_level: credentialLabel(p.credential?.level),
+                ...(rawEarnings != null && { earnings_1yr_median: rawEarnings }),
+                ...(p.earnings?.highest?.['1_yr']?.overall_count_titleiv != null && {
+                    earnings_count: p.earnings.highest['1_yr'].overall_count_titleiv,
+                }),
+                ...(p.debt?.median_debt != null && { median_debt: p.debt.median_debt }),
+                ...(p.counts?.ipeds_enrollment != null && { enrollment: p.counts.ipeds_enrollment }),
+                suppressed,
+                ...(suppressed && {
+                    suppression_note: 'Earnings data suppressed — cohort too small to report under FERPA privacy rules.',
+                }),
+            };
+        });
+        // Apply min_earnings filter after normalization (post-fetch)
+        const minEarnings = input.min_earnings;
+        const earningsFiltered = minEarnings != null
+            ? programs.filter((p) => !p.suppressed && (p.earnings_1yr_median ?? 0) >= minEarnings)
+            : programs;
+        if (earningsFiltered.length === 0) {
+            const hint = filtered.length > 0
+                ? 'Lower the min_earnings threshold or remove it to see all programs.'
+                : 'Remove the cip_code or credential_level filter to see all available programs.';
+            throw ctx.fail('no_programs', `No programs found at school ${input.id} matching the filters.`, {
+                recovery: { hint },
+            });
+        }
+        // Sort: programs with earnings first, descending by earnings
+        const sorted = earningsFiltered.sort((a, b) => {
+            if (a.suppressed && !b.suppressed)
+                return 1;
+            if (!a.suppressed && b.suppressed)
+                return -1;
+            return (b.earnings_1yr_median ?? 0) - (a.earnings_1yr_median ?? 0);
+        });
+        const suppressed_count = sorted.filter((p) => p.suppressed).length;
+        const notice = suppressed_count > 0
+            ? `${suppressed_count} of ${sorted.length} programs have suppressed earnings due to small cohorts (FERPA). These are listed last.`
+            : undefined;
+        return {
+            school_id: record.id ?? Number(input.id),
+            school_name: record['school.name'] ?? 'Unknown',
+            programs: sorted,
+            total: sorted.length,
+            suppressed_count,
+            ...(notice && { notice }),
+        };
+    },
+    format: (result) => {
+        const lines = [
+            `## Programs at ${result.school_name} (ID: ${result.school_id})`,
+            `**Total:** ${result.total} | **Suppressed:** ${result.suppressed_count}`,
+        ];
+        if (result.notice)
+            lines.push(`\n> ${result.notice}`);
+        for (const p of result.programs) {
+            lines.push(`\n**${p.code}** — ${p.title ?? 'Unknown title'} (${p.credential_level})`);
+            lines.push(`1-Year Earnings (median): ${p.earnings_1yr_median != null ? `$${p.earnings_1yr_median.toLocaleString()}` : p.suppressed ? 'Suppressed (small cohort, FERPA)' : 'Not available'}`);
+            if (p.suppression_note != null)
+                lines.push(`Suppression note: ${p.suppression_note}`);
+            if (p.median_debt != null)
+                lines.push(`Median Debt: $${p.median_debt.toLocaleString()}`);
+            if (p.enrollment != null)
+                lines.push(`Enrollment: ${p.enrollment.toLocaleString()}`);
+            if (p.earnings_count != null)
+                lines.push(`Earnings Cohort: ${p.earnings_count} students`);
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=get-programs.tool.js.map

package/dist/mcp-server/tools/definitions/get-programs.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-programs.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-programs.tool.ts"],"names":[],"mappings":"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"}

package/dist/mcp-server/tools/definitions/get-school.tool.d.ts

@@ -0,0 +1,67 @@
+/**
+ * @fileoverview School profile tool. Fetches full institutional profiles for one or more
+ * school IDs — costs, admissions, outcomes, aid, and completion rates.
+ * @module mcp-server/tools/definitions/get-school.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const getSchoolTool: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    id: z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>]>;
+    fields: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    schools: z.ZodArray<z.ZodObject<{
+        id: z.ZodNumber;
+        name: z.ZodString;
+        city: z.ZodOptional<z.ZodString>;
+        state: z.ZodOptional<z.ZodString>;
+        zip: z.ZodOptional<z.ZodString>;
+        url: z.ZodOptional<z.ZodString>;
+        ownership: z.ZodString;
+        degree_level: z.ZodString;
+        hbcu: z.ZodOptional<z.ZodBoolean>;
+        enrollment: z.ZodOptional<z.ZodNumber>;
+        admission_rate: z.ZodOptional<z.ZodNumber>;
+        sat_average: z.ZodOptional<z.ZodNumber>;
+        sat_reading_25: z.ZodOptional<z.ZodNumber>;
+        sat_reading_75: z.ZodOptional<z.ZodNumber>;
+        sat_math_25: z.ZodOptional<z.ZodNumber>;
+        sat_math_75: z.ZodOptional<z.ZodNumber>;
+        act_cumulative_25: z.ZodOptional<z.ZodNumber>;
+        act_cumulative_75: z.ZodOptional<z.ZodNumber>;
+        tuition_in_state: z.ZodOptional<z.ZodNumber>;
+        tuition_out_of_state: z.ZodOptional<z.ZodNumber>;
+        net_price_overall: z.ZodOptional<z.ZodNumber>;
+        net_price_0_30k: z.ZodOptional<z.ZodNumber>;
+        net_price_30k_48k: z.ZodOptional<z.ZodNumber>;
+        net_price_48k_75k: z.ZodOptional<z.ZodNumber>;
+        net_price_75k_110k: z.ZodOptional<z.ZodNumber>;
+        net_price_110k_plus: z.ZodOptional<z.ZodNumber>;
+        cost_of_attendance: z.ZodOptional<z.ZodNumber>;
+        median_debt: z.ZodOptional<z.ZodNumber>;
+        pell_grant_rate: z.ZodOptional<z.ZodNumber>;
+        federal_loan_rate: z.ZodOptional<z.ZodNumber>;
+        repayment_rate_3yr: z.ZodOptional<z.ZodNumber>;
+        completion_rate: z.ZodOptional<z.ZodNumber>;
+        earnings_6yr_median: z.ZodOptional<z.ZodNumber>;
+        earnings_6yr_p25: z.ZodOptional<z.ZodNumber>;
+        earnings_6yr_p75: z.ZodOptional<z.ZodNumber>;
+        earnings_8yr_median: z.ZodOptional<z.ZodNumber>;
+        earnings_10yr_median: z.ZodOptional<z.ZodNumber>;
+        earnings_10yr_p25: z.ZodOptional<z.ZodNumber>;
+        earnings_10yr_p75: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    total_requested: z.ZodNumber;
+    total_found: z.ZodNumber;
+    notice: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, readonly [{
+    readonly reason: "not_found";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "None of the requested school IDs returned a record.";
+    readonly recovery: "Verify the unit IDs using scorecard_search_schools and retry with valid IDs.";
+}, {
+    readonly reason: "api_error";
+    readonly code: JsonRpcErrorCode.ServiceUnavailable;
+    readonly when: "The College Scorecard API returned an error.";
+    readonly recovery: "Check SCORECARD_API_KEY validity and retry after a brief delay.";
+}]>;
+//# sourceMappingURL=get-school.tool.d.ts.map

package/dist/mcp-server/tools/definitions/get-school.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-school.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-school.tool.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAwFjE,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0PxB,CAAC"}

package/dist/mcp-server/tools/definitions/get-school.tool.js

@@ -0,0 +1,324 @@
+/**
+ * @fileoverview School profile tool. Fetches full institutional profiles for one or more
+ * school IDs — costs, admissions, outcomes, aid, and completion rates.
+ * @module mcp-server/tools/definitions/get-school.tool
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { degreeLevelLabel, ownershipLabel } from '../../../mcp-server/format-helpers.js';
+import { getScorecardService } from '../../../services/scorecard/scorecard-service.js';
+function fmt(n, prefix = '') {
+    if (n == null)
+        return 'Not available';
+    return `${prefix}${n.toLocaleString()}`;
+}
+function fmtPct(n) {
+    if (n == null)
+        return 'Not available';
+    return `${(n * 100).toFixed(1)}%`;
+}
+const SchoolProfileSchema = z.object({
+    id: z.number().describe('Unit ID.'),
+    name: z.string().describe('Institution name.'),
+    city: z.string().optional().describe('City.'),
+    state: z.string().optional().describe('State code.'),
+    zip: z.string().optional().describe('ZIP code.'),
+    url: z.string().optional().describe('Institution website.'),
+    ownership: z.string().describe('Control type: Public, Private nonprofit, or For-profit.'),
+    degree_level: z.string().describe('Predominant degree awarded.'),
+    hbcu: z.boolean().optional().describe('Historically Black College or University.'),
+    enrollment: z.number().optional().describe('Undergraduate enrollment.'),
+    // Admissions
+    admission_rate: z.number().optional().describe('Overall admission rate (0–1).'),
+    sat_average: z.number().optional().describe('Average SAT score.'),
+    sat_reading_25: z.number().optional().describe('SAT Critical Reading 25th percentile.'),
+    sat_reading_75: z.number().optional().describe('SAT Critical Reading 75th percentile.'),
+    sat_math_25: z.number().optional().describe('SAT Math 25th percentile.'),
+    sat_math_75: z.number().optional().describe('SAT Math 75th percentile.'),
+    act_cumulative_25: z.number().optional().describe('ACT composite 25th percentile.'),
+    act_cumulative_75: z.number().optional().describe('ACT composite 75th percentile.'),
+    // Cost
+    tuition_in_state: z.number().optional().describe('In-state tuition and fees.'),
+    tuition_out_of_state: z.number().optional().describe('Out-of-state tuition and fees.'),
+    net_price_overall: z.number().optional().describe('Average net price (all income levels).'),
+    net_price_0_30k: z
+        .number()
+        .optional()
+        .describe('Average net price for family income $0–$30,000.'),
+    net_price_30k_48k: z
+        .number()
+        .optional()
+        .describe('Average net price for family income $30,001–$48,000.'),
+    net_price_48k_75k: z
+        .number()
+        .optional()
+        .describe('Average net price for family income $48,001–$75,000.'),
+    net_price_75k_110k: z
+        .number()
+        .optional()
+        .describe('Average net price for family income $75,001–$110,000.'),
+    net_price_110k_plus: z
+        .number()
+        .optional()
+        .describe('Average net price for family income $110,001+.'),
+    cost_of_attendance: z.number().optional().describe('Total cost of attendance per year.'),
+    // Aid
+    median_debt: z.number().optional().describe('Median debt at graduation (completers).'),
+    pell_grant_rate: z.number().optional().describe('Share of students receiving Pell grants (0–1).'),
+    federal_loan_rate: z
+        .number()
+        .optional()
+        .describe('Share of students receiving federal loans (0–1).'),
+    repayment_rate_3yr: z
+        .number()
+        .optional()
+        .describe('3-year loan repayment rate (share not in default, 0–1).'),
+    // Completion
+    completion_rate: z.number().optional().describe('Completion rate at 150% normal time.'),
+    // Earnings
+    earnings_6yr_median: z.number().optional().describe('Median earnings 6 years after entry.'),
+    earnings_6yr_p25: z.number().optional().describe('25th percentile earnings 6 years after entry.'),
+    earnings_6yr_p75: z.number().optional().describe('75th percentile earnings 6 years after entry.'),
+    earnings_8yr_median: z.number().optional().describe('Median earnings 8 years after entry.'),
+    earnings_10yr_median: z.number().optional().describe('Median earnings 10 years after entry.'),
+    earnings_10yr_p25: z
+        .number()
+        .optional()
+        .describe('25th percentile earnings 10 years after entry.'),
+    earnings_10yr_p75: z
+        .number()
+        .optional()
+        .describe('75th percentile earnings 10 years after entry.'),
+});
+export const getSchoolTool = tool('scorecard_get_school', {
+    title: 'Get School Profile',
+    description: 'Full institutional profile for one or more school IDs — costs, admissions, outcomes, aid, demographics, and completion rates. Pass a single ID or an array of up to 100 IDs. For side-by-side comparison on a specific dimension (costs, admissions, outcomes, or aid) use scorecard_compare_schools. The fields parameter accepts a comma-separated list of field paths from scorecard_list_fields to override the default field set.',
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
+    input: z.object({
+        id: z
+            .union([
+            z.string().describe('Single school unit ID as string.'),
+            z.number().describe('Single school unit ID as number.'),
+            z
+                .array(z
+                .union([
+                z.string().describe('School unit ID as string.'),
+                z.number().describe('School unit ID as number.'),
+            ])
+                .describe('School unit ID (string or number).'))
+                .describe('Array of school unit IDs (up to 100).'),
+        ])
+            .describe('School unit ID or array of unit IDs (up to 100). IDs are integers from scorecard_search_schools.'),
+        fields: z
+            .string()
+            .optional()
+            .describe('Optional comma-separated list of custom field paths from scorecard_list_fields. Overrides the default field set.'),
+    }),
+    output: z.object({
+        schools: z
+            .array(SchoolProfileSchema.describe('Full institutional profile.'))
+            .describe('Full profiles for the requested school(s).'),
+        total_requested: z.number().describe('Number of IDs requested.'),
+        total_found: z.number().describe('Number of records returned.'),
+        notice: z.string().optional().describe('Warning when some requested IDs returned no record.'),
+    }),
+    errors: [
+        {
+            reason: 'not_found',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'None of the requested school IDs returned a record.',
+            recovery: 'Verify the unit IDs using scorecard_search_schools and retry with valid IDs.',
+        },
+        {
+            reason: 'api_error',
+            code: JsonRpcErrorCode.ServiceUnavailable,
+            when: 'The College Scorecard API returned an error.',
+            recovery: 'Check SCORECARD_API_KEY validity and retry after a brief delay.',
+        },
+    ],
+    async handler(input, ctx) {
+        const ids = Array.isArray(input.id) ? input.id : [input.id];
+        ctx.log.info('Fetching school profiles', { ids: ids.slice(0, 5), count: ids.length });
+        const service = getScorecardService();
+        const response = await service.getSchoolProfiles(ids, input.fields, ctx);
+        if (response.results.length === 0) {
+            throw ctx.fail('not_found', `No records found for ${ids.length} requested IDs.`, {
+                ids,
+                recovery: { hint: 'Search for valid school IDs using scorecard_search_schools first.' },
+            });
+        }
+        const schools = response.results.map((r) => ({
+            id: r.id ?? 0,
+            name: r['school.name'] ?? 'Unknown',
+            ownership: ownershipLabel(r['school.ownership']),
+            degree_level: degreeLevelLabel(r['school.degrees_awarded.predominant']),
+            ...(r['school.city'] && { city: r['school.city'] }),
+            ...(r['school.state'] && { state: r['school.state'] }),
+            ...(r['school.zip'] && { zip: r['school.zip'] }),
+            ...(r['school.school_url'] && { url: r['school.school_url'] }),
+            ...(r['school.hbcu'] === 1 && { hbcu: true }),
+            ...(r['latest.student.size'] != null && { enrollment: r['latest.student.size'] }),
+            ...(r['latest.admissions.admission_rate.overall'] != null && {
+                admission_rate: r['latest.admissions.admission_rate.overall'],
+            }),
+            ...(r['latest.admissions.sat_scores.average.overall'] != null && {
+                sat_average: r['latest.admissions.sat_scores.average.overall'],
+            }),
+            ...(r['latest.admissions.sat_scores.25th_percentile.critical_reading'] != null && {
+                sat_reading_25: r['latest.admissions.sat_scores.25th_percentile.critical_reading'],
+            }),
+            ...(r['latest.admissions.sat_scores.75th_percentile.critical_reading'] != null && {
+                sat_reading_75: r['latest.admissions.sat_scores.75th_percentile.critical_reading'],
+            }),
+            ...(r['latest.admissions.sat_scores.25th_percentile.math'] != null && {
+                sat_math_25: r['latest.admissions.sat_scores.25th_percentile.math'],
+            }),
+            ...(r['latest.admissions.sat_scores.75th_percentile.math'] != null && {
+                sat_math_75: r['latest.admissions.sat_scores.75th_percentile.math'],
+            }),
+            ...(r['latest.admissions.act_scores.25th_percentile.cumulative'] != null && {
+                act_cumulative_25: r['latest.admissions.act_scores.25th_percentile.cumulative'],
+            }),
+            ...(r['latest.admissions.act_scores.75th_percentile.cumulative'] != null && {
+                act_cumulative_75: r['latest.admissions.act_scores.75th_percentile.cumulative'],
+            }),
+            ...(r['latest.cost.tuition.in_state'] != null && {
+                tuition_in_state: r['latest.cost.tuition.in_state'],
+            }),
+            ...(r['latest.cost.tuition.out_of_state'] != null && {
+                tuition_out_of_state: r['latest.cost.tuition.out_of_state'],
+            }),
+            ...(r['latest.cost.avg_net_price.overall'] != null && {
+                net_price_overall: r['latest.cost.avg_net_price.overall'],
+            }),
+            ...(r['latest.cost.avg_net_price.by_income.0-30000'] != null && {
+                net_price_0_30k: r['latest.cost.avg_net_price.by_income.0-30000'],
+            }),
+            ...(r['latest.cost.avg_net_price.by_income.30001-48000'] != null && {
+                net_price_30k_48k: r['latest.cost.avg_net_price.by_income.30001-48000'],
+            }),
+            ...(r['latest.cost.avg_net_price.by_income.48001-75000'] != null && {
+                net_price_48k_75k: r['latest.cost.avg_net_price.by_income.48001-75000'],
+            }),
+            ...(r['latest.cost.avg_net_price.by_income.75001-110000'] != null && {
+                net_price_75k_110k: r['latest.cost.avg_net_price.by_income.75001-110000'],
+            }),
+            ...(r['latest.cost.avg_net_price.by_income.110001-plus'] != null && {
+                net_price_110k_plus: r['latest.cost.avg_net_price.by_income.110001-plus'],
+            }),
+            ...(r['latest.cost.attendance.academic_year'] != null && {
+                cost_of_attendance: r['latest.cost.attendance.academic_year'],
+            }),
+            ...(r['latest.aid.median_debt.completers.overall'] != null && {
+                median_debt: r['latest.aid.median_debt.completers.overall'],
+            }),
+            ...(r['latest.aid.pell_grant_rate'] != null && {
+                pell_grant_rate: r['latest.aid.pell_grant_rate'],
+            }),
+            ...(r['latest.aid.federal_loan_rate'] != null && {
+                federal_loan_rate: r['latest.aid.federal_loan_rate'],
+            }),
+            ...(r['latest.repayment.3_yr_repayment.overall'] != null && {
+                repayment_rate_3yr: r['latest.repayment.3_yr_repayment.overall'] / 1000,
+            }),
+            ...(r['latest.completion.rate_suppressed.overall'] != null && {
+                completion_rate: r['latest.completion.rate_suppressed.overall'],
+            }),
+            ...(r['latest.earnings.6_yrs_after_entry.median'] != null && {
+                earnings_6yr_median: r['latest.earnings.6_yrs_after_entry.median'],
+            }),
+            ...(r['latest.earnings.6_yrs_after_entry.percentile25'] != null && {
+                earnings_6yr_p25: r['latest.earnings.6_yrs_after_entry.percentile25'],
+            }),
+            ...(r['latest.earnings.6_yrs_after_entry.percentile75'] != null && {
+                earnings_6yr_p75: r['latest.earnings.6_yrs_after_entry.percentile75'],
+            }),
+            ...(r['latest.earnings.8_yrs_after_entry.median_earnings'] != null && {
+                earnings_8yr_median: r['latest.earnings.8_yrs_after_entry.median_earnings'],
+            }),
+            ...(r['latest.earnings.10_yrs_after_entry.median'] != null && {
+                earnings_10yr_median: r['latest.earnings.10_yrs_after_entry.median'],
+            }),
+            ...(r['latest.earnings.10_yrs_after_entry.percentile25'] != null && {
+                earnings_10yr_p25: r['latest.earnings.10_yrs_after_entry.percentile25'],
+            }),
+            ...(r['latest.earnings.10_yrs_after_entry.percentile75'] != null && {
+                earnings_10yr_p75: r['latest.earnings.10_yrs_after_entry.percentile75'],
+            }),
+        }));
+        const notice = schools.length < ids.length
+            ? `${ids.length - schools.length} of ${ids.length} requested IDs returned no record — they may be invalid or no longer in the database.`
+            : undefined;
+        return {
+            schools,
+            total_requested: ids.length,
+            total_found: schools.length,
+            ...(notice && { notice }),
+        };
+    },
+    format: (result) => {
+        const lines = [
+            `## School Profile${result.schools.length > 1 ? 's' : ''}`,
+            `**Requested:** ${result.total_requested} | **Found:** ${result.total_found}`,
+        ];
+        if (result.notice)
+            lines.push(`\n> **Note:** ${result.notice}`);
+        for (const s of result.schools) {
+            lines.push(`\n---\n### ${s.name} (ID: ${s.id})`);
+            const loc = [s.city, s.state].filter(Boolean).join(', ');
+            if (loc)
+                lines.push(`**Location:** ${loc}${s.zip ? ` ${s.zip}` : ''}`);
+            if (s.url)
+                lines.push(`**Website:** ${s.url}`);
+            lines.push(`**Type:** ${s.ownership} | **Degree:** ${s.degree_level}`);
+            if (s.hbcu)
+                lines.push(`**HBCU:** Yes`);
+            if (s.enrollment != null)
+                lines.push(`**Enrollment:** ${s.enrollment.toLocaleString()}`);
+            lines.push('\n**Admissions**');
+            lines.push(`Acceptance Rate: ${fmtPct(s.admission_rate)}`);
+            if (s.sat_average != null)
+                lines.push(`SAT Average: ${s.sat_average}`);
+            if (s.sat_reading_25 != null)
+                lines.push(`SAT Reading: ${s.sat_reading_25}–${s.sat_reading_75 ?? 'N/A'}`);
+            if (s.sat_math_25 != null)
+                lines.push(`SAT Math: ${s.sat_math_25}–${s.sat_math_75}`);
+            if (s.act_cumulative_25 != null)
+                lines.push(`ACT: ${s.act_cumulative_25}–${s.act_cumulative_75}`);
+            lines.push('\n**Cost**');
+            lines.push(`In-State Tuition: ${fmt(s.tuition_in_state, '$')}`);
+            lines.push(`Out-of-State Tuition: ${fmt(s.tuition_out_of_state, '$')}`);
+            lines.push(`Avg Net Price (overall): ${fmt(s.net_price_overall, '$')}`);
+            if (s.net_price_0_30k != null)
+                lines.push(`Net Price ($0–30k income): $${s.net_price_0_30k.toLocaleString()}`);
+            if (s.net_price_30k_48k != null)
+                lines.push(`Net Price ($30k–48k income): $${s.net_price_30k_48k.toLocaleString()}`);
+            if (s.net_price_48k_75k != null)
+                lines.push(`Net Price ($48k–75k income): $${s.net_price_48k_75k.toLocaleString()}`);
+            if (s.net_price_75k_110k != null)
+                lines.push(`Net Price ($75k–110k income): $${s.net_price_75k_110k.toLocaleString()}`);
+            if (s.net_price_110k_plus != null)
+                lines.push(`Net Price ($110k+ income): $${s.net_price_110k_plus.toLocaleString()}`);
+            if (s.cost_of_attendance != null)
+                lines.push(`Total Cost of Attendance: $${s.cost_of_attendance.toLocaleString()}`);
+            lines.push('\n**Financial Aid**');
+            lines.push(`Median Debt at Graduation: ${fmt(s.median_debt, '$')}`);
+            if (s.pell_grant_rate != null)
+                lines.push(`Pell Grant Rate: ${fmtPct(s.pell_grant_rate)}`);
+            if (s.federal_loan_rate != null)
+                lines.push(`Federal Loan Rate: ${fmtPct(s.federal_loan_rate)}`);
+            lines.push(`3-Year Repayment Rate: ${fmtPct(s.repayment_rate_3yr)}`);
+            lines.push('\n**Outcomes**');
+            lines.push(`Completion Rate (150%): ${fmtPct(s.completion_rate)}`);
+            lines.push(`Median Earnings (6yr): ${fmt(s.earnings_6yr_median, '$')}`);
+            if (s.earnings_6yr_p25 != null)
+                lines.push(`Earnings P25/P75 (6yr): $${s.earnings_6yr_p25.toLocaleString()} / $${s.earnings_6yr_p75?.toLocaleString() ?? 'N/A'}`);
+            lines.push(`Median Earnings (8yr): ${fmt(s.earnings_8yr_median, '$')}`);
+            lines.push(`Median Earnings (10yr): ${fmt(s.earnings_10yr_median, '$')}`);
+            if (s.earnings_10yr_p25 != null)
+                lines.push(`Earnings P25/P75 (10yr): $${s.earnings_10yr_p25.toLocaleString()} / $${s.earnings_10yr_p75?.toLocaleString() ?? 'N/A'}`);
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=get-school.tool.js.map