us-gov-open-data-mcp 1.0.0

package/dist/modules/cfpb.js

@@ -0,0 +1,135 @@
+/**
+ * CFPB MCP module — Consumer Financial Protection Bureau complaint database.
+ */
+import { z } from "zod";
+import { searchComplaints, getComplaintAggregations, getComplaintTrends, suggestCompany, PRODUCTS, AGG_FIELDS, } from "../sdk/cfpb.js";
+export const name = "cfpb";
+export const displayName = "CFPB (Consumer Financial Protection Bureau)";
+export const description = "Consumer complaint database with 13M+ complaints against financial companies. " +
+    "Search by company, product, state, issue, date. Track complaint trends and company response patterns.";
+export const workflow = "cfpb_search_complaints to find complaints → cfpb_complaint_aggregations for counts by field → cfpb_complaint_trends for time series";
+export const tips = "Products: 'Mortgage', 'Credit reporting...', 'Debt collection', 'Credit card or prepaid card', 'Checking or savings account', " +
+    "'Student loan', 'Vehicle loan or lease'. States: two-letter codes (CA, TX, NY). " +
+    "Sort options: 'created_date_desc' (newest), 'created_date_asc' (oldest), 'relevance_desc'. " +
+    "Date format: YYYY-MM-DD. Use has_narrative=true to find complaints with consumer stories.";
+export const reference = {
+    products: PRODUCTS,
+    aggregationFields: AGG_FIELDS,
+    docs: {
+        "API Documentation": "https://cfpb.github.io/api/ccdb/",
+        "Complaint Database": "https://www.consumerfinance.gov/data-research/consumer-complaints/",
+    },
+};
+export const tools = [
+    {
+        name: "cfpb_search_complaints",
+        description: "Search the CFPB consumer complaint database (13M+ records).\n" +
+            "Find complaints by company, product, state, issue, date, or keyword.\n" +
+            "Returns individual complaints with company responses.\n" +
+            "Products: 'Mortgage', 'Debt collection', 'Credit card or prepaid card', 'Checking or savings account', " +
+            "'Student loan', 'Vehicle loan or lease', 'Credit reporting, credit repair services, or other personal consumer reports'.",
+        annotations: { title: "CFPB: Search Complaints", readOnlyHint: true },
+        parameters: z.object({
+            search_term: z.string().optional().describe("Free-text search across complaint narratives"),
+            product: z.string().optional().describe("Financial product: 'Mortgage', 'Debt collection', 'Credit card or prepaid card', etc."),
+            company: z.string().optional().describe("Company name: 'Wells Fargo', 'Bank of America', 'Equifax', etc."),
+            state: z.string().optional().describe("Two-letter state code: 'CA', 'TX', 'NY'"),
+            issue: z.string().optional().describe("Issue type: 'Incorrect information on your report', 'Loan modification', etc."),
+            date_received_min: z.string().optional().describe("Start date (YYYY-MM-DD): '2020-01-01'"),
+            date_received_max: z.string().optional().describe("End date (YYYY-MM-DD): '2024-12-31'"),
+            has_narrative: z.boolean().optional().describe("Only complaints with consumer narrative text (true/false)"),
+            tags: z.string().optional().describe("Filter by tags: 'Older American', 'Servicemember'"),
+            size: z.number().int().max(100).optional().describe("Results per page (default 10, max 100)"),
+            sort: z.string().optional().describe("Sort: 'created_date_desc' (newest), 'created_date_asc', 'relevance_desc'"),
+        }),
+        execute: async (args) => {
+            const data = await searchComplaints({ ...args, no_aggs: true });
+            const total = typeof data.hits?.total === "object" ? data.hits.total.value : data.hits?.total ?? 0;
+            const complaints = data.hits?.hits?.map(h => h._source) ?? [];
+            if (!complaints.length)
+                return "No complaints found matching the search criteria.";
+            return JSON.stringify({
+                summary: `CFPB complaints: ${total.toLocaleString()} total matches, showing ${complaints.length}`,
+                meta: data._meta,
+                total,
+                complaints: complaints.slice(0, 50),
+            });
+        },
+    },
+    {
+        name: "cfpb_complaint_aggregations",
+        description: "Get complaint counts grouped by a field (product, company, state, issue, etc.).\n" +
+            "Useful for ranking companies by complaint volume, identifying top issues, or comparing states.\n" +
+            "Aggregation fields: 'product', 'company', 'state', 'issue', 'company_response', 'timely', 'submitted_via', 'tags'.",
+        annotations: { title: "CFPB: Complaint Aggregations", readOnlyHint: true },
+        parameters: z.object({
+            field: z.string().describe("Field to group by: 'product', 'company', 'state', 'issue', 'company_response', 'timely', 'tags'"),
+            product: z.string().optional().describe("Filter by product: 'Mortgage', 'Debt collection', etc."),
+            company: z.string().optional().describe("Filter by company: 'Wells Fargo', 'Bank of America', etc."),
+            state: z.string().optional().describe("Filter by state: 'CA', 'TX', 'NY'"),
+            issue: z.string().optional().describe("Filter by issue type"),
+            date_received_min: z.string().optional().describe("Start date (YYYY-MM-DD)"),
+            date_received_max: z.string().optional().describe("End date (YYYY-MM-DD)"),
+        }),
+        execute: async (args) => {
+            const data = await getComplaintAggregations(args);
+            const total = typeof data.hits?.total === "object" ? data.hits.total.value : data.hits?.total ?? 0;
+            // Extract aggregation buckets — the key varies by field
+            const aggs = data.aggregations ?? data.aggs ?? {};
+            return JSON.stringify({
+                summary: `CFPB aggregation by '${args.field}': ${total.toLocaleString()} total complaints`,
+                total,
+                aggregations: aggs,
+                meta: data._meta,
+            });
+        },
+    },
+    {
+        name: "cfpb_complaint_trends",
+        description: "Get complaint trends over time by month, week, or year.\n" +
+            "Track how complaint volume changes for specific companies, products, or states.",
+        annotations: { title: "CFPB: Complaint Trends", readOnlyHint: true },
+        parameters: z.object({
+            product: z.string().optional().describe("Financial product: 'Mortgage', 'Debt collection', etc."),
+            company: z.string().optional().describe("Company name: 'Wells Fargo', 'Equifax', etc."),
+            state: z.string().optional().describe("Two-letter state code: 'CA', 'TX', 'NY'"),
+            issue: z.string().optional().describe("Issue type filter"),
+            date_received_min: z.string().optional().describe("Start date (YYYY-MM-DD)"),
+            date_received_max: z.string().optional().describe("End date (YYYY-MM-DD)"),
+            trend_interval: z.string().optional().describe("Interval: 'month' (default), 'week', 'year'"),
+        }),
+        execute: async (args) => {
+            const data = await getComplaintTrends(args);
+            const total = typeof data.hits?.total === "object" ? data.hits.total.value : data.hits?.total ?? 0;
+            const aggs = data.aggregations ?? data.aggs ?? {};
+            return JSON.stringify({
+                summary: `CFPB complaint trends: ${total.toLocaleString()} total, interval=${args.trend_interval ?? "month"}`,
+                total,
+                aggregations: aggs,
+                meta: data._meta,
+            });
+        },
+    },
+    {
+        name: "cfpb_suggest_company",
+        description: "Autocomplete/suggest company names from the CFPB complaint database.\n" +
+            "Useful for finding the exact company name before searching complaints.",
+        annotations: { title: "CFPB: Suggest Company", readOnlyHint: true },
+        parameters: z.object({
+            text: z.string().describe("Partial company name to search: 'wells', 'bank of', 'equi'"),
+            size: z.number().int().max(20).optional().describe("Max suggestions (default 10)"),
+        }),
+        execute: async ({ text, size }) => {
+            const data = await suggestCompany(text, size);
+            const suggestions = data.suggest?.[0]?.options?.map(o => o.text) ?? [];
+            if (!suggestions.length)
+                return `No company name suggestions for "${text}".`;
+            return JSON.stringify({
+                summary: `Company suggestions for "${text}": ${suggestions.length} matches`,
+                suggestions,
+            });
+        },
+    },
+];
+export { clearCache } from "../sdk/cfpb.js";
+//# sourceMappingURL=cfpb.js.map

