@cliwant/mcp-sam-gov 0.2.1

package/dist/federal-register.js

@@ -0,0 +1,117 @@
+/**
+ * Federal Register API v1 wrappers (keyless, no registration).
+ *
+ * Federal Register is the daily journal of the US federal government —
+ * proposed rules, final rules, presidential documents, public notices.
+ * Critical context for any federal contracting question that touches
+ * regulation, set-aside policy, or new acquisition guidance.
+ *
+ * Endpoints:
+ *   - documents.json — search across documents (filters: agencies,
+ *     conditions, type, date range)
+ *   - documents/{number}.json — single document detail (full body URL,
+ *     abstract, citation, effective date)
+ *   - agencies.json — agency reference list
+ *
+ * All endpoints are public + keyless (no API key, no registration).
+ * Rate-limit: documented as ~1000 req/hour per IP (informal).
+ */
+const FED_REG = "https://www.federalregister.gov/api/v1";
+async function fetchJson(url) {
+    const r = await fetch(url, {
+        headers: { Accept: "application/json" },
+        signal: AbortSignal.timeout(15_000),
+    });
+    if (!r.ok) {
+        throw new Error(`Federal Register ${url} returned ${r.status}`);
+    }
+    return (await r.json());
+}
+const TYPE_MAP = {
+    Rule: "RULE",
+    "Proposed Rule": "PRORULE",
+    Notice: "NOTICE",
+    "Presidential Document": "PRESDOCU",
+};
+export async function searchDocuments(args) {
+    const url = new URL(`${FED_REG}/documents.json`);
+    url.searchParams.set("per_page", String(args.perPage ?? 10));
+    if (args.query) {
+        url.searchParams.set("conditions[term]", args.query);
+    }
+    for (const slug of args.agencySlugs ?? []) {
+        url.searchParams.append("conditions[agencies][]", slug);
+    }
+    if (args.type) {
+        url.searchParams.append("conditions[type][]", args.type);
+    }
+    if (args.publicationDateFrom) {
+        url.searchParams.set("conditions[publication_date][gte]", args.publicationDateFrom);
+    }
+    if (args.publicationDateTo) {
+        url.searchParams.set("conditions[publication_date][lte]", args.publicationDateTo);
+    }
+    if (args.effectiveDateFrom) {
+        url.searchParams.set("conditions[effective_date][gte]", args.effectiveDateFrom);
+    }
+    const json = await fetchJson(url.toString());
+    return {
+        totalRecords: json.count ?? 0,
+        totalPages: json.total_pages ?? 0,
+        documents: (json.results ?? []).map((d) => ({
+            documentNumber: d.document_number ?? "",
+            title: d.title ?? "",
+            type: TYPE_MAP[d.type ?? ""] ?? "UNKNOWN",
+            typeDisplay: d.type ?? "",
+            abstract: d.abstract ?? "",
+            htmlUrl: d.html_url ?? "",
+            pdfUrl: d.pdf_url,
+            publicationDate: d.publication_date ?? "",
+            effectiveDate: d.effective_on,
+            agencies: (d.agencies ?? []).map((a) => ({
+                name: a.name ?? "",
+                slug: a.slug ?? "",
+            })),
+        })),
+    };
+}
+export async function getDocument(documentNumber) {
+    const json = await fetchJson(`${FED_REG}/documents/${encodeURIComponent(documentNumber)}.json`);
+    return {
+        documentNumber: json.document_number ?? "",
+        title: json.title ?? "",
+        type: TYPE_MAP[json.type ?? ""] ?? "UNKNOWN",
+        typeDisplay: json.type ?? "",
+        abstract: json.abstract ?? "",
+        htmlUrl: json.html_url ?? "",
+        pdfUrl: json.pdf_url,
+        rawTextUrl: json.raw_text_url,
+        publicationDate: json.publication_date ?? "",
+        effectiveDate: json.effective_on,
+        citation: json.citation,
+        pageCount: json.page_length,
+        agencies: (json.agencies ?? []).map((a) => ({
+            name: a.name ?? "",
+            slug: a.slug ?? "",
+        })),
+        cfrReferences: (json.cfr_references ?? []).map((c) => ({
+            title: c.title ?? "",
+            part: c.part,
+            chapter: c.chapter,
+        })),
+    };
+}
+export async function listAgencies(args) {
+    const json = await fetchJson(`${FED_REG}/agencies.json?per_page=${args.perPage ?? 100}`);
+    return {
+        agencies: (json ?? []).map((a) => ({
+            id: a.id ?? 0,
+            name: a.name ?? "",
+            shortName: a.short_name,
+            slug: a.slug ?? "",
+            description: a.description ?? "",
+            parentId: a.parent_id,
+        })),
+    };
+}
+//# sourceMappingURL=federal-register.js.map

package/dist/federal-register.js.map

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

