us-gov-open-data-mcp 1.0.0

package/dist/sdk/usgs.js.map

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

package/dist/sdk/uspto.d.ts

@@ -0,0 +1,109 @@
+/**
+ * USPTO PatentsView SDK — typed API client for patent data.
+ *
+ * Uses PatentsView API (https://patentsview.org/apis/api-endpoints)
+ * maintained by the U.S. Patent & Trademark Office.
+ *
+ * Standalone — no MCP server required. Usage:
+ *
+ *   import { searchPatents, getPatent } from "us-gov-open-data/sdk/uspto";
+ *
+ *   const results = await searchPatents({ query: "machine learning", yearFrom: 2023 });
+ *   console.log(results.total, results.patents);
+ *
+ * No API key required — completely open.
+ */
+export interface Patent {
+    patentNumber: string;
+    patentTitle: string;
+    patentDate: string;
+    patentAbstract: string | null;
+    patentType: string | null;
+    numClaims: number | null;
+    assigneeOrganization: string | null;
+    inventorNames: string[];
+    cpcGroup: string | null;
+}
+export interface PatentSearchResult {
+    total: number;
+    patents: Patent[];
+}
+export interface Inventor {
+    inventorId: string;
+    inventorFirstName: string;
+    inventorLastName: string;
+    inventorCity: string | null;
+    inventorState: string | null;
+    inventorCountry: string | null;
+    patentCount: number;
+}
+export interface InventorSearchResult {
+    total: number;
+    inventors: Inventor[];
+}
+export interface Assignee {
+    assigneeId: string;
+    assigneeOrganization: string | null;
+    assigneeType: string | null;
+    assigneeCity: string | null;
+    assigneeState: string | null;
+    assigneeCountry: string | null;
+    patentCount: number;
+}
+export interface AssigneeSearchResult {
+    total: number;
+    assignees: Assignee[];
+}
+export interface CpcSubsection {
+    cpcSubsectionId: string;
+    cpcSubsectionTitle: string;
+    patentCount: number;
+}
+/**
+ * Search for patents using keyword, assignee, inventor, date range, or CPC class.
+ */
+export declare function searchPatents(params: {
+    query?: string;
+    title?: string;
+    abstract?: string;
+    assignee?: string;
+    inventor?: string;
+    cpcSection?: string;
+    yearFrom?: number;
+    yearTo?: number;
+    patentNumber?: string;
+    patentType?: string;
+    page?: number;
+    perPage?: number;
+    sortBy?: string;
+    sortOrder?: "asc" | "desc";
+}): Promise<PatentSearchResult>;
+/**
+ * Get details for a specific patent by number.
+ */
+export declare function getPatent(patentNumber: string): Promise<Patent | null>;
+/**
+ * Search for inventors by name or location.
+ */
+export declare function searchInventors(params: {
+    name?: string;
+    firstName?: string;
+    lastName?: string;
+    state?: string;
+    country?: string;
+    page?: number;
+    perPage?: number;
+}): Promise<InventorSearchResult>;
+/**
+ * Search for assignees (companies/organizations) by name or location.
+ */
+export declare function searchAssignees(params: {
+    organization?: string;
+    state?: string;
+    country?: string;
+    type?: string;
+    page?: number;
+    perPage?: number;
+}): Promise<AssigneeSearchResult>;
+export declare function clearCache(): void;
+//# sourceMappingURL=uspto.d.ts.map

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

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

package/dist/sdk/uspto.js