package/dist/modules/cfpb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cfpb.js","sourceRoot":"","sources":["../../src/modules/cfpb.ts"],"names":[],"mappings":"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"}

package/dist/modules/clinical-trials.d.ts

@@ -0,0 +1,22 @@
+/**
+ * ClinicalTrials.gov module — clinical trial search and detail.
+ */
+import type { Tool } from "fastmcp";
+import { clearCache as sdkClearCache } from "../sdk/clinical-trials.js";
+export declare const name = "clinical-trials";
+export declare const displayName = "ClinicalTrials.gov";
+export declare const description = "Search 400K+ clinical trials: conditions, drugs, sponsors, phases, recruitment status, locations. Cross-reference with FDA (drug approvals), CDC (health outcomes), and lobbying data. No API key required.";
+export declare const workflow = "Use clinical_trials_search to find trials by condition/drug/sponsor \u2192 clinical_trials_detail for full protocol \u2192 clinical_trials_stats for enrollment by status.";
+export declare const tips = "Statuses: RECRUITING, COMPLETED, ACTIVE_NOT_RECRUITING, TERMINATED. Phases: PHASE1, PHASE2, PHASE3, PHASE4. Search by sponsor name (e.g. 'Pfizer', 'NIH') to track industry vs. government research.";
+export declare const reference: {
+    statuses: Record<string, string>;
+    phases: Record<string, string>;
+    studyTypes: Record<string, string>;
+    docs: {
+        "API v2 Documentation": string;
+        "ClinicalTrials.gov": string;
+    };
+};
+export declare const tools: Tool<any, any>[];
+export { sdkClearCache as clearCache };
+//# sourceMappingURL=clinical-trials.d.ts.map

package/dist/modules/clinical-trials.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clinical-trials.d.ts","sourceRoot":"","sources":["../../src/modules/clinical-trials.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAOL,UAAU,IAAI,aAAa,EAE5B,MAAM,2BAA2B,CAAC;AAInC,eAAO,MAAM,IAAI,oBAAoB,CAAC;AACtC,eAAO,MAAM,WAAW,uBAAuB,CAAC;AAChD,eAAO,MAAM,WAAW,gNACuL,CAAC;AAChN,eAAO,MAAM,QAAQ,+KAC+I,CAAC;AACrK,eAAO,MAAM,IAAI,yMACuL,CAAC;AAEzM,eAAO,MAAM,SAAS;;;;;;;;CAQrB,CAAC;AA8CF,eAAO,MAAM,KAAK,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,EAuHjC,CAAC;AAEF,OAAO,EAAE,aAAa,IAAI,UAAU,EAAE,CAAC"}

package/dist/modules/clinical-trials.js

