@cyanheads/college-scorecard-mcp-server 0.1.1

package/dist/mcp-server/format-helpers.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @fileoverview Shared label helpers for formatting Scorecard API integer codes.
+ * @module mcp-server/format-helpers
+ */
+/** Map ownership integer to human-readable label */
+export declare function ownershipLabel(v: number | null | undefined): string;
+/** Map degree level integer to label */
+export declare function degreeLevelLabel(v: number | null | undefined): string;
+//# sourceMappingURL=format-helpers.d.ts.map

package/dist/mcp-server/format-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-helpers.d.ts","sourceRoot":"","sources":["../../src/mcp-server/format-helpers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,oDAAoD;AACpD,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAGnE;AAED,wCAAwC;AACxC,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAUrE"}

package/dist/mcp-server/format-helpers.js

@@ -0,0 +1,24 @@
+/**
+ * @fileoverview Shared label helpers for formatting Scorecard API integer codes.
+ * @module mcp-server/format-helpers
+ */
+/** Map ownership integer to human-readable label */
+export function ownershipLabel(v) {
+    if (v == null)
+        return 'Unknown';
+    return v === 1 ? 'Public' : v === 2 ? 'Private nonprofit' : v === 3 ? 'For-profit' : String(v);
+}
+/** Map degree level integer to label */
+export function degreeLevelLabel(v) {
+    if (v == null)
+        return 'Unknown';
+    const map = {
+        0: 'Non-degree',
+        1: 'Certificate',
+        2: "Associate's",
+        3: "Bachelor's",
+        4: 'Graduate',
+    };
+    return map[v] ?? String(v);
+}
+//# sourceMappingURL=format-helpers.js.map

package/dist/mcp-server/format-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-helpers.js","sourceRoot":"","sources":["../../src/mcp-server/format-helpers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,oDAAoD;AACpD,MAAM,UAAU,cAAc,CAAC,CAA4B;IACzD,IAAI,CAAC,IAAI,IAAI;QAAE,OAAO,SAAS,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;AACjG,CAAC;AAED,wCAAwC;AACxC,MAAM,UAAU,gBAAgB,CAAC,CAA4B;IAC3D,IAAI,CAAC,IAAI,IAAI;QAAE,OAAO,SAAS,CAAC;IAChC,MAAM,GAAG,GAA2B;QAClC,CAAC,EAAE,YAAY;QACf,CAAC,EAAE,aAAa;QAChB,CAAC,EAAE,aAAa;QAChB,CAAC,EAAE,YAAY;QACf,CAAC,EAAE,UAAU;KACd,CAAC;IACF,OAAO,GAAG,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC;AAC7B,CAAC"}

package/dist/mcp-server/prompts/definitions/compare.prompt.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @fileoverview School comparison prompt. Structures a multi-school comparison analysis
+ * using Scorecard data.
+ * @module mcp-server/prompts/definitions/compare.prompt
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+export declare const comparePrompt: import("@cyanheads/mcp-ts-core").PromptDefinition<z.ZodObject<{
+    school_names: z.ZodString;
+    focus: z.ZodEnum<{
+        costs: "costs";
+        outcomes: "outcomes";
+        programs: "programs";
+    }>;
+}, z.core.$strip>>;
+//# sourceMappingURL=compare.prompt.d.ts.map

package/dist/mcp-server/prompts/definitions/compare.prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compare.prompt.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/compare.prompt.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAU,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAEnD,eAAO,MAAM,aAAa;;;;;;;kBAwDxB,CAAC"}

package/dist/mcp-server/prompts/definitions/compare.prompt.js

