us-gov-open-data-mcp 1.0.0

package/dist/sdk/naep.d.ts

@@ -0,0 +1,93 @@
+/**
+ * NAEP (Nation's Report Card) SDK — typed API client for the NAEP Data Service API.
+ *
+ * API docs: https://www.nationsreportcard.gov/api_documentation.aspx
+ * No API key required. Returns JSON.
+ *
+ * Usage:
+ *   import { getScores, getAchievementLevels, compareAcrossYears } from "us-gov-open-data-mcp/sdk/naep";
+ *   const scores = await getScores({ subject: "reading", grade: 4, year: "2022" });
+ */
+export interface NaepResult {
+    year: string;
+    sample: string;
+    cohort: string;
+    jurisdiction: string;
+    stattype: string;
+    subject: string;
+    grade: string;
+    subscale: string;
+    variable: string;
+    varValue: string;
+    varValueLabel: string;
+    value: string;
+    se: string;
+    errorFlag: number;
+    [key: string]: unknown;
+}
+export interface NaepResponse {
+    status: number;
+    result: NaepResult[];
+}
+export interface NaepGapResult extends NaepResult {
+    focalValue: string;
+    targetValue: string;
+    gap: string;
+    significance: string;
+}
+/** Common subject + subscale codes */
+export declare const SUBJECTS: Record<string, {
+    code: string;
+    subscale: string;
+    label: string;
+}>;
+/** Common variable codes */
+export declare const VARIABLES: Record<string, string>;
+/** Stat type codes */
+export declare const STAT_TYPES: Record<string, string>;
+/** State jurisdiction codes */
+export declare const JURISDICTIONS: Record<string, string>;
+/** Get NAEP scores (mean, percentiles, or achievement levels) by subject, grade, jurisdiction, and variable. */
+export declare function getScores(opts: {
+    subject: string;
+    grade: number;
+    variable?: string;
+    jurisdiction?: string;
+    stattype?: string;
+    year?: string;
+    subscale?: string;
+}): Promise<NaepResponse>;
+/** Get achievement level percentages (Below Basic, Basic, Proficient, Advanced). */
+export declare function getAchievementLevels(opts: {
+    subject: string;
+    grade: number;
+    variable?: string;
+    jurisdiction?: string;
+    year?: string;
+}): Promise<NaepResponse>;
+/** Compare scores across years (significance testing). */
+export declare function compareAcrossYears(opts: {
+    subject: string;
+    grade: number;
+    years: string;
+    variable?: string;
+    jurisdiction?: string;
+}): Promise<NaepResponse>;
+/** Compare scores across jurisdictions (states/districts). */
+export declare function compareAcrossJurisdictions(opts: {
+    subject: string;
+    grade: number;
+    jurisdictions: string;
+    variable?: string;
+    year?: string;
+}): Promise<NaepResponse>;
+/** Compare scores across demographic groups (race, gender, etc.). */
+export declare function compareAcrossGroups(opts: {
+    subject: string;
+    grade: number;
+    variable: string;
+    jurisdiction?: string;
+    year?: string;
+}): Promise<NaepResponse>;
+export declare function clearCache(): void;
+//# sourceMappingURL=naep.d.ts.map

package/dist/sdk/naep.d.ts.map

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

package/dist/sdk/naep.js