@@ -0,0 +1,171 @@
+/**
+ * ClinicalTrials.gov module — clinical trial search and detail.
+ */
+import { z } from "zod";
+import { searchTrials, getTrialDetail, getTrialEnrollmentStats, TRIAL_STATUSES, TRIAL_PHASES, STUDY_TYPES, clearCache as sdkClearCache, } from "../sdk/clinical-trials.js";
+// ─── Metadata ────────────────────────────────────────────────────────
+export const name = "clinical-trials";
+export const displayName = "ClinicalTrials.gov";
+export const description = "Search 400K+ clinical trials: conditions, drugs, sponsors, phases, recruitment status, locations. Cross-reference with FDA (drug approvals), CDC (health outcomes), and lobbying data. No API key required.";
+export const workflow = "Use clinical_trials_search to find trials by condition/drug/sponsor → clinical_trials_detail for full protocol → clinical_trials_stats for enrollment by status.";
+export const tips = "Statuses: RECRUITING, COMPLETED, ACTIVE_NOT_RECRUITING, TERMINATED. Phases: PHASE1, PHASE2, PHASE3, PHASE4. Search by sponsor name (e.g. 'Pfizer', 'NIH') to track industry vs. government research.";
+export const reference = {
+    statuses: TRIAL_STATUSES,
+    phases: TRIAL_PHASES,
+    studyTypes: STUDY_TYPES,
+    docs: {
+        "API v2 Documentation": "https://clinicaltrials.gov/data-api/api",
+        "ClinicalTrials.gov": "https://clinicaltrials.gov/",
+    },
+};
+// ─── Helpers ─────────────────────────────────────────────────────────
+function summarizeTrial(study) {
+    const p = study.protocolSection;
+    if (!p)
+        return "No protocol data available.";
+    const id = p.identificationModule;
+    const status = p.statusModule;
+    const design = p.designModule;
+    const sponsor = p.sponsorCollaboratorsModule;
+    const conds = p.conditionsModule?.conditions?.join(", ") ?? "N/A";
+    const interventions = p.armsInterventionsModule?.interventions
+        ?.map((i) => `${i.type ?? "?"}: ${i.name ?? "?"}`)
+        .join("; ") ?? "N/A";
+    const parts = [
+        `${id?.nctId ?? "?"} — ${id?.briefTitle ?? "Untitled"}`,
+        `Status: ${status?.overallStatus ?? "?"}`,
+        `Phase: ${design?.phases?.join(", ") ?? "N/A"}`,
+        `Type: ${design?.studyType ?? "?"}`,
+        `Sponsor: ${sponsor?.leadSponsor?.name ?? "?"} (${sponsor?.leadSponsor?.class ?? "?"})`,
+        `Conditions: ${conds}`,
+        `Interventions: ${interventions}`,
+        `Enrollment: ${design?.enrollmentInfo?.count ?? "?"} (${design?.enrollmentInfo?.type ?? "?"})`,
+    ];
+    if (status?.startDateStruct?.date)
+        parts.push(`Start: ${status.startDateStruct.date}`);
+    if (status?.primaryCompletionDateStruct?.date)
+        parts.push(`Primary Completion: ${status.primaryCompletionDateStruct.date}`);
+    const collabs = sponsor?.collaborators?.map((c) => c.name).join(", ");
+    if (collabs)
+        parts.push(`Collaborators: ${collabs}`);
+    const locations = p.contactsLocationsModule?.locations?.slice(0, 5);
+    if (locations?.length) {
+        parts.push(`Locations (${p.contactsLocationsModule?.locations?.length ?? 0} total):`);
+        locations.forEach((l) => {
+            parts.push(`  ${l.facility ?? "?"}, ${l.city ?? ""} ${l.state ?? ""} ${l.country ?? ""}`);
+        });
+    }
+    return parts.join("\n");
+}
+// ─── Tools ───────────────────────────────────────────────────────────
+export const tools = [
+    {
+        name: "clinical_trials_search",
+        description: "Search ClinicalTrials.gov for clinical trials by condition, drug/intervention, sponsor, status, and phase.\n" +
+            "Returns trial ID, title, status, phase, sponsor, conditions, and enrollment.\n" +
+            "Use sponsor filter to track pharma company research (e.g. 'Pfizer', 'Moderna', 'NIH').",
+        annotations: { title: "ClinicalTrials.gov: Search", readOnlyHint: true },
+        parameters: z.object({
+            query: z.string().optional().describe("Free-text search across all fields"),
+            condition: z.string().optional().describe("Disease or condition: 'lung cancer', 'diabetes', 'Alzheimer'"),
+            intervention: z.string().optional().describe("Drug, device, or procedure name: 'pembrolizumab', 'insulin'"),
+            sponsor: z.string().optional().describe("Sponsor/funder: 'Pfizer', 'NIH', 'Moderna'"),
+            status: z.string().optional().describe("RECRUITING, COMPLETED, ACTIVE_NOT_RECRUITING, NOT_YET_RECRUITING, TERMINATED"),
+            phase: z.string().optional().describe("PHASE1, PHASE2, PHASE3, PHASE4, EARLY_PHASE1"),
+            study_type: z.string().optional().describe("INTERVENTIONAL, OBSERVATIONAL, EXPANDED_ACCESS"),
+            location: z.string().optional().describe("State or country: 'California', 'United States', 'Germany'"),
+            page_size: z.number().int().max(50).optional().describe("Results per page (default 10, max 50)"),
+        }),
+        execute: async (args) => {
+            const data = await searchTrials({
+                query: args.query,
+                condition: args.condition,
+                intervention: args.intervention,
+                sponsor: args.sponsor,
+                status: args.status,
+                phase: args.phase,
+                studyType: args.study_type,
+                state: args.location,
+                pageSize: args.page_size,
+            });
+            if (!data.studies?.length)
+                return { content: [{ type: "text", text: "No clinical trials found matching the criteria." }] };
+            const header = `${data.totalCount} total trials found (showing ${data.studies.length})`;
+            const summaries = data.studies.map(summarizeTrial);
+            return { content: [{ type: "text", text: `${header}\n\n${summaries.join("\n\n---\n\n")}` }] };
+        },
+    },
+    {
+        name: "clinical_trials_detail",
+        description: "Get full details for a specific clinical trial by NCT ID.\n" +
+            "Returns protocol, eligibility criteria, arms/interventions, locations, and contacts.",
+        annotations: { title: "ClinicalTrials.gov: Detail", readOnlyHint: true },
+        parameters: z.object({
+            nct_id: z.string().describe("ClinicalTrials.gov ID: 'NCT06000000'"),
+        }),
+        execute: async (args) => {
+            const study = await getTrialDetail(args.nct_id);
+            const summary = summarizeTrial(study);
+            // Add eligibility if available
+            const elig = study.protocolSection?.eligibilityModule;
+            let extra = "";
+            if (elig) {
+                const pieces = [
+                    `\n\n--- ELIGIBILITY ---`,
+                    `Sex: ${elig.sex ?? "All"}`,
+                    `Ages: ${elig.minimumAge ?? "N/A"} to ${elig.maximumAge ?? "N/A"}`,
+                    `Healthy Volunteers: ${elig.healthyVolunteers ? "Yes" : "No"}`,
+                ];
+                if (elig.eligibilityCriteria) {
+                    pieces.push(`\nCriteria:\n${elig.eligibilityCriteria.slice(0, 2000)}`);
+                }
+                extra = pieces.join("\n");
+            }
+            // Add brief summary
+            const desc = study.protocolSection?.descriptionModule?.briefSummary;
+            if (desc)
+                extra += `\n\n--- SUMMARY ---\n${desc}`;
+            return { content: [{ type: "text", text: summary + extra }] };
+        },
+    },
+    {
+        name: "clinical_trials_stats",
+        description: "Get trial count breakdown by status for a condition or drug/intervention.\n" +
+            "Shows how many trials are recruiting, active, completed, or terminated.\n" +
+            "Works for diseases ('breast cancer') AND drug names ('semaglutide', 'pembrolizumab').",
+        annotations: { title: "ClinicalTrials.gov: Stats", readOnlyHint: true },
+        parameters: z.object({
+            condition: z.string().describe("Disease, condition, or drug name: 'breast cancer', 'semaglutide', 'Alzheimer Disease'"),
+            search_as_drug: z.boolean().optional().describe("Set true to search as drug/intervention instead of condition (use for drug names like 'semaglutide', 'pembrolizumab')"),
+        }),
+        execute: async (args) => {
+            const data = args.search_as_drug
+                ? await getTrialEnrollmentStats(args.condition, { intervention: args.condition })
+                : await getTrialEnrollmentStats(args.condition);
+            const lines = Object.entries(data.statuses).map(([status, count]) => `  ${status}: ${count.toLocaleString()}`);
+            const total = Object.values(data.statuses).reduce((a, b) => a + b, 0);
+            // If zero results for condition search, auto-retry as intervention
+            if (total === 0 && !args.search_as_drug) {
+                const retryData = await getTrialEnrollmentStats(args.condition, { intervention: args.condition });
+                const retryTotal = Object.values(retryData.statuses).reduce((a, b) => a + b, 0);
+                if (retryTotal > 0) {
+                    const retryLines = Object.entries(retryData.statuses).map(([status, count]) => `  ${status}: ${count.toLocaleString()}`);
+                    return {
+                        content: [{
+                                type: "text",
+                                text: `Clinical trials for "${args.condition}" as intervention (${retryTotal.toLocaleString()} total):\n${retryLines.join("\n")}`,
+                            }],
+                    };
+                }
+            }
+            return {
+                content: [{
+                        type: "text",
+                        text: `Clinical trials for "${data.condition}" (${total.toLocaleString()} total):\n${lines.join("\n")}`,
+                    }],
+            };
+        },
+    },
+];
+export { sdkClearCache as clearCache };
+//# sourceMappingURL=clinical-trials.js.map