@@ -0,0 +1,55 @@
+/**
+ * @fileoverview School comparison prompt. Structures a multi-school comparison analysis
+ * using Scorecard data.
+ * @module mcp-server/prompts/definitions/compare.prompt
+ */
+import { prompt, z } from '@cyanheads/mcp-ts-core';
+export const comparePrompt = prompt('scorecard_compare_prompt', {
+    description: 'Structures a multi-school comparison analysis using College Scorecard data. Provide comma-separated school names and a focus area (costs, outcomes, or programs) to generate a research-ready comparison framework.',
+    args: z.object({
+        school_names: z
+            .string()
+            .describe('Comma-separated list of school names to compare (e.g. "University of Washington, University of Oregon, Oregon State University").'),
+        focus: z
+            .enum(['costs', 'outcomes', 'programs'])
+            .describe('Comparison focus: costs (tuition, net price, debt), outcomes (earnings, completion, repayment), or programs (program-level earnings by field of study).'),
+    }),
+    generate: (args) => {
+        const schools = args.school_names.split(',').map((s) => s.trim());
+        const focusGuide = {
+            costs: 'net price by income bracket, median debt, tuition (in-state and out-of-state), and total cost of attendance',
+            outcomes: 'graduation rates, median earnings at 6 and 10 years, 3-year loan repayment rate, and debt-to-earnings ratio',
+            programs: 'program-level 1-year post-graduation median earnings by CIP code, median debt per program, and enrollment',
+        };
+        const guide = focusGuide[args.focus] ?? args.focus;
+        return [
+            {
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: [
+                        `Compare the following schools on ${args.focus}: ${schools.join(', ')}.`,
+                        '',
+                        `Focus the analysis on: ${guide}.`,
+                        '',
+                        'Steps:',
+                        `1. Use scorecard_search_schools to find the unit IDs for each school.`,
+                        `2. Use scorecard_compare_schools with the topic "${args.focus}" to get a normalized side-by-side comparison.`,
+                        `3. For deeper context, use scorecard_get_school to retrieve full profiles.`,
+                        ...(args.focus === 'programs'
+                            ? [
+                                `4. Use scorecard_get_programs for program-level earnings at each school.`,
+                                `5. Use scorecard_lookup_cip if you need to find CIP codes for specific fields of study.`,
+                            ]
+                            : [
+                                `4. Use scorecard_value_analysis for ROI metrics (debt-to-earnings ratio, net price by income bracket).`,
+                            ]),
+                        '',
+                        `Present a clear comparison table with ranks within this set, followed by a brief interpretation of the most meaningful differences.`,
+                    ].join('\n'),
+                },
+            },
+        ];
+    },
+});
+//# sourceMappingURL=compare.prompt.js.map

package/dist/mcp-server/prompts/definitions/compare.prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compare.prompt.js","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/compare.prompt.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAEnD,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC,0BAA0B,EAAE;IAC9D,WAAW,EACT,qNAAqN;IACvN,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;QACb,YAAY,EAAE,CAAC;aACZ,MAAM,EAAE;aACR,QAAQ,CACP,mIAAmI,CACpI;QACH,KAAK,EAAE,CAAC;aACL,IAAI,CAAC,CAAC,OAAO,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;aACvC,QAAQ,CACP,yJAAyJ,CAC1J;KACJ,CAAC;IACF,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE;QACjB,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QAClE,MAAM,UAAU,GAA2B;YACzC,KAAK,EACH,6GAA6G;YAC/G,QAAQ,EACN,6GAA6G;YAC/G,QAAQ,EACN,2GAA2G;SAC9G,CAAC;QACF,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC;QAEnD,OAAO;YACL;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE;oBACP,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE;wBACJ,oCAAoC,IAAI,CAAC,KAAK,KAAK,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;wBACxE,EAAE;wBACF,0BAA0B,KAAK,GAAG;wBAClC,EAAE;wBACF,QAAQ;wBACR,uEAAuE;wBACvE,oDAAoD,IAAI,CAAC,KAAK,gDAAgD;wBAC9G,4EAA4E;wBAC5E,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK,UAAU;4BAC3B,CAAC,CAAC;gCACE,0EAA0E;gCAC1E,yFAAyF;6BAC1F;4BACH,CAAC,CAAC;gCACE,wGAAwG;6BACzG,CAAC;wBACN,EAAE;wBACF,qIAAqI;qBACtI,CAAC,IAAI,CAAC,IAAI,CAAC;iBACb;aACF;SACF,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