@@ -0,0 +1,286 @@
+/**
+ * USPTO PatentsView SDK — typed API client for patent data.
+ *
+ * Uses PatentsView API (https://patentsview.org/apis/api-endpoints)
+ * maintained by the U.S. Patent & Trademark Office.
+ *
+ * Standalone — no MCP server required. Usage:
+ *
+ *   import { searchPatents, getPatent } from "us-gov-open-data/sdk/uspto";
+ *
+ *   const results = await searchPatents({ query: "machine learning", yearFrom: 2023 });
+ *   console.log(results.total, results.patents);
+ *
+ * No API key required — completely open.
+ */
+import { createClient } from "../client.js";
+// ─── Client ──────────────────────────────────────────────────────────
+const api = createClient({
+    baseUrl: "https://api.patentsview.org",
+    name: "uspto",
+    // No auth — completely open API
+    rateLimit: { perSecond: 5, burst: 15 },
+    cacheTtlMs: 24 * 60 * 60 * 1000, // 24 hours — patent data doesn't change frequently
+    timeoutMs: 30_000,
+});
+// ─── Query builders ──────────────────────────────────────────────────
+/**
+ * PatentsView uses a JSON query syntax.
+ * Build a query object from user-friendly params.
+ */
+function buildPatentQuery(params) {
+    const conditions = [];
+    if (params.patentNumber) {
+        conditions.push({ _eq: { patent_number: params.patentNumber } });
+    }
+    if (params.query) {
+        // Search title and abstract
+        conditions.push({
+            _or: [
+                { _text_any: { patent_title: params.query } },
+                { _text_any: { patent_abstract: params.query } },
+            ],
+        });
+    }
+    if (params.title) {
+        conditions.push({ _text_any: { patent_title: params.title } });
+    }
+    if (params.abstract) {
+        conditions.push({ _text_any: { patent_abstract: params.abstract } });
+    }
+    if (params.assignee) {
+        conditions.push({ _text_any: { assignee_organization: params.assignee } });
+    }
+    if (params.inventor) {
+        conditions.push({
+            _or: [
+                { _text_any: { inventor_first_name: params.inventor } },
+                { _text_any: { inventor_last_name: params.inventor } },
+            ],
+        });
+    }
+    if (params.cpcSection) {
+        conditions.push({ _eq: { cpc_section_id: params.cpcSection } });
+    }
+    if (params.patentType) {
+        conditions.push({ _eq: { patent_type: params.patentType } });
+    }
+    if (params.yearFrom) {
+        conditions.push({ _gte: { patent_date: `${params.yearFrom}-01-01` } });
+    }
+    if (params.yearTo) {
+        conditions.push({ _lte: { patent_date: `${params.yearTo}-12-31` } });
+    }
+    if (conditions.length === 0) {
+        // Default: recent patents
+        const date = new Date();
+        date.setMonth(date.getMonth() - 1);
+        return { _gte: { patent_date: date.toISOString().split("T")[0] } };
+    }
+    return conditions.length === 1 ? conditions[0] : { _and: conditions };
+}
+// ─── API functions ───────────────────────────────────────────────────
+/**
+ * Search for patents using keyword, assignee, inventor, date range, or CPC class.
+ */
+export async function searchPatents(params) {
+    const q = JSON.stringify(buildPatentQuery(params));
+    const f = JSON.stringify([
+        "patent_number",
+        "patent_title",
+        "patent_date",
+        "patent_abstract",
+        "patent_type",
+        "patent_num_claims",
+        "assignee_organization",
+        "inventor_first_name",
+        "inventor_last_name",
+        "cpc_group_id",
+    ]);
+    const o = JSON.stringify({
+        page: params.page || 1,
+        per_page: Math.min(params.perPage || 25, 50),
+    });
+    const s = JSON.stringify([{
+            [params.sortBy || "patent_date"]: params.sortOrder || "desc",
+        }]);
+    const res = await api.get("/patents/query", { q, f, o, s });
+    const patents = (res.patents ?? []).map(mapPatent);
+    return {
+        total: res.total_patent_count ?? res.count ?? patents.length,
+        patents,
+    };
+}
+/**
+ * Get details for a specific patent by number.
+ */
+export async function getPatent(patentNumber) {
+    const result = await searchPatents({ patentNumber, perPage: 1 });
+    return result.patents[0] ?? null;
+}
+/**
+ * Search for inventors by name or location.
+ */
+export async function searchInventors(params) {
+    const conditions = [];
+    if (params.name) {
+        conditions.push({
+            _or: [
+                { _text_any: { inventor_first_name: params.name } },
+                { _text_any: { inventor_last_name: params.name } },
+            ],
+        });
+    }
+    if (params.firstName) {
+        conditions.push({ _text_any: { inventor_first_name: params.firstName } });
+    }
+    if (params.lastName) {
+        conditions.push({ _text_any: { inventor_last_name: params.lastName } });
+    }
+    if (params.state) {
+        conditions.push({ _eq: { inventor_state: params.state } });
+    }
+    if (params.country) {
+        conditions.push({ _eq: { inventor_country: params.country } });
+    }
+    const q = JSON.stringify(conditions.length === 0
+        ? { _gte: { patent_date: "2024-01-01" } }
+        : conditions.length === 1
+            ? conditions[0]
+            : { _and: conditions });
+    const f = JSON.stringify([
+        "inventor_id",
+        "inventor_first_name",
+        "inventor_last_name",
+        "inventor_city",
+        "inventor_state",
+        "inventor_country",
+        "patent_number",
+    ]);
+    const o = JSON.stringify({
+        page: params.page || 1,
+        per_page: Math.min(params.perPage || 25, 50),
+    });
+    const res = await api.get("/inventors/query", { q, f, o });
+    // Group by inventor to get patent counts
+    const inventorMap = new Map();
+    for (const r of res.inventors ?? []) {
+        const id = String(r.inventor_id ?? "");
+        if (!id)
+            continue;
+        if (!inventorMap.has(id)) {
+            inventorMap.set(id, {
+                inventorId: id,
+                inventorFirstName: String(r.inventor_first_name ?? ""),
+                inventorLastName: String(r.inventor_last_name ?? ""),
+                inventorCity: r.inventor_city || null,
+                inventorState: r.inventor_state || null,
+                inventorCountry: r.inventor_country || null,
+                patentCount: 0,
+            });
+        }
+        inventorMap.get(id).patentCount += 1;
+    }
+    return {
+        total: res.total_inventor_count ?? res.count ?? inventorMap.size,
+        inventors: Array.from(inventorMap.values()),
+    };
+}
+/**
+ * Search for assignees (companies/organizations) by name or location.
+ */
+export async function searchAssignees(params) {
+    const conditions = [];
+    if (params.organization) {
+        conditions.push({ _text_any: { assignee_organization: params.organization } });
+    }
+    if (params.state) {
+        conditions.push({ _eq: { assignee_state: params.state } });
+    }
+    if (params.country) {
+        conditions.push({ _eq: { assignee_country: params.country } });
+    }
+    if (params.type) {
+        conditions.push({ _eq: { assignee_type: params.type } });
+    }
+    const q = JSON.stringify(conditions.length === 0
+        ? { _gte: { patent_date: "2024-01-01" } }
+        : conditions.length === 1
+            ? conditions[0]
+            : { _and: conditions });
+    const f = JSON.stringify([
+        "assignee_id",
+        "assignee_organization",
+        "assignee_type",
+        "assignee_city",
+        "assignee_state",
+        "assignee_country",
+        "patent_number",
+    ]);
+    const o = JSON.stringify({
+        page: params.page || 1,
+        per_page: Math.min(params.perPage || 25, 50),
+    });
+    const res = await api.get("/assignees/query", { q, f, o });
+    // Group by assignee
+    const assigneeMap = new Map();
+    for (const r of res.assignees ?? []) {
+        const id = String(r.assignee_id ?? "");
+        if (!id)
+            continue;
+        if (!assigneeMap.has(id)) {
+            assigneeMap.set(id, {
+                assigneeId: id,
+                assigneeOrganization: r.assignee_organization || null,
+                assigneeType: r.assignee_type || null,
+                assigneeCity: r.assignee_city || null,
+                assigneeState: r.assignee_state || null,
+                assigneeCountry: r.assignee_country || null,
+                patentCount: 0,
+            });
+        }
+        assigneeMap.get(id).patentCount += 1;
+    }
+    return {
+        total: res.total_assignee_count ?? res.count ?? assigneeMap.size,
+        assignees: Array.from(assigneeMap.values()),
+    };
+}
+// ─── Helpers ─────────────────────────────────────────────────────────
+function mapPatent(r) {
+    // Inventors may be nested array or flat
+    const inventorFirst = r.inventor_first_name;
+    const inventorLast = r.inventor_last_name;
+    let inventorNames = [];
+    if (Array.isArray(inventorFirst)) {
+        inventorNames = inventorFirst.map((f, i) => {
+            const last = Array.isArray(inventorLast) ? inventorLast[i] : inventorLast;
+            return `${f} ${last ?? ""}`.trim();
+        });
+    }
+    else if (typeof inventorFirst === "string") {
+        inventorNames = [`${inventorFirst} ${inventorLast ?? ""}`.trim()];
+    }
+    // CPC may be array or flat
+    const cpcRaw = r.cpc_group_id;
+    const cpcGroup = Array.isArray(cpcRaw) ? cpcRaw[0] : cpcRaw || null;
+    // Assignee may be array or flat
+    const assigneeRaw = r.assignee_organization;
+    const assigneeOrg = Array.isArray(assigneeRaw) ? assigneeRaw[0] : assigneeRaw || null;
+    return {
+        patentNumber: String(r.patent_number ?? ""),
+        patentTitle: String(r.patent_title ?? ""),
+        patentDate: String(r.patent_date ?? ""),
+        patentAbstract: r.patent_abstract ? String(r.patent_abstract).substring(0, 500) : null,
+        patentType: r.patent_type || null,
+        numClaims: r.patent_num_claims != null ? Number(r.patent_num_claims) : null,
+        assigneeOrganization: assigneeOrg,
+        inventorNames,
+        cpcGroup: cpcGroup || null,
+    };
+}
+// ─── Cache management ────────────────────────────────────────────────
+export function clearCache() {
+    api.clearCache();
+}
+//# sourceMappingURL=uspto.js.map