package/dist/modules/clinical-trials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clinical-trials.js","sourceRoot":"","sources":["../../src/modules/clinical-trials.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EACL,YAAY,EACZ,cAAc,EACd,uBAAuB,EACvB,cAAc,EACd,YAAY,EACZ,WAAW,EACX,UAAU,IAAI,aAAa,GAE5B,MAAM,2BAA2B,CAAC;AAEnC,wEAAwE;AAExE,MAAM,CAAC,MAAM,IAAI,GAAG,iBAAiB,CAAC;AACtC,MAAM,CAAC,MAAM,WAAW,GAAG,oBAAoB,CAAC;AAChD,MAAM,CAAC,MAAM,WAAW,GACtB,6MAA6M,CAAC;AAChN,MAAM,CAAC,MAAM,QAAQ,GACnB,kKAAkK,CAAC;AACrK,MAAM,CAAC,MAAM,IAAI,GACf,sMAAsM,CAAC;AAEzM,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,QAAQ,EAAE,cAAc;IACxB,MAAM,EAAE,YAAY;IACpB,UAAU,EAAE,WAAW;IACvB,IAAI,EAAE;QACJ,sBAAsB,EAAE,yCAAyC;QACjE,oBAAoB,EAAE,6BAA6B;KACpD;CACF,CAAC;AAEF,wEAAwE;AAExE,SAAS,cAAc,CAAC,KAAiB;IACvC,MAAM,CAAC,GAAG,KAAK,CAAC,eAAe,CAAC;IAChC,IAAI,CAAC,CAAC;QAAE,OAAO,6BAA6B,CAAC;IAC7C,MAAM,EAAE,GAAG,CAAC,CAAC,oBAAoB,CAAC;IAClC,MAAM,MAAM,GAAG,CAAC,CAAC,YAAY,CAAC;IAC9B,MAAM,MAAM,GAAG,CAAC,CAAC,YAAY,CAAC;IAC9B,MAAM,OAAO,GAAG,CAAC,CAAC,0BAA0B,CAAC;IAC7C,MAAM,KAAK,GAAG,CAAC,CAAC,gBAAgB,EAAE,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC;IAClE,MAAM,aAAa,GAAG,CAAC,CAAC,uBAAuB,EAAE,aAAa;QAC5D,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,GAAG,KAAK,CAAC,CAAC,IAAI,IAAI,GAAG,EAAE,CAAC;SACjD,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC;IAEvB,MAAM,KAAK,GAAG;QACZ,GAAG,EAAE,EAAE,KAAK,IAAI,GAAG,MAAM,EAAE,EAAE,UAAU,IAAI,UAAU,EAAE;QACvD,WAAW,MAAM,EAAE,aAAa,IAAI,GAAG,EAAE;QACzC,UAAU,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,EAAE;QAC/C,SAAS,MAAM,EAAE,SAAS,IAAI,GAAG,EAAE;QACnC,YAAY,OAAO,EAAE,WAAW,EAAE,IAAI,IAAI,GAAG,KAAK,OAAO,EAAE,WAAW,EAAE,KAAK,IAAI,GAAG,GAAG;QACvF,eAAe,KAAK,EAAE;QACtB,kBAAkB,aAAa,EAAE;QACjC,eAAe,MAAM,EAAE,cAAc,EAAE,KAAK,IAAI,GAAG,KAAK,MAAM,EAAE,cAAc,EAAE,IAAI,IAAI,GAAG,GAAG;KAC/F,CAAC;IAEF,IAAI,MAAM,EAAE,eAAe,EAAE,IAAI;QAAE,KAAK,CAAC,IAAI,CAAC,UAAU,MAAM,CAAC,eAAe,CAAC,IAAI,EAAE,CAAC,CAAC;IACvF,IAAI,MAAM,EAAE,2BAA2B,EAAE,IAAI;QAAE,KAAK,CAAC,IAAI,CAAC,uBAAuB,MAAM,CAAC,2BAA2B,CAAC,IAAI,EAAE,CAAC,CAAC;IAE5H,MAAM,OAAO,GAAG,OAAO,EAAE,aAAa,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtE,IAAI,OAAO;QAAE,KAAK,CAAC,IAAI,CAAC,kBAAkB,OAAO,EAAE,CAAC,CAAC;IAErD,MAAM,SAAS,GAAG,CAAC,CAAC,uBAAuB,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACpE,IAAI,SAAS,EAAE,MAAM,EAAE,CAAC;QACtB,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,uBAAuB,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC,UAAU,CAAC,CAAC;QACtF,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE;YACtB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,IAAI,GAAG,KAAK,CAAC,CAAC,IAAI,IAAI,EAAE,IAAI,CAAC,CAAC,KAAK,IAAI,EAAE,IAAI,CAAC,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC,CAAC;QAC5F,CAAC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,wEAAwE;AAExE,MAAM,CAAC,MAAM,KAAK,GAAqB;IACrC;QACE,IAAI,EAAE,wBAAwB;QAC9B,WAAW,EACT,8GAA8G;YAC9G,gFAAgF;YAChF,wFAAwF;QAC1F,WAAW,EAAE,EAAE,KAAK,EAAE,4BAA4B,EAAE,YAAY,EAAE,IAAI,EAAE;QACxE,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;YACnB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;YAC3E,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8DAA8D,CAAC;YACzG,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6DAA6D,CAAC;YAC3G,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC;YACrF,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8EAA8E,CAAC;YACtH,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8CAA8C,CAAC;YACrF,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gDAAgD,CAAC;YAC5F,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4DAA4D,CAAC;YACtG,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;SACjG,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YACtB,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC;gBAC9B,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,YAAY,EAAE,IAAI,CAAC,YAAY;gBAC/B,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,SAAS,EAAE,IAAI,CAAC,UAAU;gBAC1B,KAAK,EAAE,IAAI,CAAC,QAAQ;gBACpB,QAAQ,EAAE,IAAI,CAAC,SAAS;aACzB,CAAC,CAAC;YACH,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM;gBAAE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,iDAAiD,EAAE,CAAC,EAAE,CAAC;YAEpI,MAAM,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,gCAAgC,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;YACxF,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;YACnD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,GAAG,MAAM,OAAO,SAAS,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;QACzG,CAAC;KACF;IAED;QACE,IAAI,EAAE,wBAAwB;QAC9B,WAAW,EACT,6DAA6D;YAC7D,sFAAsF;QACxF,WAAW,EAAE,EAAE,KAAK,EAAE,4BAA4B,EAAE,YAAY,EAAE,IAAI,EAAE;QACxE,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;YACnB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;SACpE,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YACtB,MAAM,KAAK,GAAG,MAAM,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAChD,MAAM,OAAO,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;YAEtC,+BAA+B;YAC/B,MAAM,IAAI,GAAG,KAAK,CAAC,eAAe,EAAE,iBAAiB,CAAC;YACtD,IAAI,KAAK,GAAG,EAAE,CAAC;YACf,IAAI,IAAI,EAAE,CAAC;gBACT,MAAM,MAAM,GAAG;oBACb,yBAAyB;oBACzB,QAAQ,IAAI,CAAC,GAAG,IAAI,KAAK,EAAE;oBAC3B,SAAS,IAAI,CAAC,UAAU,IAAI,KAAK,OAAO,IAAI,CAAC,UAAU,IAAI,KAAK,EAAE;oBAClE,uBAAuB,IAAI,CAAC,iBAAiB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE;iBAC/D,CAAC;gBACF,IAAI,IAAI,CAAC,mBAAmB,EAAE,CAAC;oBAC7B,MAAM,CAAC,IAAI,CAAC,gBAAgB,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;gBACzE,CAAC;gBACD,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC5B,CAAC;YAED,oBAAoB;YACpB,MAAM,IAAI,GAAG,KAAK,CAAC,eAAe,EAAE,iBAAiB,EAAE,YAAY,CAAC;YACpE,IAAI,IAAI;gBAAE,KAAK,IAAI,wBAAwB,IAAI,EAAE,CAAC;YAElD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,OAAO,GAAG,KAAK,EAAE,CAAC,EAAE,CAAC;QACzE,CAAC;KACF;IAED;QACE,IAAI,EAAE,uBAAuB;QAC7B,WAAW,EACT,6EAA6E;YAC7E,2EAA2E;YAC3E,uFAAuF;QACzF,WAAW,EAAE,EAAE,KAAK,EAAE,2BAA2B,EAAE,YAAY,EAAE,IAAI,EAAE;QACvE,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;YACnB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uFAAuF,CAAC;YACvH,cAAc,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uHAAuH,CAAC;SACzK,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YACtB,MAAM,IAAI,GAAG,IAAI,CAAC,cAAc;gBAC9B,CAAC,CAAC,MAAM,uBAAuB,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,YAAY,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC;gBACjF,CAAC,CAAC,MAAM,uBAAuB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAClD,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,GAAG,CAC7C,CAAC,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,MAAM,KAAK,KAAK,CAAC,cAAc,EAAE,EAAE,CAC9D,CAAC;YACF,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;YACtE,mEAAmE;YACnE,IAAI,KAAK,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;gBACxC,MAAM,SAAS,GAAG,MAAM,uBAAuB,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,YAAY,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;gBAClG,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;gBAChF,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;oBACnB,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,GAAG,CACvD,CAAC,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,MAAM,KAAK,KAAK,CAAC,cAAc,EAAE,EAAE,CAC9D,CAAC;oBACF,OAAO;wBACL,OAAO,EAAE,CAAC;gCACR,IAAI,EAAE,MAAe;gCACrB,IAAI,EAAE,wBAAwB,IAAI,CAAC,SAAS,sBAAsB,UAAU,CAAC,cAAc,EAAE,aAAa,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;6BAClI,CAAC;qBACH,CAAC;gBACJ,CAAC;YACH,CAAC;YACD,OAAO;gBACL,OAAO,EAAE,CAAC;wBACR,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,wBAAwB,IAAI,CAAC,SAAS,MAAM,KAAK,CAAC,cAAc,EAAE,aAAa,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;qBACxG,CAAC;aACH,CAAC;QACJ,CAAC;KACF;CACF,CAAC;AAEF,OAAO,EAAE,aAAa,IAAI,UAAU,EAAE,CAAC"}