package/dist/mcp-server/resources/definitions/programs.resource.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @fileoverview Programs resource. Provides program-level outcomes for a school
+ * as injectable context.
+ * @module mcp-server/resources/definitions/programs.resource
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+export declare const programsResource: import("@cyanheads/mcp-ts-core").ResourceDefinition<z.ZodObject<{
+    id: z.ZodString;
+}, z.core.$strip>, undefined, undefined>;
+//# sourceMappingURL=programs.resource.d.ts.map

package/dist/mcp-server/resources/definitions/programs.resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"programs.resource.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/programs.resource.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAY,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAIrD,eAAO,MAAM,gBAAgB;;wCA6C3B,CAAC"}

package/dist/mcp-server/resources/definitions/programs.resource.js

@@ -0,0 +1,42 @@
+/**
+ * @fileoverview Programs resource. Provides program-level outcomes for a school
+ * as injectable context.
+ * @module mcp-server/resources/definitions/programs.resource
+ */
+import { resource, z } from '@cyanheads/mcp-ts-core';
+import { notFound } from '@cyanheads/mcp-ts-core/errors';
+import { getScorecardService } from '../../../services/scorecard/scorecard-service.js';
+export const programsResource = resource('scorecard://programs/{id}', {
+    name: 'scorecard-programs',
+    title: 'School Programs',
+    description: 'Program-level outcomes for a school — 1-year post-graduation earnings, debt, and enrollment by CIP code. Injectable context for program-focused conversations.',
+    mimeType: 'application/json',
+    params: z.object({
+        id: z.string().describe('School unit ID (integer as string).'),
+    }),
+    async handler(params, ctx) {
+        ctx.log.info('Fetching programs resource', { id: params.id });
+        const service = getScorecardService();
+        const response = await service.getSchoolPrograms(params.id, undefined, undefined, undefined, ctx);
+        const record = response.results[0];
+        if (!record) {
+            throw notFound(`School ${params.id} not found.`, { id: params.id });
+        }
+        const rawPrograms = record['latest.programs.cip_4_digit'] ?? [];
+        const programs = rawPrograms.map((p) => ({
+            code: p.code,
+            title: p.title,
+            credential_level: p.credential?.level ?? null,
+            earnings_1yr_median: p.earnings?.highest?.['1_yr']?.overall_median_earnings ?? null,
+            median_debt: p.debt?.median_debt ?? null,
+            enrollment: p.counts?.ipeds_enrollment ?? null,
+        }));
+        return {
+            school_id: record.id,
+            school_name: record['school.name'],
+            programs,
+            total: programs.length,
+        };
+    },
+});
+//# sourceMappingURL=programs.resource.js.map