package/dist/grants.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Grants.gov v1 API wrappers (keyless).
+ *
+ * Grants.gov hosts federal financial-assistance opportunities (grants,
+ * cooperative agreements). Distinct from SAM.gov contracts but the
+ * same pursuit ICP often cares about both.
+ *
+ * Endpoints (POST JSON, no key):
+ *   - /v1/api/search2 — search opportunities
+ *   - /v1/api/fetchOpportunity — single grant detail
+ *
+ * Documented at https://grants.gov/web/grants/s2s/grantor/schemas/grants-search-2-soap.html
+ */
+export type GrantStatus = "forecasted" | "posted" | "closed" | "archived";
+export declare function searchGrants(args: {
+    keyword?: string;
+    cfda?: string;
+    agency?: string;
+    oppNum?: string;
+    oppStatuses?: GrantStatus[];
+    rows?: number;
+}): Promise<{
+    totalRecords: number;
+    grants: {
+        id: string;
+        opportunityNumber: string;
+        title: string;
+        agencyCode: string;
+        agencyName: string;
+        openDate: string | undefined;
+        closeDate: string | undefined;
+        status: string | undefined;
+        docType: string | undefined;
+        cfdaList: string | undefined;
+    }[];
+}>;
+export declare function getGrant(args: {
+    opportunityId: string;
+}): Promise<{
+    id: number;
+    opportunityNumber: string;
+    title: string;
+    agency: {
+        code: string | undefined;
+        name: string | undefined;
+    };
+    description: string;
+    postingDate: string | undefined;
+    responseDate: string | undefined;
+    archiveDate: string | undefined;
+    awardCeiling: number | undefined;
+    awardFloor: number | undefined;
+    estimatedFunding: number | undefined;
+    expectedNumberOfAwards: number | undefined;
+    applicantTypes: string[];
+    fundingInstruments: string[];
+    fundingCategories: string[];
+    cfdaPrograms: {
+        number: string;
+        title: string;
+    }[];
+}>;
+//# sourceMappingURL=grants.d.ts.map

package/dist/grants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grants.d.ts","sourceRoot":"","sources":["../src/grants.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAoBH,MAAM,MAAM,WAAW,GAAG,YAAY,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAAC;AAE1E,wBAAsB,YAAY,CAAC,IAAI,EAAE;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,WAAW,EAAE,CAAC;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;;;;;;;;;;;;;;GA+CA;AAED,wBAAsB,QAAQ,CAAC,IAAI,EAAE;IAAE,aAAa,EAAE,MAAM,CAAA;CAAE;;;;;;;;;;;;;;;;oBAoDpC,MAAM,EAAE;wBAGR,MAAM,EAAE;uBAGR,MAAM,EAAE;;;;;GAMjC"}

package/dist/grants.js

@@ -0,0 +1,93 @@
+/**
+ * Grants.gov v1 API wrappers (keyless).
+ *
+ * Grants.gov hosts federal financial-assistance opportunities (grants,
+ * cooperative agreements). Distinct from SAM.gov contracts but the
+ * same pursuit ICP often cares about both.
+ *
+ * Endpoints (POST JSON, no key):
+ *   - /v1/api/search2 — search opportunities
+ *   - /v1/api/fetchOpportunity — single grant detail
+ *
+ * Documented at https://grants.gov/web/grants/s2s/grantor/schemas/grants-search-2-soap.html
+ */
+const GRANTS = "https://api.grants.gov/v1/api";
+async function postJson(endpoint, body) {
+    const r = await fetch(`${GRANTS}/${endpoint}`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(body),
+        signal: AbortSignal.timeout(15_000),
+    });
+    if (!r.ok) {
+        throw new Error(`Grants.gov ${endpoint} returned ${r.status}`);
+    }
+    return (await r.json());
+}
+export async function searchGrants(args) {
+    const body = {
+        rows: args.rows ?? 10,
+        keyword: args.keyword ?? "",
+        cfda: args.cfda ?? "",
+        agencies: args.agency ?? "",
+        oppNum: args.oppNum ?? "",
+        oppStatuses: (args.oppStatuses ?? ["forecasted", "posted"]).join("|"),
+    };
+    const json = await postJson("search2", body);
+    if (json.errorcode && json.errorcode !== 0) {
+        throw new Error(`Grants.gov error: ${json.msg ?? "unknown"}`);
+    }
+    return {
+        totalRecords: json.data?.hitCount ?? 0,
+        grants: (json.data?.oppHits ?? []).map((g) => ({
+            id: g.id ?? "",
+            opportunityNumber: g.number ?? "",
+            title: g.title ?? "",
+            agencyCode: g.agencyCode ?? "",
+            agencyName: g.agencyName ?? "",
+            openDate: g.openDate,
+            closeDate: g.closeDate,
+            status: g.oppStatus,
+            docType: g.docType,
+            cfdaList: g.cfdaList,
+        })),
+    };
+}
+export async function getGrant(args) {
+    const json = await postJson("fetchOpportunity", {
+        opportunityId: args.opportunityId,
+    });
+    if (json.errorcode && json.errorcode !== 0) {
+        throw new Error(`Grants.gov error: ${json.msg ?? "unknown"}`);
+    }
+    const d = json.data ?? {};
+    const s = d.synopsis ?? {};
+    return {
+        id: d.id ?? 0,
+        opportunityNumber: d.opportunityNumber ?? "",
+        title: d.opportunityTitle ?? "",
+        agency: { code: s.agencyCode ?? d.owningAgencyCode, name: s.agencyName },
+        description: s.synopsisDesc ?? d.synopsisDesc ?? "",
+        postingDate: s.postingDate,
+        responseDate: s.responseDate,
+        archiveDate: s.archiveDate,
+        awardCeiling: s.awardCeiling,
+        awardFloor: s.awardFloor,
+        estimatedFunding: s.estimatedFunding,
+        expectedNumberOfAwards: s.expectedNumberOfAwards,
+        applicantTypes: (s.applicantTypes ?? [])
+            .map((a) => a.description)
+            .filter(Boolean),
+        fundingInstruments: (s.fundingInstruments ?? [])
+            .map((f) => f.description)
+            .filter(Boolean),
+        fundingCategories: (s.fundingActivityCategories ?? [])
+            .map((f) => f.description)
+            .filter(Boolean),
+        cfdaPrograms: (d.cfdas ?? []).map((c) => ({
+            number: c.cfdaNumber ?? "",
+            title: c.programTitle ?? "",
+        })),
+    };
+}
+//# sourceMappingURL=grants.js.map