package/dist/sdk/uspto.js.map

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

package/dist/sdk/world-bank.d.ts

@@ -0,0 +1,78 @@
+/**
+ * World Bank SDK — international economic indicators for 200+ countries.
+ *
+ * API docs: https://datahelpdesk.worldbank.org/knowledgebase/articles/889392
+ * No auth required. No published rate limit.
+ *
+ * Usage:
+ *   import { getIndicator, searchIndicators } from "us-gov-open-data-mcp/sdk/world-bank";
+ *   const gdp = await getIndicator("NY.GDP.MKTP.CD", { country: "US", dateRange: "2020:2024" });
+ */
+export interface WBIndicatorValue {
+    indicator: {
+        id: string;
+        value: string;
+    };
+    country: {
+        id: string;
+        value: string;
+    };
+    countryiso3code: string;
+    date: string;
+    value: number | null;
+    unit: string;
+    obs_status: string;
+    decimal: number;
+}
+export interface WBIndicatorInfo {
+    id: string;
+    name: string;
+    unit: string;
+    source: {
+        id: string;
+        value: string;
+    };
+    sourceNote: string;
+    sourceOrganization: string;
+}
+export interface WBCountry {
+    id: string;
+    iso2Code: string;
+    name: string;
+    region: {
+        id: string;
+        value: string;
+    };
+    incomeLevel: {
+        id: string;
+        value: string;
+    };
+    capitalCity: string;
+    longitude: string;
+    latitude: string;
+}
+/** Get indicator data for a country or set of countries. */
+export declare function getIndicator(indicatorId: string, opts?: {
+    country?: string;
+    dateRange?: string;
+    perPage?: number;
+}): Promise<{
+    total: number;
+    data: WBIndicatorValue[];
+}>;
+/** Compare an indicator across multiple countries. */
+export declare function compareCountries(indicatorId: string, countries: string[], opts?: {
+    dateRange?: string;
+    perPage?: number;
+}): Promise<{
+    total: number;
+    data: WBIndicatorValue[];
+}>;
+/** Search for indicators by keyword. */
+export declare function searchIndicators(query: string, perPage?: number): Promise<WBIndicatorInfo[]>;
+/** List countries with metadata. */
+export declare function listCountries(perPage?: number): Promise<WBCountry[]>;
+/** Popular indicator IDs for quick reference. */
+export declare const POPULAR_INDICATORS: Record<string, string>;
+export declare function clearCache(): void;
+//# sourceMappingURL=world-bank.d.ts.map

