@cyanheads/college-scorecard-mcp-server 0.1.1

package/README.md

@@ -0,0 +1,356 @@
+<div align="center">
+  <h1>@cyanheads/college-scorecard-mcp-server</h1>
+  <p><b>Search, compare, and analyze U.S. college data — costs, earnings, programs, and outcomes — via MCP. STDIO or Streamable HTTP.</b>
+  <div>9 Tools • 2 Resources • 1 Prompt</div>
+  </p>
+</div>
+
+<div align="center">
+
+[![Version](https://img.shields.io/badge/Version-0.1.1-blue.svg?style=flat-square)](./CHANGELOG.md) [![License](https://img.shields.io/badge/License-Apache%202.0-orange.svg?style=flat-square)](./LICENSE) [![TypeScript](https://img.shields.io/badge/TypeScript-^6.0.3-3178C6.svg?style=flat-square)](https://www.typescriptlang.org/) [![Bun](https://img.shields.io/badge/Bun-v1.3.0-blueviolet.svg?style=flat-square)](https://bun.sh/)
+
+[![Framework](https://img.shields.io/badge/Built%20on-@cyanheads/mcp--ts--core-67E8F9?style=flat-square)](https://www.npmjs.com/package/@cyanheads/mcp-ts-core)
+
+</div>
+
+---
+
+## Tools
+
+9 tools for working with U.S. Department of Education College Scorecard data — institution search, program-level earnings, cost and outcomes analysis, and structured comparison:
+
+| Tool | Description |
+|:---|:---|
+| `scorecard_search_schools` | Search and filter institutions by name, location, type, size, and acceptance rate range. Returns core identity and cost metrics. |
+| `scorecard_get_school` | Full institutional profile for one or more school IDs — costs, admissions, outcomes, aid, demographics, and completion rates. |
+| `scorecard_compare_schools` | Normalized side-by-side comparison of 2–5 schools on a named topic. Returns percentile-ranked rows and relative deltas within the result set. |
+| `scorecard_get_programs` | All field-of-study programs at one school: 1-year post-graduation earnings (P25/median/P75), debt at graduation, and enrollment figures. |
+| `scorecard_search_programs` | Find programs by CIP code or keyword across all institutions, ranked by median earnings. Accepts school-side filters (state, ownership, max cost). |
+| `scorecard_get_earnings` | Institution-level post-graduation earnings for one school — median and percentiles at 6, 8, and 10 years after entry, with optional gender breakdown. |
+| `scorecard_value_analysis` | Workflow tool: parallel-fetches cost, debt, repayment, and earnings data, then computes ROI metrics — debt-to-earnings ratio, net price by income bracket, and peer comparisons. |
+| `scorecard_lookup_cip` | Search Classification of Instructional Programs (CIP) codes by keyword or partial name. Served from embedded static data — no API call or rate-limit impact. |
+| `scorecard_list_fields` | Search the Scorecard field catalog by keyword. Returns matching field paths, descriptions, data types, and sort support. Use before passing custom `fields` parameters. |
+
+### `scorecard_search_schools`
+
+Search for institutions using name, location, and institutional filters.
+
+- Free-text name search plus typed filters: state, ownership (public/private nonprofit/private for-profit), degree level, size range, acceptance rate range
+- Geographic proximity filtering by U.S. zip code and distance (miles or km)
+- CIP code filter to find schools offering a specific program family
+- Pagination (`per_page` up to 100, zero-indexed `page`)
+- Returns core identity and cost metrics for quick scanning
+
+---
+
+### `scorecard_get_school`
+
+Fetch a full institutional profile by school ID.
+
+- Accepts a single ID or an array of IDs (batch fetch up to 100 per page)
+- Covers costs, admissions, outcomes, financial aid, demographics, and completion rates
+- Optional `fields` override for callers who need a narrower or broader field set
+- For side-by-side comparison on a specific dimension, use `scorecard_compare_schools`
+
+---
+
+### `scorecard_compare_schools`
+
+Normalized comparison across 2–5 institutions on a named topic.
+
+- Four topics: `costs`, `admissions`, `outcomes`, `aid` — each pulls a curated topic-specific field set
+- Computes within-set percentile ranks and relative deltas — structured output an agent cannot reconstruct from raw profiles
+- Single API call for all schools; normalization applied post-fetch
+- Distinct from `scorecard_get_school` multi-ID: output shape is rows, not profiles
+
+---
+
+### `scorecard_get_programs`
+
+List all field-of-study programs at one school with earnings and debt data.
+
+- Returns P25/median/P75 earnings 1 year after graduation, median debt at graduation, and enrollment figures per program
+- Filter by CIP code to return only matching programs
+- Filter by `credential_level` (certificate, associate's, bachelor's) and minimum earnings threshold
+- Primary source for program-level earnings — institution-level earnings at 6/8/10 years are available via `scorecard_get_earnings`
+- FERPA suppression surfaced as structured `suppressed: true` flag with `suppression_note`, not bare null
+
+---
+
+### `scorecard_search_programs`
+
+Find programs by CIP code or name across all institutions, ranked by median earnings.
+
+- Program-centric: "which schools in Washington have CS programs with median earnings over $80k?"
+- Accepts school-side filters: state, ownership, max net price
+- Earnings and debt thresholds for filtering results
+- Returns school name, school ID, and unit ID alongside program metrics for follow-up chaining
+- Sorting applied post-fetch where earnings fields are not API-indexed
+
+---
+
+### `scorecard_get_earnings`
+
+Institution-level post-graduation earnings for one school.
+
+- Median and P25/P75 earnings at 6, 8, and 10 years after entry
+- Optional gender breakdown when available
+- `years` parameter for time-series analysis; defaults to `latest.*` for current-state queries
+- Reflects outcomes across all graduates, not broken down by program
+
+---
+
+### `scorecard_value_analysis`
+
+Workflow tool: "Is this school worth it?"
+
+- Parallel-fetches cost/debt/repayment and earnings data in two concurrent requests
+- Computes ROI metrics the API does not pre-calculate: debt-to-earnings ratio (median debt / 6-year earnings), net price to first-year earnings ratio, and 3-year loan repayment rate
+- `family_income` parameter selects the applicable net price bracket
+- Fetches peer school identifiers (same Carnegie category and ownership) for comparative median values
+- Returns all source figures alongside derived metrics — callers can audit the arithmetic
+- `data_notes` flags any suppressed or null fields with structured explanations
+
+---
+
+### `scorecard_lookup_cip`
+
+Search CIP codes by keyword or partial name.
+
+- Covers the full ~2,400-code CIP taxonomy embedded as static data
+- No API call required — zero rate-limit impact, works offline
+- Required before using CIP-based filters when the caller knows a program by name but not code
+- Returns matching codes with standard titles
+
+---
+
+### `scorecard_list_fields`
+
+Search the Scorecard field catalog by keyword.
+
+- ~2,800 field entries from the data dictionary, embedded as static data
+- Returns field paths, descriptions, data types, and whether the field supports API-side sorting
+- No API call required — zero rate-limit impact
+- Use before passing custom `fields` parameters to search/get tools
+
+## Resources and prompts
+
+| Type | Name | Description |
+|:---|:---|:---|
+| Resource | `scorecard://school/{id}` | Institutional profile by unit ID — injectable context for school-specific conversations |
+| Resource | `scorecard://programs/{id}` | Program-level outcomes for a school |
+| Prompt | `scorecard_compare_prompt` | Structures a multi-school comparison analysis using Scorecard data |
+
+All resource data is also reachable via tools. Use `scorecard_search_schools` or `scorecard_get_school` to discover school IDs before constructing resource URIs.
+
+## Features
+
+Built on [`@cyanheads/mcp-ts-core`](https://www.npmjs.com/package/@cyanheads/mcp-ts-core):
+
+- Declarative tool, resource, and prompt definitions — single file per primitive, framework handles registration and validation
+- Unified error handling — handlers throw, framework catches, classifies, and formats
+- Pluggable auth: `none`, `jwt`, `oauth`
+- Swappable storage backends: `in-memory`, `filesystem`, `Supabase`, `Cloudflare KV/R2/D1`
+- Structured logging with optional OpenTelemetry tracing
+- STDIO and Streamable HTTP transports
+
+College Scorecard-specific:
+
+- Full College Scorecard API coverage: ~6,500 Title IV institutions, ~2,800 data fields spanning costs, outcomes, demographics, financial aid, and field-of-study earnings
+- Program-level post-graduation earnings: actual median earnings 1 year after graduation for ~6,500 school × CIP code combinations
+- Field pre-selection per tool — curated ~10–20 field sets appropriate to each tool's purpose; optional `fields` override for custom queries
+- Embedded CIP code taxonomy and field catalog: both served as static data with zero API calls and zero rate-limit impact
+- Geographic filtering via U.S. zip code + distance radius
+- `scorecard_value_analysis` workflow tool computes ROI metrics (debt-to-earnings ratio, net price to first-year earnings) that require multiple API round-trips and post-processing arithmetic
+
+Agent-friendly output:
+
+- FERPA suppression surfaced as structured `suppressed: true` flag with `suppression_note` — prevents hallucination of missing earnings data at selective schools with small cohorts
+- Derived metrics alongside source figures in `scorecard_value_analysis` — agents can verify arithmetic and branch on computed values, not raw numbers
+- Percentile ranks and relative deltas in `scorecard_compare_schools` — structured output an agent cannot reconstruct from raw profiles without knowing the full comparison set
+- Post-fetch sorting documented and handled transparently — callers never hit API errors on non-indexed sort fields
+
+## Getting started
+
+Add the following to your MCP client configuration file. See [api.data.gov/signup](https://api.data.gov/signup/) for a free API key.
+
+```json
+{
+  "mcpServers": {
+    "college-scorecard": {
+      "type": "stdio",
+      "command": "bunx",
+      "args": ["@cyanheads/college-scorecard-mcp-server@latest"],
+      "env": {
+        "MCP_TRANSPORT_TYPE": "stdio",
+        "MCP_LOG_LEVEL": "info",
+        "SCORECARD_API_KEY": "your-api-key"
+      }
+    }
+  }
+}
+```
+
+Or with npx (no Bun required):
+
+```json
+{
+  "mcpServers": {
+    "college-scorecard": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "@cyanheads/college-scorecard-mcp-server@latest"],
+      "env": {
+        "MCP_TRANSPORT_TYPE": "stdio",
+        "MCP_LOG_LEVEL": "info",
+        "SCORECARD_API_KEY": "your-api-key"
+      }
+    }
+  }
+}
+```
+
+Or with Docker:
+
+```json
+{
+  "mcpServers": {
+    "college-scorecard": {
+      "type": "stdio",
+      "command": "docker",
+      "args": [
+        "run", "-i", "--rm",
+        "-e", "MCP_TRANSPORT_TYPE=stdio",
+        "-e", "SCORECARD_API_KEY=your-api-key",
+        "ghcr.io/cyanheads/college-scorecard-mcp-server:latest"
+      ]
+    }
+  }
+}
+```
+
+For Streamable HTTP, set the transport and start the server:
+
+```sh
+MCP_TRANSPORT_TYPE=http MCP_HTTP_PORT=3010 SCORECARD_API_KEY=... bun run start:http
+# Server listens at http://localhost:3010/mcp
+```
+
+### Prerequisites
+
+- [Bun v1.3.0](https://bun.sh/) or higher (or Node.js v24+).
+- A College Scorecard API key — free registration at [api.data.gov/signup](https://api.data.gov/signup/). Rate limit: 1,000 requests/hour per key.
+
+### Installation
+
+1. **Clone the repository:**
+
+```sh
+git clone https://github.com/cyanheads/college-scorecard-mcp-server.git
+```
+
+2. **Navigate into the directory:**
+
+```sh
+cd college-scorecard-mcp-server
+```
+
+3. **Install dependencies:**
+
+```sh
+bun install
+```
+
+4. **Configure environment:**
+
+```sh
+cp .env.example .env
+# edit .env and set SCORECARD_API_KEY
+```
+
+## Configuration
+
+All configuration is validated at startup via Zod schemas in `src/config/server-config.ts`. Key environment variables:
+
+| Variable | Description | Default |
+|:---|:---|:---|
+| `SCORECARD_API_KEY` | **Required.** API key from [api.data.gov](https://api.data.gov/signup/). 1,000 req/hour rate limit. | — |
+| `MCP_TRANSPORT_TYPE` | Transport: `stdio` or `http` | `stdio` |
+| `MCP_HTTP_PORT` | HTTP server port | `3010` |
+| `MCP_HTTP_ENDPOINT_PATH` | HTTP endpoint path where the MCP server is mounted | `/mcp` |
+| `MCP_PUBLIC_URL` | Public origin override for TLS-terminating reverse-proxy deployments | none |
+| `MCP_AUTH_MODE` | Authentication: `none`, `jwt`, or `oauth` | `none` |
+| `MCP_LOG_LEVEL` | Log level (`debug`, `info`, `warning`, `error`, etc.) | `info` |
+| `MCP_GC_PRESSURE_INTERVAL_MS` | Opt-in forced-GC pressure loop (ms, Bun only). Try `60000` if heap growth is observed under sustained HTTP load. | `0` (disabled) |
+| `LOGS_DIR` | Directory for log files (Node.js only) | `<project-root>/logs` |
+| `STORAGE_PROVIDER_TYPE` | Storage backend: `in-memory`, `filesystem`, `supabase`, `cloudflare-kv/r2/d1` | `in-memory` |
+| `OTEL_ENABLED` | Enable [OpenTelemetry instrumentation](https://github.com/cyanheads/mcp-ts-core/tree/main/docs/telemetry) | `false` |
+
+See [`.env.example`](./.env.example) for the full list of optional overrides.
+
+## Running the server
+
+### Local development
+
+- **Build and run:**
+
+  ```sh
+  # One-time build
+  bun run rebuild
+
+  # Run the built server
+  bun run start:stdio
+  # or
+  bun run start:http
+  ```
+
+- **Run checks and tests:**
+
+  ```sh
+  bun run devcheck   # Lint, format, typecheck, security
+  bun run test       # Vitest test suite
+  bun run lint:mcp   # Validate MCP definitions against spec
+  ```
+
+### Docker
+
+```sh
+docker build -t college-scorecard-mcp-server .
+docker run --rm -e SCORECARD_API_KEY=your-key -p 3010:3010 college-scorecard-mcp-server
+```
+
+The Dockerfile defaults to HTTP transport, stateless session mode, and logs to `/var/log/college-scorecard-mcp-server`. OpenTelemetry peer dependencies are installed by default — build with `--build-arg OTEL_ENABLED=false` to omit them.
+
+## Project structure
+
+| Directory | Purpose |
+|:---|:---|
+| `src/index.ts` | `createApp()` entry point — registers tools/resources/prompts and inits services. |
+| `src/config` | Server-specific environment variable parsing and validation with Zod. |
+| `src/mcp-server/tools` | Tool definitions (`*.tool.ts`). Nine tools across search, profile, programs, earnings, and analysis. |
+| `src/mcp-server/resources` | Resource definitions. School profile and program outcomes resources. |
+| `src/mcp-server/prompts` | Prompt definitions. Multi-school comparison prompt. |
+| `src/services` | `ScorecardService` — fetch wrapper with retry, field selection, and pagination against the College Scorecard API. |
+| `tests/` | Unit and integration tests mirroring `src/`. |
+
+## Development guide
+
+See [`CLAUDE.md`](./CLAUDE.md) for development guidelines and architectural rules. The short version:
+
+- Handlers throw, framework catches — no `try/catch` in tool logic
+- Use `ctx.log` for request-scoped logging, `ctx.state` for tenant-scoped storage
+- Register new tools and resources via the barrels in `src/mcp-server/*/definitions/index.ts`
+- Wrap external API calls: validate raw → normalize to domain type → return output schema; never fabricate missing fields
+
+## Contributing
+
+Issues and pull requests are welcome. Run checks and tests before submitting:
+
+```sh
+bun run devcheck
+bun run test
+```
+
+## License
+
+Apache-2.0 — see [LICENSE](LICENSE) for details.

package/changelog/0.1.x/0.1.0.md

@@ -0,0 +1,24 @@
+---
+summary: "Initial release — 9 College Scorecard tools (institution search, program earnings, school comparison, value analysis), 2 resources, 1 prompt, embedded CIP taxonomy and field catalog."
+breaking: false
+---
+
+# 0.1.0 — 2026-05-25
+
+## Added
+
+- **`ScorecardService`**: College Scorecard API client (`api.data.gov/ed/collegescorecard/v1`) with retry, field pre-selection, and pagination.
+- **9 tools**:
+  - `scorecard_search_schools` — search institutions by name, location, type, size, and acceptance rate range
+  - `scorecard_get_school` — full institutional profile for one or more school IDs (costs, admissions, outcomes, aid, demographics, completion)
+  - `scorecard_compare_schools` — normalized side-by-side comparison of 2–5 schools on a named topic with percentile ranks and relative deltas
+  - `scorecard_get_programs` — program-level earnings (P25/median/P75), debt, and enrollment for one school
+  - `scorecard_search_programs` — cross-institution program search by CIP code or keyword, ranked by median earnings
+  - `scorecard_get_earnings` — institution-level earnings at 6, 8, and 10 years after entry with optional gender breakdown
+  - `scorecard_value_analysis` — workflow tool: parallel-fetches cost and earnings data, computes debt-to-earnings ratio and net price to first-year earnings with peer comparisons
+  - `scorecard_lookup_cip` — keyword search over the embedded CIP code taxonomy (~2,400 codes, static — no API call)
+  - `scorecard_list_fields` — keyword search over the embedded field catalog (~2,800 entries, static — no API call)
+- **2 resources**: `scorecard://school/{id}`, `scorecard://programs/{id}`
+- **1 prompt**: `scorecard_compare_prompt` — structures a multi-school comparison analysis
+- **FERPA suppression handling**: `suppressed: true` flag and `suppression_note` on program/earnings records where cohort size triggers privacy protection, preventing bare null from reaching callers
+- **Embedded static data**: CIP code taxonomy and Scorecard field catalog bundled at build time; `scorecard_lookup_cip` and `scorecard_list_fields` make zero API calls

package/changelog/0.1.x/0.1.1.md

@@ -0,0 +1,14 @@
+---
+summary: "Field-test fixes — CIP code filtering, repayment rate scaling, credential level path, and format output cleanup."
+breaking: false
+---
+
+# 0.1.1 — 2026-05-25
+
+## Fixed
+
+- **CIP code filtering**: strip the dot separator from CIP codes before sending to the API (`11.0701` → `110701`) — the Scorecard API rejects dotted codes; `scorecard_search_schools`, `scorecard_get_programs`, and `scorecard_search_programs` were all affected.
+- **Repayment rate scaling**: `latest.repayment.3_yr_repayment.overall` is returned as a scaled integer (e.g. `576` = 57.6%) — divide by 1000 before use. Fixed in `scorecard_get_school`, `scorecard_compare_schools`, and `scorecard_value_analysis`.
+- **Credential level field path**: `RawProgram.credential_level` → `credential.level` to match the actual API response shape; fixes `scorecard_get_programs` filtering and `scorecard://programs/{id}` resource output.
+- **`format()` output in `scorecard_get_earnings`**: removed internal field path names from rendered text (e.g. `earnings_6yr_median`) — labels now read as "6-Year Median", "6-Year P25/P75", etc.
+- **`format()` output in `scorecard_compare_schools`**: rank display changed from `value: X rank: Y` to `X (#Y)` for readability.

package/changelog/template.md

@@ -0,0 +1,119 @@
+---
+# FORMAT REFERENCE — do not edit. Copy this file to
+# `changelog/<major.minor>.x/<version>.md` (e.g. `changelog/0.8.x/0.8.6.md`)
+# to author a new release. Set that file's H1 to `# <version> — YYYY-MM-DD`
+# with a concrete date.
+
+# Required. One-line GitHub Release-style headline. 350 character cap.
+# Default short and scannable. Don't pad, don't stitch unrelated changes with
+# semicolons — pick the headline. Quotes required: unquoted YAML treats `: `
+# inside the value as a key separator and fails GitHub's strict parser.
+summary: ""
+
+# Set `true` when consumers must change code to upgrade: API removals,
+# signature changes, config renames, behavior changes that break existing
+# usage. Flagged as `Breaking` in the rollup.
+breaking: false
+
+# Set `true` if this release contains any security fix. Pairs with the
+# `## Security` section below. Flagged as `Security` in the rollup so
+# users can triage upgrade urgency at a glance.
+security: false
+---
+
+# <version> — YYYY-MM-DD
+
+<!--
+  AUTHORING GUIDE — applies to the new per-version file you create from this
+  template.
+
+  Audience: someone scanning release notes to decide what affects them. Lead
+  each bullet with the symbol or concept name in **bold** so they can skip
+  what's irrelevant and zoom in on what's not.
+
+  Tone: terse, fact-dense, not verbose. Default to one sentence per bullet —
+  name the symbol, state what changed, stop. Use a second sentence only when
+  it carries weight. If a bullet feels long, it is.
+
+  Cut: mechanism walkthroughs (those belong in JSDoc, AGENTS.md, or the
+  relevant skill), ceremonial framings ("This release introduces…",
+  backwards-compat paragraphs), file-by-file test enumerations, internal
+  implementation notes. Prefer code/symbol names over English re-explanations.
+
+  Narrative intro: skip by default. Add one short sentence only when the
+  release theme genuinely needs framing the bullets can't carry.
+
+  Sections: Keep a Changelog order — Added, Changed, Deprecated, Removed,
+  Fixed, Security. Include only sections with entries; delete the rest
+  (including the commented-out scaffolding below). Don't ship empty headers.
+
+  Include: every distinct fact a reader needs to adopt or audit the release —
+  new exports, signatures, lint rule IDs, env vars, breaking changes, version
+  bumps on shipped skills. Nothing more.
+
+  Links: link issues, PRs, docs, or skills where they help a reader jump to
+  context. Once per item per entry — don't re-link the same issue in summary,
+  narrative, and bullet. Skip links for inline symbol names; code spans speak
+  for themselves.
+
+  Issue/PR URLs: use full URLs. GitHub's bare `#NN` auto-link only resolves
+  inside its own UI, not in npm reads or local editors.
+
+      [#38](https://github.com/cyanheads/mcp-ts-core/issues/38)   ← issue
+      [#42](https://github.com/cyanheads/mcp-ts-core/pull/42)     ← PR
+
+  Verify numbers exist before linking (`gh issue view NN`, `gh pr view NN`).
+  Never speculate on a future number — `#42` for an upcoming PR silently
+  resolves to whatever real item already owns 42, and timeline previews pull
+  in that unrelated item's metadata.
+
+  TAG ANNOTATIONS — the annotated tag body renders as the GitHub Release body
+  via `gh release create --notes-from-tag`. The tag is a derivative of this
+  changelog entry — a condensed, scannable version, not a copy. Format:
+
+    <theme — omit version number, GitHub prepends it>
+                                                          ← blank line
+    <1-2 sentence context: what this release does>
+                                                          ← blank line
+    Dependency bumps:                                     ← section header
+                                                          ← blank line
+    - `@cyanheads/mcp-ts-core` ^0.9.1 → ^0.9.6          ← bullet
+                                                          ← blank line
+    Changed:                                              ← only sections with entries
+                                                          ← blank line
+    - `format()` output includes `query` in text mode
+                                                          ← blank line
+    Added:
+                                                          ← blank line
+    - `manifest.json` scaffolded for MCPB bundle support
+    - Install badges (Claude Desktop, Cursor, VS Code)
+                                                          ← blank line
+    <N> tests pass; `bun run devcheck` clean.             ← footer
+
+  Never a flat comma-separated string. Always structured markdown with
+  sections. The tag must scan well as a rendered GitHub Release page.
+-->
+
+## Added
+
+-
+
+## Changed
+
+-
+
+<!-- ## Deprecated
+
+- -->
+
+<!-- ## Removed
+
+- -->
+
+## Fixed
+
+-
+
+<!-- ## Security
+
+- -->

package/dist/config/server-config.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @fileoverview Server-specific environment variable config for college-scorecard-mcp-server.
+ * @module config/server-config
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+declare const ServerConfigSchema: z.ZodObject<{
+    apiKey: z.ZodString;
+}, z.core.$strip>;
+export type ServerConfig = z.infer<typeof ServerConfigSchema>;
+export declare function getServerConfig(): ServerConfig;
+export {};
+//# sourceMappingURL=server-config.d.ts.map

package/dist/config/server-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-config.d.ts","sourceRoot":"","sources":["../../src/config/server-config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAG3C,QAAA,MAAM,kBAAkB;;iBAEtB,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAI9D,wBAAgB,eAAe,IAAI,YAAY,CAK9C"}

package/dist/config/server-config.js

@@ -0,0 +1,17 @@
+/**
+ * @fileoverview Server-specific environment variable config for college-scorecard-mcp-server.
+ * @module config/server-config
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { parseEnvConfig } from '@cyanheads/mcp-ts-core/config';
+const ServerConfigSchema = z.object({
+    apiKey: z.string().min(1).describe('API key from api.data.gov (free registration)'),
+});
+let _config;
+export function getServerConfig() {
+    _config ??= parseEnvConfig(ServerConfigSchema, {
+        apiKey: 'SCORECARD_API_KEY',
+    });
+    return _config;
+}
+//# sourceMappingURL=server-config.js.map

package/dist/config/server-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-config.js","sourceRoot":"","sources":["../../src/config/server-config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAE/D,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,+CAA+C,CAAC;CACpF,CAAC,CAAC;AAIH,IAAI,OAAiC,CAAC;AAEtC,MAAM,UAAU,eAAe;IAC7B,OAAO,KAAK,cAAc,CAAC,kBAAkB,EAAE;QAC7C,MAAM,EAAE,mBAAmB;KAC5B,CAAC,CAAC;IACH,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/data/cip-codes.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @fileoverview Embedded CIP (Classification of Instructional Programs) code taxonomy.
+ * Derived from NCES CIP 2020 taxonomy. Static data — no API call required.
+ * @module data/cip-codes
+ */
+export interface CipEntry {
+    /** 4-digit CIP code (e.g. "11.07") */
+    code: string;
+    /** Standard title for the program (e.g. "Computer Science") */
+    title: string;
+    /** 2-digit family code (e.g. "11") */
+    family: string;
+    /** Family name (e.g. "Computer And Information Sciences And Support Services") */
+    familyTitle: string;
+}
+/** 4-digit CIP code taxonomy — common programs for college/career exploration. */
+export declare const CIP_CODES: CipEntry[];
+/**
+ * Search CIP codes by keyword — matches against code, title, family title.
+ * Returns up to `limit` results (default 20).
+ */
+export declare function searchCipCodes(query: string, limit?: number): CipEntry[];
+//# sourceMappingURL=cip-codes.d.ts.map

package/dist/data/cip-codes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cip-codes.d.ts","sourceRoot":"","sources":["../../src/data/cip-codes.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,QAAQ;IACvB,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,KAAK,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,kFAAkF;IAClF,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,kFAAkF;AAClF,eAAO,MAAM,SAAS,EAAE,QAAQ,EA4Q/B,CAAC;AAEF;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,QAAQ,EAAE,CAuBpE"}