@@ -0,0 +1,163 @@
+/**
+ * NAEP (Nation's Report Card) SDK — typed API client for the NAEP Data Service API.
+ *
+ * API docs: https://www.nationsreportcard.gov/api_documentation.aspx
+ * No API key required. Returns JSON.
+ *
+ * Usage:
+ *   import { getScores, getAchievementLevels, compareAcrossYears } from "us-gov-open-data-mcp/sdk/naep";
+ *   const scores = await getScores({ subject: "reading", grade: 4, year: "2022" });
+ */
+import { createClient } from "../client.js";
+const api = createClient({
+    baseUrl: "https://www.nationsreportcard.gov",
+    name: "naep",
+    rateLimit: { perSecond: 3, burst: 6 },
+    cacheTtlMs: 24 * 60 * 60 * 1000, // 24 hours — NAEP data updates ~every 2 years
+    timeoutMs: 30_000,
+});
+// ─── Reference Data ──────────────────────────────────────────────────
+/** Common subject + subscale codes */
+export const SUBJECTS = {
+    reading: { code: "reading", subscale: "RRPCM", label: "Reading (composite)" },
+    math: { code: "mathematics", subscale: "MRPCM", label: "Mathematics (composite)" },
+    science: { code: "science", subscale: "SRPUV", label: "Science (overall)" },
+    writing: { code: "writing", subscale: "WRIRP", label: "Writing" },
+    civics: { code: "civics", subscale: "CIVRP", label: "Civics" },
+    history: { code: "history", subscale: "HRPCM", label: "U.S. History (composite)" },
+    geography: { code: "geography", subscale: "GRPCM", label: "Geography (composite)" },
+};
+/** Common variable codes */
+export const VARIABLES = {
+    TOTAL: "All students",
+    GENDER: "Gender (Male/Female)",
+    SDRACE: "Race/ethnicity (trend reporting)",
+    SRACE10: "Race/ethnicity (2011 guidelines)",
+    SLUNCH3: "School lunch eligibility (poverty proxy)",
+    PARED: "Parental education level",
+    SCHTYPE: "School type (public/nonpublic)",
+    CHRTRPT: "Charter school status",
+    UTOL4: "School location (city/suburb/town/rural)",
+    CENSREG: "Census region",
+    IEP: "Disability status (IEP/504)",
+    LEP: "English language learner status",
+};
+/** Stat type codes */
+export const STAT_TYPES = {
+    "MN:MN": "Average scale score (mean)",
+    "ALC:BB": "% Below Basic",
+    "ALC:AB": "% At or Above Basic",
+    "ALC:AP": "% At or Above Proficient",
+    "ALC:AD": "% At Advanced",
+    "ALD:BA": "% At Basic (discrete)",
+    "ALD:PR": "% At Proficient (discrete)",
+    "ALD:AD": "% At Advanced (discrete)",
+    "PC:P1": "10th percentile score",
+    "PC:P5": "50th percentile score",
+    "PC:P9": "90th percentile score",
+};
+/** State jurisdiction codes */
+export const JURISDICTIONS = {
+    NP: "National public",
+    NT: "National total",
+    NR: "National private",
+    NL: "Large city",
+    AL: "Alabama", AK: "Alaska", AZ: "Arizona", AR: "Arkansas", CA: "California",
+    CO: "Colorado", CT: "Connecticut", DE: "Delaware", DC: "District of Columbia",
+    FL: "Florida", GA: "Georgia", HI: "Hawaii", ID: "Idaho", IL: "Illinois",
+    IN: "Indiana", IA: "Iowa", KS: "Kansas", KY: "Kentucky", LA: "Louisiana",
+    ME: "Maine", MD: "Maryland", MA: "Massachusetts", MI: "Michigan", MN: "Minnesota",
+    MS: "Mississippi", MO: "Missouri", MT: "Montana", NE: "Nebraska", NV: "Nevada",
+    NH: "New Hampshire", NJ: "New Jersey", NM: "New Mexico", NY: "New York",
+    NC: "North Carolina", ND: "North Dakota", OH: "Ohio", OK: "Oklahoma",
+    OR: "Oregon", PA: "Pennsylvania", RI: "Rhode Island", SC: "South Carolina",
+    SD: "South Dakota", TN: "Tennessee", TX: "Texas", UT: "Utah", VT: "Vermont",
+    VA: "Virginia", WA: "Washington", WV: "West Virginia", WI: "Wisconsin", WY: "Wyoming",
+};
+// ─── Helpers ─────────────────────────────────────────────────────────
+function resolveSubject(subjectInput) {
+    const lower = subjectInput.toLowerCase().trim();
+    const entry = SUBJECTS[lower];
+    if (entry)
+        return { subject: entry.code, subscale: entry.subscale };
+    // Allow raw codes
+    return { subject: subjectInput, subscale: subjectInput.toUpperCase() };
+}
+// ─── Public API ──────────────────────────────────────────────────────
+/** Get NAEP scores (mean, percentiles, or achievement levels) by subject, grade, jurisdiction, and variable. */
+export async function getScores(opts) {
+    const resolved = resolveSubject(opts.subject);
+    const params = {
+        type: "data",
+        subject: resolved.subject,
+        grade: String(opts.grade),
+        subscale: opts.subscale || resolved.subscale,
+        variable: opts.variable || "TOTAL",
+        jurisdiction: opts.jurisdiction || "NP",
+        stattype: opts.stattype || "MN:MN",
+        Year: opts.year || "Current",
+    };
+    return api.get("/Dataservice/GetAdhocData.aspx", params);
+}
+/** Get achievement level percentages (Below Basic, Basic, Proficient, Advanced). */
+export async function getAchievementLevels(opts) {
+    const resolved = resolveSubject(opts.subject);
+    const params = {
+        type: "data",
+        subject: resolved.subject,
+        grade: String(opts.grade),
+        subscale: resolved.subscale,
+        variable: opts.variable || "TOTAL",
+        jurisdiction: opts.jurisdiction || "NP",
+        stattype: "ALC:BB,ALC:AB,ALC:AP,ALC:AD",
+        Year: opts.year || "Current",
+    };
+    return api.get("/Dataservice/GetAdhocData.aspx", params);
+}
+/** Compare scores across years (significance testing). */
+export async function compareAcrossYears(opts) {
+    const resolved = resolveSubject(opts.subject);
+    const params = {
+        type: "sigacrossyear",
+        subject: resolved.subject,
+        grade: String(opts.grade),
+        subscale: resolved.subscale,
+        variable: opts.variable || "TOTAL",
+        jurisdiction: opts.jurisdiction || "NP",
+        stattype: "MN:MN",
+        Year: opts.years,
+    };
+    return api.get("/Dataservice/GetAdhocData.aspx", params);
+}
+/** Compare scores across jurisdictions (states/districts). */
+export async function compareAcrossJurisdictions(opts) {
+    const resolved = resolveSubject(opts.subject);
+    const params = {
+        type: "sigacrossjuris",
+        subject: resolved.subject,
+        grade: String(opts.grade),
+        subscale: resolved.subscale,
+        variable: opts.variable || "TOTAL",
+        jurisdiction: opts.jurisdictions,
+        stattype: "MN:MN",
+        Year: opts.year || "Current",
+    };
+    return api.get("/Dataservice/GetAdhocData.aspx", params);
+}
+/** Compare scores across demographic groups (race, gender, etc.). */
+export async function compareAcrossGroups(opts) {
+    const resolved = resolveSubject(opts.subject);
+    const params = {
+        type: "sigacrossvalue",
+        subject: resolved.subject,
+        grade: String(opts.grade),
+        subscale: resolved.subscale,
+        variable: opts.variable,
+        jurisdiction: opts.jurisdiction || "NP",
+        stattype: "MN:MN",
+        Year: opts.year || "Current",
+    };
+    return api.get("/Dataservice/GetAdhocData.aspx", params);
+}
+export function clearCache() { api.clearCache(); }
+//# sourceMappingURL=naep.js.map