package/dist/sdk/world-bank.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"world-bank.d.ts","sourceRoot":"","sources":["../../src/sdk/world-bank.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAaH,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACzC,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACvC,eAAe,EAAE,MAAM,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACtC,WAAW,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAOD,4DAA4D;AAC5D,wBAAsB,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,GAAE;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CACb,GAAG,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,gBAAgB,EAAE,CAAA;CAAE,CAAC,CAQ5D;AAED,sDAAsD;AACtD,wBAAsB,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,IAAI,CAAC,EAAE;IACtF,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CACtC,GAAG,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,gBAAgB,EAAE,CAAA;CAAE,CAAC,CAMvD;AAED,wCAAwC;AACxC,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,SAAK,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAU9F;AAED,oCAAoC;AACpC,wBAAsB,aAAa,CAAC,OAAO,SAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAIvE;AAED,iDAAiD;AACjD,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAkBrD,CAAC;AAEF,wBAAgB,UAAU,IAAI,IAAI,CAAsB"}

package/dist/sdk/world-bank.js

@@ -0,0 +1,72 @@
+/**
+ * World Bank SDK — international economic indicators for 200+ countries.
+ *
+ * API docs: https://datahelpdesk.worldbank.org/knowledgebase/articles/889392
+ * No auth required. No published rate limit.
+ *
+ * Usage:
+ *   import { getIndicator, searchIndicators } from "us-gov-open-data-mcp/sdk/world-bank";
+ *   const gdp = await getIndicator("NY.GDP.MKTP.CD", { country: "US", dateRange: "2020:2024" });
+ */
+import { createClient } from "../client.js";
+const api = createClient({
+    baseUrl: "https://api.worldbank.org/v2",
+    name: "world-bank",
+    rateLimit: { perSecond: 5, burst: 10 },
+    cacheTtlMs: 24 * 60 * 60 * 1000, // 24 hours — data updates annually for most indicators
+});
+// ─── Public API ──────────────────────────────────────────────────────
+/** Get indicator data for a country or set of countries. */
+export async function getIndicator(indicatorId, opts = {}) {
+    const country = opts.country ?? "US";
+    const data = await api.get(`/country/${country}/indicator/${indicatorId}`, { format: "json", date: opts.dateRange, per_page: opts.perPage ?? 100 });
+    if (!Array.isArray(data) || data.length < 2)
+        return { total: 0, data: [] };
+    return { total: data[0].total, data: data[1] ?? [] };
+}
+/** Compare an indicator across multiple countries. */
+export async function compareCountries(indicatorId, countries, opts) {
+    return getIndicator(indicatorId, {
+        country: countries.join(";"),
+        dateRange: opts?.dateRange,
+        perPage: opts?.perPage ?? 500,
+    });
+}
+/** Search for indicators by keyword. */
+export async function searchIndicators(query, perPage = 50) {
+    const data = await api.get(`/indicator`, { format: "json", per_page: perPage });
+    if (!Array.isArray(data) || data.length < 2 || !data[1])
+        return [];
+    const q = query.toLowerCase();
+    return data[1].filter(i => i.name.toLowerCase().includes(q) || i.id.toLowerCase().includes(q) ||
+        i.sourceNote?.toLowerCase().includes(q)).slice(0, perPage);
+}
+/** List countries with metadata. */
+export async function listCountries(perPage = 300) {
+    const data = await api.get("/country", { format: "json", per_page: perPage });
+    if (!Array.isArray(data) || data.length < 2)
+        return [];
+    return (data[1] ?? []).filter(c => c.region?.id !== "NA"); // filter out aggregates
+}
+/** Popular indicator IDs for quick reference. */
+export const POPULAR_INDICATORS = {
+    "NY.GDP.MKTP.CD": "GDP (current US$)",
+    "NY.GDP.MKTP.KD.ZG": "GDP growth (annual %)",
+    "NY.GDP.PCAP.CD": "GDP per capita (current US$)",
+    "SP.POP.TOTL": "Population, total",
+    "SP.DYN.LE00.IN": "Life expectancy at birth (years)",
+    "SH.XPD.CHEX.PC.CD": "Health expenditure per capita (US$)",
+    "SH.XPD.CHEX.GD.ZS": "Health expenditure (% of GDP)",
+    "FP.CPI.TOTL.ZG": "Inflation, consumer prices (annual %)",
+    "SL.UEM.TOTL.ZS": "Unemployment (% of labor force)",
+    "GC.DOD.TOTL.GD.ZS": "Central gov't debt (% of GDP)",
+    "NE.EXP.GNFS.ZS": "Exports of goods and services (% of GDP)",
+    "NE.IMP.GNFS.ZS": "Imports of goods and services (% of GDP)",
+    "SI.POV.GINI": "Gini index (income inequality)",
+    "SE.XPD.TOTL.GD.ZS": "Education expenditure (% of GDP)",
+    "EN.ATM.CO2E.PC": "CO2 emissions (metric tons per capita)",
+    "IT.NET.USER.ZS": "Internet users (% of population)",
+    "SM.POP.NETM": "Net migration",
+};
+export function clearCache() { api.clearCache(); }
+//# sourceMappingURL=world-bank.js.map

package/dist/sdk/world-bank.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,22 @@
+#!/usr/bin/env node
+/**
+ * FastMCP server — auto-wires modules from named exports.
+ *
+ * Each module exports: name, displayName, description, auth?, workflow?, tips?, reference?, tools[]
+ * This file auto-registers tools, generates resources + instructions, and adds clear_cache.
+ *
+ * Adding a new API = create sdk/*.ts + modules/*.ts, import here, push to MODULES.
+ *
+ * Supports:
+ *   - stdio transport (default, for VS Code / Claude Desktop / Cursor)
+ *   - HTTP Stream transport (for web apps, remote access)
+ *   - Selective module loading (load only what you need)
+ *
+ * Usage:
+ *   node dist/server.js                                   # stdio (default)
+ *   node dist/server.js --transport httpStream --port 8080 # HTTP on port 8080
+ *   MODULES=fred,bls,treasury node dist/server.js         # load only 3 modules
+ *   node dist/server.js --modules fred,bls,treasury       # same via CLI flag
+ */
+import "dotenv/config";
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,eAAe,CAAC"}