package/dist/modules/cms.d.ts

@@ -0,0 +1,21 @@
+/**
+ * CMS module — hospital compare, nursing home ratings, Medicare spending, provider data
+ */
+import type { Tool } from "fastmcp";
+import { clearCache as sdkClearCache } from "../sdk/cms.js";
+export declare const name = "cms";
+export declare const displayName = "CMS";
+export declare const description = "Centers for Medicare & Medicaid Services \u2014 hospital compare, nursing home ratings, home health agencies, hospice, dialysis, Medicare spending, HCAHPS patient surveys, quality measures. No API key required.";
+export declare const workflow = "Use cms_search to find datasets by keyword \u2192 cms_hospitals for hospital quality data \u2192 cms_nursing_homes for nursing home ratings \u2192 cms_query for any CMS provider dataset.";
+export declare const tips = "CMS has 100+ provider datasets. Use cms_search to discover them. Common dataset keys: hospital_info, nursing_home_info, hospital_mortality, hospital_readmissions, hospital_infections, hospital_timely_care, hospital_spending, hospital_patient_survey, nursing_home_health_citations. Filter by state using conditions like property='state' value='CA'.";
+export declare const reference: {
+    datasets: Record<string, {
+        id: string;
+        name: string;
+        description: string;
+        theme: string;
+    }>;
+};
+export declare const tools: Tool<any, any>[];
+export { sdkClearCache as clearCache };
+//# sourceMappingURL=cms.d.ts.map