package/dist/mcp-server/resources/definitions/programs.resource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"programs.resource.js","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/programs.resource.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,2CAA2C,CAAC;AAEhF,MAAM,CAAC,MAAM,gBAAgB,GAAG,QAAQ,CAAC,2BAA2B,EAAE;IACpE,IAAI,EAAE,oBAAoB;IAC1B,KAAK,EAAE,iBAAiB;IACxB,WAAW,EACT,gKAAgK;IAClK,QAAQ,EAAE,kBAAkB;IAC5B,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;KAC/D,CAAC;IAEF,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG;QACvB,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,4BAA4B,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;QAC9D,MAAM,OAAO,GAAG,mBAAmB,EAAE,CAAC;QAEtC,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,iBAAiB,CAC9C,MAAM,CAAC,EAAE,EACT,SAAS,EACT,SAAS,EACT,SAAS,EACT,GAAG,CACJ,CAAC;QAEF,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QACnC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,QAAQ,CAAC,UAAU,MAAM,CAAC,EAAE,aAAa,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;QACtE,CAAC;QAED,MAAM,WAAW,GAAG,MAAM,CAAC,6BAA6B,CAAC,IAAI,EAAE,CAAC;QAEhE,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACvC,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,gBAAgB,EAAE,CAAC,CAAC,UAAU,EAAE,KAAK,IAAI,IAAI;YAC7C,mBAAmB,EAAE,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,uBAAuB,IAAI,IAAI;YACnF,WAAW,EAAE,CAAC,CAAC,IAAI,EAAE,WAAW,IAAI,IAAI;YACxC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,gBAAgB,IAAI,IAAI;SAC/C,CAAC,CAAC,CAAC;QAEJ,OAAO;YACL,SAAS,EAAE,MAAM,CAAC,EAAE;YACpB,WAAW,EAAE,MAAM,CAAC,aAAa,CAAC;YAClC,QAAQ;YACR,KAAK,EAAE,QAAQ,CAAC,MAAM;SACvB,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

package/dist/mcp-server/resources/definitions/school.resource.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @fileoverview School profile resource. Provides institutional profile by unit ID
+ * as injectable context for school-specific conversations.
+ * @module mcp-server/resources/definitions/school.resource
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+export declare const schoolResource: import("@cyanheads/mcp-ts-core").ResourceDefinition<z.ZodObject<{
+    id: z.ZodString;
+}, z.core.$strip>, undefined, undefined>;
+//# sourceMappingURL=school.resource.d.ts.map

package/dist/mcp-server/resources/definitions/school.resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"school.resource.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/school.resource.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAY,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAIrD,eAAO,MAAM,cAAc;;wCAsCzB,CAAC"}

package/dist/mcp-server/resources/definitions/school.resource.js

@@ -0,0 +1,43 @@
+/**
+ * @fileoverview School profile resource. Provides institutional profile by unit ID
+ * as injectable context for school-specific conversations.
+ * @module mcp-server/resources/definitions/school.resource
+ */
+import { resource, z } from '@cyanheads/mcp-ts-core';
+import { notFound } from '@cyanheads/mcp-ts-core/errors';
+import { getScorecardService } from '../../../services/scorecard/scorecard-service.js';
+export const schoolResource = resource('scorecard://school/{id}', {
+    name: 'scorecard-school',
+    title: 'School Profile',
+    description: 'Institutional profile by unit ID — injectable context for school-specific conversations. Returns core identity, cost, admissions, and outcomes data.',
+    mimeType: 'application/json',
+    params: z.object({
+        id: z.string().describe('School unit ID (integer as string).'),
+    }),
+    async handler(params, ctx) {
+        ctx.log.info('Fetching school resource', { id: params.id });
+        const service = getScorecardService();
+        const response = await service.getSchoolProfiles([params.id], undefined, ctx);
+        const record = response.results[0];
+        if (!record) {
+            throw notFound(`School ${params.id} not found.`, { id: params.id });
+        }
+        return {
+            id: record.id,
+            name: record['school.name'],
+            city: record['school.city'],
+            state: record['school.state'],
+            ownership: record['school.ownership'],
+            tuition_in_state: record['latest.cost.tuition.in_state'],
+            tuition_out_of_state: record['latest.cost.tuition.out_of_state'],
+            net_price_overall: record['latest.cost.avg_net_price.overall'],
+            admission_rate: record['latest.admissions.admission_rate.overall'],
+            enrollment: record['latest.student.size'],
+            median_debt: record['latest.aid.median_debt.completers.overall'],
+            completion_rate: record['latest.completion.rate_suppressed.overall'],
+            earnings_6yr_median: record['latest.earnings.6_yrs_after_entry.median'],
+            earnings_10yr_median: record['latest.earnings.10_yrs_after_entry.median'],
+        };
+    },
+});
+//# sourceMappingURL=school.resource.js.map