package/dist/sdk/naep.js.map

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

package/dist/sdk/nhtsa.d.ts

@@ -0,0 +1,169 @@
+/**
+ * NHTSA SDK — typed API client for vehicle recalls, complaints, and VIN decoding.
+ *
+ * Standalone — no MCP server required. Usage:
+ *
+ *   import { getRecalls, getComplaints, decodeVin } from "us-gov-open-data/sdk/nhtsa";
+ *
+ * No API key required.
+ * Docs: https://www.nhtsa.gov/nhtsa-datasets-and-apis
+ */
+export interface Recall {
+    Manufacturer?: string;
+    NHTSACampaignNumber?: string;
+    parkIt?: boolean;
+    parkOutSide?: boolean;
+    ReportReceivedDate?: string;
+    Component?: string;
+    Summary?: string;
+    Consequence?: string;
+    Remedy?: string;
+    Notes?: string;
+    ModelYear?: string;
+    Make?: string;
+    Model?: string;
+    NHTSAActionNumber?: string;
+    [key: string]: unknown;
+}
+export interface RecallResponse {
+    Count?: number;
+    Message?: string;
+    results?: Recall[];
+}
+export interface Complaint {
+    odiNumber?: number;
+    manufacturer?: string;
+    crash?: boolean;
+    fire?: boolean;
+    numberOfInjuries?: number;
+    numberOfDeaths?: number;
+    dateOfIncident?: string;
+    dateComplaintFiled?: string;
+    vin?: string;
+    components?: string;
+    summary?: string;
+    products?: Array<{
+        type?: string;
+        productYear?: string;
+        productMake?: string;
+        productModel?: string;
+        manufacturer?: string;
+    }>;
+    [key: string]: unknown;
+}
+export interface ComplaintResponse {
+    count?: number;
+    message?: string;
+    results?: Complaint[];
+}
+export interface VinResult {
+    Make?: string;
+    Model?: string;
+    ModelYear?: string;
+    Manufacturer?: string;
+    VehicleType?: string;
+    BodyClass?: string;
+    DriveType?: string;
+    FuelTypePrimary?: string;
+    EngineModel?: string;
+    EngineCylinders?: string;
+    DisplacementL?: string;
+    TransmissionStyle?: string;
+    PlantCity?: string;
+    PlantCountry?: string;
+    ErrorCode?: string;
+    ErrorText?: string;
+    [key: string]: unknown;
+}
+/**
+ * Search for vehicle recalls by make, model, and/or model year.
+ */
+export declare function getRecalls(opts: {
+    make: string;
+    model: string;
+    modelYear: number;
+}): Promise<Recall[]>;
+/**
+ * Search for vehicle complaints by make, model, and/or model year.
+ */
+export declare function getComplaints(opts: {
+    make: string;
+    model: string;
+    modelYear: number;
+}): Promise<Complaint[]>;
+/**
+ * Decode a VIN (Vehicle Identification Number) to get vehicle specifications.
+ */
+export declare function decodeVin(vin: string): Promise<VinResult>;
+/**
+ * Get all vehicle makes from the vPIC database.
+ */
+export declare function getAllMakes(): Promise<Array<{
+    Make_ID: number;
+    Make_Name: string;
+}>>;
+/**
+ * Get models for a specific make and optional year.
+ */
+export declare function getModelsForMake(opts: {
+    make: string;
+    modelYear?: number;
+}): Promise<Array<{
+    Make_ID: number;
+    Make_Name: string;
+    Model_ID: number;
+    Model_Name: string;
+}>>;
+export interface SafetyRatingVehicle {
+    VehicleId?: number;
+    VehicleDescription?: string;
+    ModelYear?: number;
+    Make?: string;
+    Model?: string;
+    [key: string]: unknown;
+}
+export interface SafetyRating {
+    VehicleId?: number;
+    VehicleDescription?: string;
+    OverallRating?: string;
+    OverallFrontCrashRating?: string;
+    FrontCrashDriversideRating?: string;
+    FrontCrashPassengersideRating?: string;
+    OverallSideCrashRating?: string;
+    SideCrashDriversideRating?: string;
+    SideCrashPassengersideRating?: string;
+    RolloverRating?: string;
+    RolloverPossibility?: number;
+    RolloverPossibility2?: number;
+    SidePoleCrashRating?: string;
+    NHTSAElectronicStabilityControl?: string;
+    NHTSAForwardCollisionWarning?: string;
+    NHTSALaneDepartureWarning?: string;
+    ComplaintsCount?: number;
+    RecallsCount?: number;
+    InvestigationCount?: number;
+    [key: string]: unknown;
+}
+/**
+ * Search for NHTSA 5-star safety ratings by make/model/year.
+ * Returns vehicle variants with VehicleId for detail lookup.
+ *
+ * Example:
+ *   const vehicles = await getSafetyRatingVehicles({ make: 'honda', model: 'civic', modelYear: 2023 });
+ */
+export declare function getSafetyRatingVehicles(opts: {
+    make: string;
+    model: string;
+    modelYear: number;
+}): Promise<SafetyRatingVehicle[]>;
+/**
+ * Get detailed safety ratings for a specific vehicle by VehicleId.
+ * Returns crash test results, rollover rating, and safety tech.
+ *
+ * Example:
+ *   const rating = await getSafetyRatingDetail(5531);
+ */
+export declare function getSafetyRatingDetail(vehicleId: number): Promise<SafetyRating | null>;
+/** Clear both NHTSA caches. */
+export declare function clearCache(): void;
+//# sourceMappingURL=nhtsa.d.ts.map