package/dist/modules/cms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cms.d.ts","sourceRoot":"","sources":["../../src/modules/cms.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAIL,UAAU,IAAI,aAAa,EAE5B,MAAM,eAAe,CAAC;AAIvB,eAAO,MAAM,IAAI,QAAQ,CAAC;AAC1B,eAAO,MAAM,WAAW,QAAQ,CAAC;AACjC,eAAO,MAAM,WAAW,uNACyL,CAAC;AAClN,eAAO,MAAM,QAAQ,+LAC0J,CAAC;AAChL,eAAO,MAAM,IAAI,gWAC8U,CAAC;AAChW,eAAO,MAAM,SAAS;;;;;;;CAAyB,CAAC;AA8BhD,eAAO,MAAM,KAAK,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,EA0GjC,CAAC;AAEF,OAAO,EAAE,aAAa,IAAI,UAAU,EAAE,CAAC"}

package/dist/modules/cms.js

@@ -0,0 +1,135 @@
+/**
+ * CMS module — hospital compare, nursing home ratings, Medicare spending, provider data
+ */
+import { z } from "zod";
+import { searchDatasets, queryDataset, queryByKey, clearCache as sdkClearCache, DATASETS, } from "../sdk/cms.js";
+// ─── Metadata ────────────────────────────────────────────────────────
+export const name = "cms";
+export const displayName = "CMS";
+export const description = "Centers for Medicare & Medicaid Services — hospital compare, nursing home ratings, home health agencies, hospice, dialysis, Medicare spending, HCAHPS patient surveys, quality measures. No API key required.";
+export const workflow = "Use cms_search to find datasets by keyword → cms_hospitals for hospital quality data → cms_nursing_homes for nursing home ratings → cms_query for any CMS provider dataset.";
+export const tips = "CMS has 100+ provider datasets. Use cms_search to discover them. Common dataset keys: hospital_info, nursing_home_info, hospital_mortality, hospital_readmissions, hospital_infections, hospital_timely_care, hospital_spending, hospital_patient_survey, nursing_home_health_citations. Filter by state using conditions like property='state' value='CA'.";
+export const reference = { datasets: DATASETS };
+// ─── Helpers ─────────────────────────────────────────────────────────
+function summarizeResults(data, count) {
+    if (!data.length)
+        return "No records found.";
+    const preview = data.slice(0, 10);
+    const lines = preview.map((r, i) => {
+        // Try to extract key fields for readability
+        const name = r.facility_name ?? r.provider_name ?? r.hospital_name ?? r["Facility Name"] ?? r["Provider Name"] ?? "";
+        const state = r.state ?? r.provider_state ?? r["State"] ?? "";
+        const city = r.city ?? r.provider_city ?? r["City"] ?? "";
+        const rating = r.overall_rating ?? r.hospital_overall_rating ?? r["Overall Rating"] ?? "";
+        const location = [city, state].filter(Boolean).join(", ");
+        const header = name ? `${name}${location ? ` (${location})` : ""}` : `Record ${i + 1}`;
+        const ratingStr = rating ? ` — Rating: ${rating}` : "";
+        return `[${i + 1}] ${header}${ratingStr}\n     ${JSON.stringify(r)}`;
+    });
+    const total = count ?? data.length;
+    const header = `${total} record(s)${total > 10 ? " (showing first 10)" : ""}:`;
+    return `${header}\n\n${lines.join("\n\n")}`;
+}
+// ─── Tools ───────────────────────────────────────────────────────────
+export const tools = [
+    {
+        name: "cms_search",
+        description: "Search for CMS provider data datasets by keyword. Returns dataset IDs, titles, and descriptions. Use the ID with cms_query to fetch data.",
+        annotations: { title: "CMS Dataset Search", readOnlyHint: true },
+        parameters: z.object({
+            keyword: z.string().describe("Search keyword (e.g. 'hospital', 'nursing home', 'dialysis', 'hospice', 'readmission', 'infection')"),
+        }),
+        execute: async (args) => {
+            const results = await searchDatasets(args.keyword);
+            if (!results.length)
+                return { content: [{ type: "text", text: "No datasets found." }] };
+            const lines = results.map((d) => `[${d.identifier}] ${d.title}\n  ${d.description?.slice(0, 200) ?? ""}${d.theme ? `\n  Theme: ${d.theme.join(", ")}` : ""}`);
+            return {
+                content: [{ type: "text", text: `${results.length} dataset(s) found:\n\n${lines.join("\n\n")}` }],
+            };
+        },
+    },
+    {
+        name: "cms_hospitals",
+        description: "Query CMS hospital data: general info, quality ratings, mortality, readmissions, infections, patient surveys, Medicare spending. Filter by state or city.",
+        annotations: { title: "CMS Hospital Data", readOnlyHint: true },
+        parameters: z.object({
+            dataset: z
+                .enum([
+                "hospital_info",
+                "hospital_mortality",
+                "hospital_readmissions",
+                "hospital_infections",
+                "hospital_timely_care",
+                "hospital_spending",
+                "hospital_patient_survey",
+            ])
+                .default("hospital_info")
+                .describe("Hospital dataset to query"),
+            state: z.string().max(2).optional().describe("Two-letter state code (e.g. CA, TX, NY)"),
+            city: z.string().optional().describe("City name"),
+            limit: z.number().optional().describe("Max results (default 50)"),
+        }),
+        execute: async (args) => {
+            const conditions = [];
+            if (args.state)
+                conditions.push({ property: "state", value: args.state.toUpperCase() });
+            if (args.city)
+                conditions.push({ property: "city", value: args.city.toUpperCase() });
+            const result = await queryByKey(args.dataset, conditions, args.limit);
+            return { content: [{ type: "text", text: summarizeResults(result.results, result.count) }] };
+        },
+    },
+    {
+        name: "cms_nursing_homes",
+        description: "Query CMS nursing home data: provider info with five-star ratings, quality measures, health deficiencies/citations. Filter by state.",
+        annotations: { title: "CMS Nursing Home Data", readOnlyHint: true },
+        parameters: z.object({
+            dataset: z
+                .enum(["nursing_home_info", "nursing_home_health_citations", "nursing_home_quality"])
+                .default("nursing_home_info")
+                .describe("Nursing home dataset to query"),
+            state: z.string().max(2).optional().describe("Two-letter state code"),
+            limit: z.number().optional().describe("Max results (default 50)"),
+        }),
+        execute: async (args) => {
+            const conditions = [];
+            if (args.state)
+                conditions.push({ property: "state", value: args.state.toUpperCase() });
+            const result = await queryByKey(args.dataset, conditions, args.limit);
+            return { content: [{ type: "text", text: summarizeResults(result.results, result.count) }] };
+        },
+    },
+    {
+        name: "cms_query",
+        description: "General-purpose query against any CMS provider dataset by dataset identifier. Use cms_search to find available datasets and their IDs. Supports filtering by any field.",
+        annotations: { title: "CMS Query", readOnlyHint: true },
+        parameters: z.object({
+            dataset_id: z
+                .string()
+                .describe("CMS dataset identifier (e.g. 'xubh-q36u' for hospitals, '4pq5-n9py' for nursing homes) or catalog key"),
+            filter_field: z.string().optional().describe("Field name to filter on (e.g. 'state', 'city', 'provider_name')"),
+            filter_value: z.string().optional().describe("Value to filter for"),
+            limit: z.number().optional().describe("Max results (default 50)"),
+            offset: z.number().optional().describe("Offset for pagination"),
+        }),
+        execute: async (args) => {
+            // Check if dataset_id is a catalog key
+            const catalogEntry = DATASETS[args.dataset_id];
+            const datasetId = catalogEntry?.id ?? args.dataset_id;
+            const conditions = [];
+            if (args.filter_field && args.filter_value) {
+                conditions.push({ property: args.filter_field, value: args.filter_value });
+            }
+            const result = await queryDataset({
+                datasetId,
+                conditions: conditions.length ? conditions : undefined,
+                limit: args.limit,
+                offset: args.offset,
+            });
+            return { content: [{ type: "text", text: summarizeResults(result.results, result.count) }] };
+        },
+    },
+];
+export { sdkClearCache as clearCache };
+//# sourceMappingURL=cms.js.map