package/dist/mcp-server/resources/definitions/school.resource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"school.resource.js","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/school.resource.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,2CAA2C,CAAC;AAEhF,MAAM,CAAC,MAAM,cAAc,GAAG,QAAQ,CAAC,yBAAyB,EAAE;IAChE,IAAI,EAAE,kBAAkB;IACxB,KAAK,EAAE,gBAAgB;IACvB,WAAW,EACT,sJAAsJ;IACxJ,QAAQ,EAAE,kBAAkB;IAC5B,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;KAC/D,CAAC;IAEF,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG;QACvB,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,0BAA0B,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;QAC5D,MAAM,OAAO,GAAG,mBAAmB,EAAE,CAAC;QAEtC,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,iBAAiB,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC;QAE9E,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QACnC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,QAAQ,CAAC,UAAU,MAAM,CAAC,EAAE,aAAa,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;QACtE,CAAC;QAED,OAAO;YACL,EAAE,EAAE,MAAM,CAAC,EAAE;YACb,IAAI,EAAE,MAAM,CAAC,aAAa,CAAC;YAC3B,IAAI,EAAE,MAAM,CAAC,aAAa,CAAC;YAC3B,KAAK,EAAE,MAAM,CAAC,cAAc,CAAC;YAC7B,SAAS,EAAE,MAAM,CAAC,kBAAkB,CAAC;YACrC,gBAAgB,EAAE,MAAM,CAAC,8BAA8B,CAAC;YACxD,oBAAoB,EAAE,MAAM,CAAC,kCAAkC,CAAC;YAChE,iBAAiB,EAAE,MAAM,CAAC,mCAAmC,CAAC;YAC9D,cAAc,EAAE,MAAM,CAAC,0CAA0C,CAAC;YAClE,UAAU,EAAE,MAAM,CAAC,qBAAqB,CAAC;YACzC,WAAW,EAAE,MAAM,CAAC,2CAA2C,CAAC;YAChE,eAAe,EAAE,MAAM,CAAC,2CAA2C,CAAC;YACpE,mBAAmB,EAAE,MAAM,CAAC,0CAA0C,CAAC;YACvE,oBAAoB,EAAE,MAAM,CAAC,2CAA2C,CAAC;SAC1E,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

package/dist/mcp-server/tools/definitions/compare-schools.tool.d.ts

@@ -0,0 +1,46 @@
+/**
+ * @fileoverview School comparison tool. Returns normalized side-by-side comparison
+ * of 2–5 schools with percentile ranks and relative deltas within the result set.
+ * @module mcp-server/tools/definitions/compare-schools.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const compareSchoolsTool: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    ids: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+    topic: z.ZodEnum<{
+        costs: "costs";
+        outcomes: "outcomes";
+        admissions: "admissions";
+        aid: "aid";
+    }>;
+}, z.core.$strip>, z.ZodObject<{
+    schools: z.ZodArray<z.ZodObject<{
+        id: z.ZodNumber;
+        name: z.ZodString;
+    }, z.core.$strip>>;
+    topic: z.ZodString;
+    rows: z.ZodArray<z.ZodObject<{
+        metric: z.ZodString;
+        values: z.ZodArray<z.ZodObject<{
+            school_id: z.ZodNumber;
+            value: z.ZodOptional<z.ZodNumber>;
+            rank: z.ZodOptional<z.ZodNumber>;
+            suppressed: z.ZodBoolean;
+        }, z.core.$strip>>;
+        unit: z.ZodOptional<z.ZodString>;
+        note: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    summary: z.ZodOptional<z.ZodString>;
+    notice: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, readonly [{
+    readonly reason: "schools_not_found";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "None of the requested school IDs returned records.";
+    readonly recovery: "Verify school IDs with 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=compare-schools.tool.d.ts.map

package/dist/mcp-server/tools/definitions/compare-schools.tool.d.ts.map

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