package/dist/sdk/nhtsa.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nhtsa.d.ts","sourceRoot":"","sources":["../../src/sdk/nhtsa.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAsBH,MAAM,WAAW,MAAM;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,SAAS;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,KAAK,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC,CAAC;IACH,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,SAAS,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAID;;GAEG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAOpB;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAOvB;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAM/D;AAED;;GAEG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,KAAK,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAK1F;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,KAAK,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAQ/F;AAID,MAAM,WAAW,mBAAmB;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,0BAA0B,CAAC,EAAE,MAAM,CAAC;IACpC,6BAA6B,CAAC,EAAE,MAAM,CAAC;IACvC,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,4BAA4B,CAAC,EAAE,MAAM,CAAC;IACtC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,+BAA+B,CAAC,EAAE,MAAM,CAAC;IACzC,4BAA4B,CAAC,EAAE,MAAM,CAAC;IACtC,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;;;;GAMG;AACH,wBAAsB,uBAAuB,CAAC,IAAI,EAAE;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAMjC;AAED;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAM3F;AAED,+BAA+B;AAC/B,wBAAgB,UAAU,SAGzB"}

package/dist/sdk/nhtsa.js

@@ -0,0 +1,102 @@
+/**
+ * NHTSA SDK — typed API client for vehicle recalls, complaints, and VIN decoding.
+ *
+ * Standalone — no MCP server required. Usage:
+ *
+ *   import { getRecalls, getComplaints, decodeVin } from "us-gov-open-data/sdk/nhtsa";
+ *
+ * No API key required.
+ * Docs: https://www.nhtsa.gov/nhtsa-datasets-and-apis
+ */
+import { createClient } from "../client.js";
+// ─── Clients ─────────────────────────────────────────────────────────
+const recallsApi = createClient({
+    baseUrl: "https://api.nhtsa.gov",
+    name: "nhtsa",
+    rateLimit: { perSecond: 5, burst: 10 },
+    cacheTtlMs: 60 * 60 * 1000, // 1 hour
+});
+const vpicApi = createClient({
+    baseUrl: "https://vpic.nhtsa.dot.gov/api",
+    name: "nhtsa-vpic",
+    rateLimit: { perSecond: 5, burst: 10 },
+    cacheTtlMs: 24 * 60 * 60 * 1000, // 24 hours — vehicle data is static
+});
+// ─── Public API ──────────────────────────────────────────────────────
+/**
+ * Search for vehicle recalls by make, model, and/or model year.
+ */
+export async function getRecalls(opts) {
+    const res = (await recallsApi.get("/recalls/recallsByVehicle", {
+        make: opts.make,
+        model: opts.model,
+        modelYear: String(opts.modelYear),
+    }));
+    return res?.results ?? [];
+}
+/**
+ * Search for vehicle complaints by make, model, and/or model year.
+ */
+export async function getComplaints(opts) {
+    const res = (await recallsApi.get("/complaints/complaintsByVehicle", {
+        make: opts.make,
+        model: opts.model,
+        modelYear: String(opts.modelYear),
+    }));
+    return res?.results ?? [];
+}
+/**
+ * Decode a VIN (Vehicle Identification Number) to get vehicle specifications.
+ */
+export async function decodeVin(vin) {
+    const res = (await vpicApi.get(`/vehicles/DecodeVinValues/${encodeURIComponent(vin)}`, {
+        format: "json",
+    }));
+    const results = res?.Results ?? [];
+    return results[0] ?? {};
+}
+/**
+ * Get all vehicle makes from the vPIC database.
+ */
+export async function getAllMakes() {
+    const res = (await vpicApi.get("/vehicles/GetAllMakes", { format: "json" }));
+    return res?.Results ?? [];
+}
+/**
+ * Get models for a specific make and optional year.
+ */
+export async function getModelsForMake(opts) {
+    const path = opts.modelYear
+        ? `/vehicles/GetModelsForMakeYear/make/${encodeURIComponent(opts.make)}/modelyear/${opts.modelYear}`
+        : `/vehicles/GetModelsForMake/${encodeURIComponent(opts.make)}`;
+    const res = (await vpicApi.get(path, { format: "json" }));
+    return res?.Results ?? [];
+}
+/**
+ * Search for NHTSA 5-star safety ratings by make/model/year.
+ * Returns vehicle variants with VehicleId for detail lookup.
+ *
+ * Example:
+ *   const vehicles = await getSafetyRatingVehicles({ make: 'honda', model: 'civic', modelYear: 2023 });
+ */
+export async function getSafetyRatingVehicles(opts) {
+    const res = (await recallsApi.get(`/SafetyRatings/modelyear/${opts.modelYear}/make/${encodeURIComponent(opts.make)}/model/${encodeURIComponent(opts.model)}`, { format: "json" }));
+    return res?.Results ?? [];
+}
+/**
+ * Get detailed safety ratings for a specific vehicle by VehicleId.
+ * Returns crash test results, rollover rating, and safety tech.
+ *
+ * Example:
+ *   const rating = await getSafetyRatingDetail(5531);
+ */
+export async function getSafetyRatingDetail(vehicleId) {
+    const res = (await recallsApi.get(`/SafetyRatings/VehicleId/${vehicleId}`, { format: "json" }));
+    return res?.Results?.[0] ?? null;
+}
+/** Clear both NHTSA caches. */
+export function clearCache() {
+    recallsApi.clearCache();
+    vpicApi.clearCache();
+}
+//# sourceMappingURL=nhtsa.js.map