package/dist/grants.js.map

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

package/dist/sam-gov/client.d.ts

@@ -0,0 +1,69 @@
+/**
+ * @cliwant/mcp-sam-gov/sam-gov — keyless SAM.gov client.
+ *
+ * Two endpoint layers, one normalized contract:
+ *   1. Authenticated `api.sam.gov/opportunities/v2/search` —
+ *      higher rate limit + full historical archive. Used when the
+ *      caller passes an API key.
+ *   2. Keyless `sam.gov/api/prod/sgs/v1/search/` (HAL JSON) —
+ *      the same data the SAM.gov website uses to render itself.
+ *      No registration. Reasonable rate.
+ *
+ * The client picks layer 1 if an API key is available, falling back
+ * to layer 2 transparently. Callers don't have to care.
+ */
+import type { EntitySearchResult, SamGovClientOptions, SamOpportunity, SamSearchFilters, SamSearchResult } from "./types.js";
+export declare class SamGovClient {
+    private readonly apiKey?;
+    private readonly userAgent;
+    private readonly fetchImpl;
+    private readonly logger;
+    constructor(options?: SamGovClientOptions);
+    /**
+     * Search SAM.gov opportunities.
+     *
+     * Three-tier fallback:
+     *   1. Authenticated v2 search (if `apiKey` configured)
+     *   2. Keyless HAL search
+     *   3. Empty result (caller can decide how to surface "no data")
+     */
+    searchOpportunities(filters: SamSearchFilters): Promise<SamSearchResult>;
+    /**
+     * Resolve a single opportunity by `noticeId` (32-char hex).
+     *
+     * Three-tier fallback:
+     *   1. Authenticated v2 search filtered by noticeId (if key)
+     *   2. Keyless detail endpoint + resources + org enrichment
+     *   3. null
+     */
+    getOpportunity(noticeId: string): Promise<SamOpportunity | null>;
+    /**
+     * Fetch the full description body for an opportunity.
+     *
+     * Handles three input shapes:
+     *   1. Already-extracted text (no `http://`) — pass-through
+     *   2. `api.sam.gov/.../v1/api/getDescription/...` — append `?api_key=`
+     *   3. Public sam.gov URL — HAL headers, no key
+     */
+    fetchOpportunityDescription(input: string): Promise<string>;
+    /**
+     * Look up registered SAM.gov entities by legal business name.
+     * Requires an API key (the entity registration API has no public
+     * keyless mirror — it's the one place BYOK is genuinely needed).
+     */
+    searchEntities(query: string): Promise<EntitySearchResult>;
+    /**
+     * Build the keyless download URL for an attachment, given the
+     * resourceId from getPublicResourceLinks(). Returns a 303 redirect
+     * to a signed S3 URL when fetched. Useful for embedding viewers.
+     */
+    publicDownloadUrl(resourceId: string): string;
+    private buildAuthSearchUrl;
+    private searchPublic;
+    private getOpportunityPublic;
+    private getPublicResourceLinks;
+    private getPublicOrgName;
+    private publicHeaders;
+    private warn;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/sam-gov/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/sam-gov/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EACV,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,EACd,gBAAgB,EAChB,eAAe,EAChB,MAAM,YAAY,CAAC;AASpB,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkD;gBAE7D,OAAO,GAAE,mBAAwB;IAO7C;;;;;;;OAOG;IACG,mBAAmB,CACvB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,eAAe,CAAC;IA2B3B;;;;;;;OAOG;IACG,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAqCtE;;;;;;;OAOG;IACG,2BAA2B,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAsDjE;;;;OAIG;IACG,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAkDhE;;;;OAIG;IACH,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;IAM7C,OAAO,CAAC,kBAAkB;YA2BZ,YAAY;YAyEZ,oBAAoB;YA8DpB,sBAAsB;YAwBtB,gBAAgB;IAuB9B,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,IAAI;CAGb"}