package/dist/modules/cms.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cms.js","sourceRoot":"","sources":["../../src/modules/cms.ts"],"names":[],"mappings":"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"}

package/dist/modules/college-scorecard.d.ts

@@ -0,0 +1,39 @@
+/**
+ * College Scorecard MCP module — college costs, graduation rates, earnings, debt.
+ */
+import type { Tool, InputPrompt } from "fastmcp";
+export declare const name = "college-scorecard";
+export declare const displayName = "College Scorecard";
+export declare const description = "College costs, graduation rates, post-graduation earnings, student debt, admission rates for every U.S. college and university";
+export declare const auth: {
+    envVar: string;
+    signup: string;
+};
+export declare const workflow = "scorecard_search to find schools \u2192 scorecard_compare for side-by-side \u2192 scorecard_top for rankings";
+export declare const tips: string;
+export declare const reference: {
+    ownership: Record<number, string>;
+    degreeTypes: Record<number, string>;
+    popularFields: {
+        "latest.cost.tuition.in_state": string;
+        "latest.cost.tuition.out_of_state": string;
+        "latest.cost.avg_net_price.overall": string;
+        "latest.admissions.admission_rate.overall": string;
+        "latest.completion.rate_suppressed.overall": string;
+        "latest.earnings.10_yrs_after_entry.median": string;
+        "latest.earnings.6_yrs_after_entry.median": string;
+        "latest.aid.median_debt.completers.overall": string;
+        "latest.aid.pell_grant_rate": string;
+        "latest.student.size": string;
+    };
+    docs: {
+        "College Scorecard": string;
+        "API Documentation": string;
+        "Data Dictionary": string;
+        "Get API Key": string;
+    };
+};
+export declare const tools: Tool<any, any>[];
+export declare const prompts: InputPrompt<any, any>[];
+export { clearCache } from "../sdk/college-scorecard.js";
+//# sourceMappingURL=college-scorecard.d.ts.map

package/dist/modules/college-scorecard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"college-scorecard.d.ts","sourceRoot":"","sources":["../../src/modules/college-scorecard.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAejD,eAAO,MAAM,IAAI,sBAAsB,CAAC;AACxC,eAAO,MAAM,WAAW,sBAAsB,CAAC;AAC/C,eAAO,MAAM,WAAW,mIAAmI,CAAC;AAC5J,eAAO,MAAM,IAAI;;;CAAyE,CAAC;AAC3F,eAAO,MAAM,QAAQ,iHAAuG,CAAC;AAC7H,eAAO,MAAM,IAAI,QAIyD,CAAC;AAE3E,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;CAqBrB,CAAC;AA6BF,eAAO,MAAM,KAAK,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,EAkHjC,CAAC;AAIF,eAAO,MAAM,OAAO,EAAE,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,EAa1C,CAAC;AAEF,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC"}