package/dist/sdk/nhtsa.js.map

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

package/dist/sdk/noaa.d.ts

@@ -0,0 +1,72 @@
+/**
+ * NOAA Climate Data Online SDK — weather, temperature, precipitation data.
+ *
+ * API docs: https://www.ncei.noaa.gov/cdo-web/webservices/v2
+ * Get key: https://www.ncei.noaa.gov/cdo-web/token
+ * Rate limit: 5 req/sec, 10,000 req/day
+ *
+ * Usage:
+ *   import { getClimateData, searchStations } from "us-gov-open-data-mcp/sdk/noaa";
+ *   const data = await getClimateData({ datasetId: "GHCND", stationId: "GHCND:USW00094728", startDate: "2025-01-01", endDate: "2025-12-31" });
+ */
+export interface NoaaDataset {
+    id: string;
+    name: string;
+    datacoverage: number;
+    mindate: string;
+    maxdate: string;
+}
+export interface NoaaStation {
+    id: string;
+    name: string;
+    datacoverage: number;
+    elevation: number;
+    elevationUnit: string;
+    latitude: number;
+    longitude: number;
+    mindate: string;
+    maxdate: string;
+}
+export interface NoaaDataPoint {
+    date: string;
+    datatype: string;
+    station: string;
+    value: number;
+    attributes: string;
+}
+/** List available datasets (GHCND, GSOM, GSOY, etc.) */
+export declare function listDatasets(): Promise<NoaaDataset[]>;
+/** Search for weather stations by location or dataset. */
+export declare function searchStations(opts: {
+    datasetId?: string;
+    locationId?: string;
+    extent?: string;
+    limit?: number;
+}): Promise<NoaaStation[]>;
+/** Get climate observations. */
+export declare function getClimateData(opts: {
+    datasetId: string;
+    startDate: string;
+    endDate: string;
+    stationId?: string;
+    locationId?: string;
+    datatypeId?: string;
+    limit?: number;
+}): Promise<{
+    count: number;
+    data: NoaaDataPoint[];
+}>;
+/** Search locations (states, cities, countries, etc.) */
+export declare function searchLocations(opts: {
+    categoryId?: string;
+    datasetId?: string;
+    limit?: number;
+}): Promise<{
+    id: string;
+    name: string;
+    datacoverage: number;
+    mindate: string;
+    maxdate: string;
+}[]>;
+export declare function clearCache(): void;
+//# sourceMappingURL=noaa.d.ts.map

package/dist/sdk/noaa.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"noaa.d.ts","sourceRoot":"","sources":["../../src/sdk/noaa.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAcH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB;AASD,wDAAwD;AACxD,wBAAsB,YAAY,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,CAG3D;AAED,0DAA0D;AAC1D,wBAAsB,cAAc,CAAC,IAAI,EAAE;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAQzB;AAED,gCAAgC;AAChC,wBAAsB,cAAc,CAAC,IAAI,EAAE;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,aAAa,EAAE,CAAA;CAAE,CAAC,CAepD;AAED,yDAAyD;AACzD,wBAAsB,eAAe,CAAC,IAAI,EAAE;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EAAE,CAAC,CAQlG;AAED,wBAAgB,UAAU,IAAI,IAAI,CAAsB"}