@cliwant/mcp-sam-gov 1.14.0 → 1.15.0

package/dist/data-map.js

@@ -0,0 +1,289 @@
+/**
+ * State & local data map — single source of truth.
+ *
+ * These entries are exported for:
+ *   (a) the MCP resource samgov://data-map/state-local (resources/read)
+ *   (b) consistency tests (SKILL.md table must agree on domain/id/rows)
+ *
+ * Keep verified row counts and notes current here only; SKILL.md table and
+ * the resource content are generated from this array.
+ */
+/**
+ * Verified 2026-09-21 — all keyless.
+ */
+export const DATA_MAP_ENTRIES = [
+    // ── State-level ──────────────────────────────────────────────────────────
+    {
+        state: "VA",
+        jurisdiction: "Virginia",
+        dataLabel: "eVA PO line items 2023",
+        tool: "ckan_query",
+        keyArgs: "host=data.virginia.gov, resourceId=3c7f1bde-35b0-4fbf-b89c-978a19124d53",
+        rows: 1693227,
+        approximate: false,
+        notNote: "the live eVA portal (login-gated)",
+        extra: "Years 2016–2026 have separate resourceIds; ckan_discover_datasets host=data.virginia.gov q=eVA procurement lists them (2024=25a59527, 2025=b8dc22a8, 2026=76f6831d)",
+    },
+    {
+        state: "MA",
+        jurisdiction: "Massachusetts",
+        dataLabel: "Comptroller vendor payments (CTHRU)",
+        tool: "socrata_query",
+        keyArgs: "domain=cthru.data.socrata.com, datasetId=pegc-naaa",
+        rows: 49000000,
+        approximate: true,
+        notNote: "an award or bid register; these are payment transactions",
+    },
+    {
+        state: "NJ",
+        jurisdiction: "New Jersey",
+        dataLabel: "YourMoney agency purchasing by vendor",
+        tool: "socrata_query",
+        keyArgs: "domain=data.nj.gov, datasetId=ubnu-tqu7",
+        rows: 660425,
+        approximate: false,
+        notNote: "a solicitation or bid register; agency expenditure rows",
+    },
+    {
+        state: "NY",
+        jurisdiction: "New York",
+        dataLabel: "State authority procurement contracts",
+        tool: "socrata_query",
+        keyArgs: "domain=data.ny.gov, datasetId=ehig-g5x3",
+        rows: 275763,
+        approximate: false,
+        notNote: "all NYS agencies (authorities only) and NOT active solicitations",
+    },
+    {
+        state: "NY",
+        jurisdiction: "New York",
+        dataLabel: "MTA procurement contracts",
+        tool: "socrata_query",
+        keyArgs: "domain=data.ny.gov, datasetId=twsw-2mqa",
+        rows: 107503,
+        approximate: false,
+        notNote: "a live MTA bid portal; MTA historical contract records",
+    },
+    {
+        state: "WA",
+        jurisdiction: "Washington",
+        dataLabel: "Agency contract register",
+        tool: "socrata_query",
+        keyArgs: "domain=data.wa.gov, datasetId=s8d5-pj78",
+        rows: 79329,
+        approximate: false,
+        notNote: "a solicitation or bid feed; awarded contract records",
+    },
+    {
+        state: "WA",
+        jurisdiction: "Washington",
+        dataLabel: "Master-contract sales by vendor/customer",
+        tool: "socrata_query",
+        keyArgs: "domain=data.wa.gov, datasetId=n8q6-4twj",
+        rows: 245831,
+        approximate: false,
+        notNote: "open bids; sales reported off statewide master contracts",
+    },
+    {
+        state: "MT",
+        jurisdiction: "Montana",
+        dataLabel: "DOA contracts awarded",
+        tool: "tableau_view_csv",
+        keyArgs: "view=mt_contracts_awarded",
+        rows: 4554,
+        approximate: true,
+        notNote: "a bid portal; awarded records only, freshness set by publisher",
+    },
+    {
+        state: "SD",
+        jurisdiction: "South Dakota",
+        dataLabel: "Open Checkbook vendor payments",
+        tool: "open_checkbook_search",
+        keyArgs: "portal=sd",
+        rows: 741000,
+        approximate: true,
+        notNote: "an award register; only ~3 most-recent FYs, exact-match filters",
+    },
+    {
+        state: "IL",
+        jurisdiction: "Illinois",
+        dataLabel: "CDB capital project future bids",
+        tool: "socrata_query",
+        keyArgs: "domain=data.illinois.gov, datasetId=6rb8-ntpm",
+        rows: 48,
+        approximate: false,
+        notNote: "a comprehensive solicitation feed; only ~48 upcoming CDB capital bids",
+    },
+    {
+        state: "IL",
+        jurisdiction: "Illinois",
+        dataLabel: "IDHR certified eligible bidders",
+        tool: "socrata_query",
+        keyArgs: "domain=data.illinois.gov, datasetId=w8h2-q8hu",
+        rows: 7848,
+        approximate: false,
+        notNote: "a bid or award register; vendor-eligibility directory only",
+    },
+    // ── Texas — verified 2026-09-21 ──────────────────────────────────────────
+    {
+        state: "TX",
+        jurisdiction: "Texas",
+        dataLabel: "TxDOT current lettings (★live bid-line items)",
+        tool: "socrata_query",
+        keyArgs: "domain=data.texas.gov, datasetId=qh8x-rm8r",
+        rows: 8861,
+        approximate: false,
+        notNote: "rows are bid LINE ITEMS not projects (8,861 rows = 412 distinct project_ids — report project count not row count); TxDOT highway lettings ONLY, not all Texas procurement; rolling window only (past lettings dropped, cannot answer historical questions); ESBD/TxSmartBuy non-TxDOT solicitations are absent",
+        extra: "★First live state solicitation feed in this map. Use $select=count(distinct project_id) for open-bid count.",
+    },
+    {
+        state: "TX",
+        jurisdiction: "Texas",
+        dataLabel: "DIR Cooperative Contract Sales FY2010–FY2025 (archive)",
+        tool: "socrata_query",
+        keyArgs: "domain=data.texas.gov, datasetId=w64c-ndf7",
+        rows: 10749743,
+        approximate: false,
+        notNote: "bids or awards; purchase line items off DIR cooperative contracts (historical)",
+    },
+    {
+        state: "TX",
+        jurisdiction: "Texas",
+        dataLabel: "DIR Cooperative & Tele Contract Sales FY2026",
+        tool: "socrata_query",
+        keyArgs: "domain=data.texas.gov, datasetId=a743-wj72",
+        rows: 2077855,
+        approximate: false,
+        notNote: "historical FY2026 purchase lines (same shape as w64c-ndf7); not bids",
+    },
+    {
+        state: "TX",
+        jurisdiction: "Texas",
+        dataLabel: "DIR Current Active Cooperative Contracts",
+        tool: "socrata_query",
+        keyArgs: "domain=data.texas.gov, datasetId=vipt-h4ye",
+        rows: 5167,
+        approximate: false,
+        notNote: "a solicitation feed; active cooperative contract register (not TxDOT lettings)",
+    },
+    {
+        state: "TX",
+        jurisdiction: "Texas",
+        dataLabel: "TCEQ Current Contracts & Purchase Orders",
+        tool: "socrata_query",
+        keyArgs: "domain=data.texas.gov, datasetId=svjm-sdfz",
+        rows: 2067,
+        approximate: false,
+        notNote: "statewide; one agency (TCEQ) only",
+    },
+    // ── Maryland — verified 2026-09-21 ───────────────────────────────────────
+    {
+        state: "MD",
+        jurisdiction: "Maryland",
+        dataLabel: "eMaryland Marketplace (eMMA) bids — FY2018 exemplar",
+        tool: "socrata_query",
+        keyArgs: "domain=opendata.maryland.gov, datasetId=pgna-cxjh",
+        rows: 107303,
+        approximate: false,
+        notNote: "rows are bid LINE ITEMS not bids — FY2018 is 107,303 rows for only 3,067 bids (35× overcount); always use $select=count(distinct bid_number) for actual bid count. Coverage stops at FY2019 — eMMA migrated to Periscope mid-FY2019; there is no FY2020+ mirror and this dataset cannot answer questions about current Maryland bids",
+        extra: "All six FY datasetIds: FY2018=pgna-cxjh (107,303 rows/3,067 bids), FY2017=qkjf-rv4t (64,331/4,943), FY2016=7ang-84wj (45,204/4,818), FY2015=3hzs-sazv (46,895/4,898), FY2014=itax-4ccz (45,551/4,884), FY2019=ttg5-zfzj (4,623/388 — small because eMMA migrated to Periscope mid-year; first row is a sparse placeholder, subsequent rows are complete).",
+    },
+    // ── Oregon — verified 2026-09-21 ─────────────────────────────────────────
+    {
+        state: "OR",
+        jurisdiction: "Oregon",
+        dataLabel: "OregonBuys Purchases and Contracts FY2022–FY2025",
+        tool: "socrata_query",
+        keyArgs: "domain=data.oregon.gov, datasetId=qyug-f2km",
+        rows: 109119,
+        approximate: false,
+        notNote: "open solicitations — these are issued purchase orders and contracts (not bids). ORPIN was the retired system; OregonBuys is its replacement. qyug-f2km covers sent_date 2021-07-01 → 2025-07-01 (FY2022–FY2025); 92,224 distinct po_nbr",
+        extra: "Historical ORPIN datasets (retired system, same domain): Contracts Issued=6e9e-sfc4 (93,846 rows), Contracts Expired=8izy-bwhd (92,755 rows), Statewide Price Agreement Spend=gart-52me (5,224 rows). All keyless.",
+    },
+    // ── Vermont — verified 2026-09-21 ────────────────────────────────────────
+    {
+        state: "VT",
+        jurisdiction: "Vermont",
+        dataLabel: "Purchase Orders with Vendor Information (current FY, live-ish)",
+        tool: "socrata_query",
+        keyArgs: "domain=data.vermont.gov, datasetId=8ewu-igdm",
+        rows: 111271,
+        approximate: false,
+        notNote: "a bid or award register — issued purchase orders. 39,882 distinct po_id (~2.8 line items per PO). po_date 2025-07-02 → 2026-06-19 (current fiscal year, so this is live-ish state spend, not an archive)",
+    },
+    // ── Colorado (City of Denver on state portal) — verified 2026-09-21 ──────
+    {
+        state: "CO",
+        jurisdiction: "City of Denver",
+        dataLabel: "City of Denver Procurement Transactions (on CO state portal)",
+        tool: "socrata_query",
+        keyArgs: "domain=data.colorado.gov, datasetId=66zf-qjdd",
+        rows: 76357,
+        approximate: false,
+        notNote: "Colorado STATE procurement — this is City of Denver spend hosted on the Colorado state portal (data.colorado.gov). An agent that reads the domain as the jurisdiction gets this wrong. Updated 2026-09-20.",
+    },
+    {
+        state: "CO",
+        jurisdiction: "City of Denver",
+        dataLabel: "City of Denver Checkbook (on CO state portal)",
+        tool: "socrata_query",
+        keyArgs: "domain=data.colorado.gov, datasetId=wnau-xrqi",
+        rows: 154595,
+        approximate: false,
+        notNote: "Colorado STATE procurement — this is City of Denver checkbook data hosted on the Colorado state portal (data.colorado.gov). An agent that reads the domain as the jurisdiction gets this wrong. Updated 2026-09-20.",
+    },
+];
+/**
+ * Format a row count for display.
+ *
+ * HONESTY: an EXACT count (approximate:false) is printed in full with thousands
+ * separators — never rounded. The table header promises a "verified row count",
+ * so rounding a measured 1,693,227 to "2M" would overstate it by 18% while still
+ * reading as exact. Only an entry explicitly marked `approximate` is rounded, and
+ * that form always carries a leading `~` so the reader can tell the two apart.
+ */
+function fmtRows(e) {
+    if (e.rows === null)
+        return "?";
+    if (!e.approximate)
+        return e.rows.toLocaleString("en-US");
+    // Keep 2 significant figures below 10 units so "~5k" never stands in for a
+    // measured 4,554 (a 10% overstatement); 49,000,000 still renders "~49M".
+    const scale = (v, suffix) => `${v < 10 ? v.toFixed(1).replace(/\.0$/, "") : String(Math.round(v))}${suffix}`;
+    const n = e.rows >= 1000000 ? scale(e.rows / 1000000, "M") :
+        e.rows >= 1000 ? scale(e.rows / 1000, "k") :
+            String(e.rows);
+    return `~${n}`;
+}
+/**
+ * Render the state-level entries as a Markdown table.
+ * Matches the format in SKILL.md §State & local data map.
+ */
+export function renderStateTableMarkdown() {
+    const header = "| Jurisdiction | Data | Tool · key args | Rows | NOT |\n" +
+        "|---|---|---|---|---|\n";
+    const rows = DATA_MAP_ENTRIES.map((e) => {
+        const extra = e.extra ? ` ${e.extra}` : "";
+        return `| **${e.jurisdiction}** | ${e.dataLabel} | \`${e.tool}\` ${e.keyArgs} | ${fmtRows(e)} | ${e.notNote}${extra} |`;
+    });
+    return header + rows.join("\n");
+}
+/** Full resource content: header + state table */
+export function renderDataMapMarkdown() {
+    return `# State & local data map
+
+Agent-readable lookup: jurisdiction → data type → exact tool call → verified row count → what it is NOT (the most common source of agent error).
+
+**State-level open-data sources (verified 2026-09-21, all keyless):**
+
+${renderStateTableMarkdown()}
+
+**County & city** — use \`socrata_discover_datasets\` to find dataset IDs for: NYC (data.cityofnewyork.us), Chicago (data.cityofchicago.org), Austin TX (data.austintexas.gov), Dallas TX (www.dallasopendata.com), LA (controllerdata.lacity.org), King County WA (data.kingcounty.gov), Cook County IL (datacatalog.cookcountyil.gov), Montgomery County MD (data.montgomerycountymd.gov). For Hennepin County MN and Charlotte-Mecklenburg NC capital project pipelines, use \`arcgis_feature_query\` (hennepin_transportation_cip / charlotte_mecklenburg_cip) — these are CIP pipelines, NOT solicitation or award registers.
+
+**State portals with no keyless procurement content (measured absence, not unexplored):**
+- Login-gated or WAF-blocked live-bid portals: CA (Cal eProcure), TX ESBD/TxSmartBuy non-TxDOT (TxDOT lettings ARE available via qh8x-rm8r above), OH, NC, MI, and Periscope-based portals for IL/MA/NJ live bids.
+- Portal exists but carries no procurement datasets: PA (data.pa.gov is live; scoped catalog has 0 bid/vendor/procurement datasets matching). Michigan (data.michigan.gov) was checked 2026-09-21 and carries only NIGP commodity code reference tables (w3u3-uptp 9,333 rows; jv5q-yp8x 235 rows) — not procurement transactions.
+- No state-level open-data portal: FL (data.fl.gov NXDOMAIN), GA (data.georgia.gov NXDOMAIN). These states have no keyless state procurement data source — this is a measured absence, not a connectivity block.
+`;
+}
+//# sourceMappingURL=data-map.js.map

package/dist/data-map.js.map

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

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;GAgBG;AAQH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,YAAY,EAKb,MAAM,oBAAoB,CAAC;AAklJ5B,KAAK,OAAO,GAAG;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,CAAC,CAAC,UAAU,CAAC;IAO1B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE;QAAE,GAAG,EAAE,YAAY,CAAA;KAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACxE,CAAC;AAoBF,eAAO,MAAM,KAAK,EAAE,OAAO,EAo0D1B,CAAC;AA0PF,wBAAsB,OAAO,CAC3B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,GAAG,EAAE,YAAY,GAChB,OAAO,CAAC,OAAO,CAAC,CAkClB;AAyBD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CActD;AACD,wFAAwF;AACxF,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,IAAI,CAAC;IACnB,aAAa,EAAE,IAAI,CAAC;CACrB,CAEA;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAkE7E"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;GAgBG;AAUH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,YAAY,EAKb,MAAM,oBAAoB,CAAC;AAqlJ5B,KAAK,OAAO,GAAG;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,CAAC,CAAC,UAAU,CAAC;IAO1B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE;QAAE,GAAG,EAAE,YAAY,CAAA;KAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACxE,CAAC;AAoBF,eAAO,MAAM,KAAK,EAAE,OAAO,EAo0D1B,CAAC;AA8RF,wBAAsB,OAAO,CAC3B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,GAAG,EAAE,YAAY,GAChB,OAAO,CAAC,OAAO,CAAC,CAkClB;AAyBD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CActD;AACD,wFAAwF;AACxF,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,IAAI,CAAC;IACnB,aAAa,EAAE,IAAI,CAAC;CACrB,CAEA;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAkE7E"}

package/dist/server.js

@@ -18,7 +18,7 @@
  */
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { CallToolRequestSchema, ListResourcesRequestSchema, ListToolsRequestSchema, ReadResourceRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
 import { z } from "zod";
 import { SamGovClient, daysUntilResponse, applyResponseDeadlineWindow, } from "./sam-gov/index.js";
 import * as usas from "./usaspending.js";
@@ -86,6 +86,7 @@ import * as keys from "./keys.js";
 import { toToolError, ToolErrorCarrier, errorFromResponse } from "./errors.js";
 import * as feedback from "./feedback.js";
 import { checkForUpdate } from "./update-check.js";
+import { renderDataMapMarkdown } from "./data-map.js";
 import { buildMeta, isMetaBundle, withMeta, } from "./meta.js";
 import { pathToFileURL, fileURLToPath } from "node:url";
 import { realpathSync } from "node:fs";
@@ -93,7 +94,7 @@ import { resolveToolsets, ALL_TOOLSET_NAMES, TOOLSET_HINTS, filterToolsFor, tool
 const SERVER_NAME = "mcp-sam-gov";
 // Kept in lockstep with package.json / manifest.json / server.json.
 // Keep in sync with package.json "version" (asserted at release; see CHANGELOG).
-const SERVER_VERSION = "1.14.0";
+const SERVER_VERSION = "1.15.0";
 // ─── Tool input schemas (Zod) ────────────────────────────────────
 const SamSearchInput = z.object({
     query: z.string().optional().describe("Free-text title query"),
@@ -1568,7 +1569,8 @@ const EdgarCompanyConceptInput = z.object({
 // validated strings (a bad column ⇒ upstream 400 ⇒ invalid_input, surfaced).
 const SocrataDomainEnum = z
     .enum(socrata.SOCRATA_DOMAINS)
-    .describe("Which allowlisted Socrata portal to query (curated .gov hosts + USAC E-rate .org; the SSRF host allowlist — no free host). e.g. data.ny.gov, data.texas.gov, data.wa.gov, opendata.usac.org.");
+    .describe("Which allowlisted Socrata portal to query (the SSRF host allowlist — no free host). " +
+    "Jurisdiction of non-obvious hosts: cthru.data.socrata.com=MASSACHUSETTS statewide (CTHRU); atlanta.data.socrata.com=Atlanta GA; controllerdata.lacity.org+data.lacity.org=Los Angeles; www.dallasopendata.com=Dallas TX; data.brla.gov=Baton Rouge LA; data.kcmo.org=Kansas City MO; data.cstx.gov=College Station TX; data.weho.org=West Hollywood CA; opendata.usac.org+datahub.usac.org=federal USAC E-rate. data.colorado.gov's procurement data is CITY OF DENVER, not CO state.");
 const SocrataQueryInput = z.object({
     domain: SocrataDomainEnum,
     datasetId: z
@@ -1621,7 +1623,8 @@ const SocrataDiscoverDatasetsInput = z.object({
         .string()
         .min(1)
         .describe("Keyword(s) to find datasets, e.g. 'procurement', 'vendor payments', 'checkbook'."),
-    domain: SocrataDomainEnum.optional().describe("Optional: scope discovery to ONE allowlisted portal. Omit to search the whole allowlist. NOTE: the federated catalog does not index every host (e.g. USAC E-rate returns 0) — those remain queryable via socrata_query with a known 4x4."),
+    domain: SocrataDomainEnum.optional().describe("Optional: scope discovery to ONE portal; omit to search all. The catalog does not index every host (USAC returns 0); those stay queryable via socrata_query with a known 4x4. " +
+        "Jurisdiction of non-obvious hosts: cthru.data.socrata.com=MASSACHUSETTS statewide (CTHRU); atlanta.data.socrata.com=Atlanta GA; controllerdata.lacity.org+data.lacity.org=Los Angeles; www.dallasopendata.com=Dallas TX; data.brla.gov=Baton Rouge LA; data.kcmo.org=Kansas City MO; data.cstx.gov=College Station TX; data.weho.org=West Hollywood CA; opendata.usac.org+datahub.usac.org=federal USAC E-rate. data.colorado.gov's procurement data is CITY OF DENVER, not CO state."),
     limit: z
         .number()
         .int()
@@ -2625,7 +2628,7 @@ const TableauViewCsvInput = z.object({
 const ArcgisFeatureQueryInput = z.object({
     service: z
         .enum(arcgisFeature.ARCGIS_SERVICES.map((s) => s.key))
-        .describe("Service key (SSRF allowlist; 27 services). DC OCP PASS (solicitations/contracts/purchase_orders/payments). US local govs: Asheville NC, Bellevue WA, Miami-Dade FL×2, Suffolk County NY, Mat-Su AK, Las Vegas NV×2, Baltimore MD, Naperville IL, Worcester MA, Topeka KS (FY2015–23); TX/AK/IA/OK DOT bid/award registers. ND DOT flex-funding to local agencies (nddot_flex×4 — NOT vendor contracts)."),
+        .describe("Service key (SSRF allowlist; 29 services). DC OCP PASS (solicitations/contracts/purchase_orders/payments). US local govs: Asheville NC, Bellevue WA, Miami-Dade FL×2, Suffolk County NY, Mat-Su AK, Las Vegas NV×2, Baltimore MD, Naperville IL, Worcester MA, Topeka KS (FY2015–23), Hennepin County MN (CIP pipeline), Charlotte-Mecklenburg NC (CIP pipeline); TX/AK/IA/OK DOT bid/award registers. ND DOT flex-funding to local agencies (nddot_flex×4 — NOT vendor contracts)."),
     where: z
         .string()
         .min(1)
@@ -4913,7 +4916,7 @@ export const TOOLS = [
     // ━━━ Socrata / SODA — keyless SLED + E-rate open data (2) ━━━ ADR-0004
     defineTool({
         name: "socrata_query",
-        description: "Query rows from an allowlisted Socrata/SODA open-data portal (keyless; ~a dozen US state portals + USAC E-rate on one identical API — state spend/checkbook/contract/vendor-payment datasets). Input `domain` (curated allowlist enum — the SSRF host guard), `datasetId` (4x4, from socrata_discover_datasets), optional SoQL `select`/`where`/`order`/`q`, `limit` (≤1000, def 100), `offset`, `withTotal` (def true). HONESTY: SODA's row response has no total, so a count(*) companion supplies an exact totalAvailable; if it fails the rows still return with totalAvailable:null + a note (hasMore is then inferred from page-fill, never a false complete). Genuine-empty ⇒ complete:true/total:0; an outage/400/404 THROWS (never a fake empty). Value fields are strings.",
+        description: "Query rows from an allowlisted Socrata/SODA open-data portal (keyless; ~a dozen US state portals + USAC E-rate on one identical API — state spend/checkbook/contract/vendor-payment datasets). State procurement mirrors: NY ehig-g5x3, NJ ubnu-tqu7, WA s8d5-pj78, MA cthru.data.socrata.com pegc-naaa (~49M payment rows). Full map: read resource samgov://data-map/state-local. Input `domain` (curated allowlist enum — the SSRF host guard), `datasetId` (4x4, from socrata_discover_datasets), optional SoQL `select`/`where`/`order`/`q`, `limit` (≤1000, def 100), `offset`, `withTotal` (def true). HONESTY: SODA's row response has no total, so a count(*) companion supplies an exact totalAvailable; if it fails the rows still return with totalAvailable:null + a note (hasMore is then inferred from page-fill, never a false complete). Genuine-empty ⇒ complete:true/total:0; an outage/400/404 THROWS (never a fake empty). Value fields are strings.",
         inputSchema: SocrataQueryInput,
         handler: (input) => socrata.query(input),
     }),
@@ -4926,7 +4929,7 @@ export const TOOLS = [
     // ━━━ CKAN datastore_search — keyless SLED open data (2) ━━━ ADR-0006
     defineTool({
         name: "ckan_query",
-        description: "Query rows from an allowlisted CKAN datastore resource (keyless; the FIRST source on the R2 DataSource port — state/city spend/checkbook/procurement/vendor tables on the identical CKAN Action API). Input `host` (curated allowlist enum — the SSRF host guard: data.ca.gov, data.virginia.gov, data.boston.gov), `resourceId` (36-char lowercase UUID, from ckan_discover_datasets), optional `q` (full-text), `filters` (constrained object {field:value} we JSON.stringify), `sort`, `limit` (≤1000, def 100), `offset`. HONESTY: CKAN's envelope carries a real result.total — the DEFAULT is an EXACT total (exact totalAvailable + hasMore); the rare estimated total (total_was_estimated:true) is disclosed via totalIsEstimated + a note and does NOT drive pagination (it can be above OR below the truth). Genuine-empty ⇒ complete:true/total:0; an outage/404/409 or success:false THROWS (never a fake empty). Values are typed per result.fields[].type.",
+        description: "Query rows from an allowlisted CKAN datastore resource (keyless; state/city spend/checkbook/procurement/vendor tables on the CKAN Action API). VA eVA PO lines: host=data.virginia.gov resourceId=3c7f1bde-35b0-4fbf-b89c-978a19124d53. Full map: read resource samgov://data-map/state-local. Input `host` (curated allowlist enum — the SSRF host guard: data.ca.gov, data.virginia.gov, data.boston.gov), `resourceId` (36-char lowercase UUID, from ckan_discover_datasets), optional `q` (full-text), `filters` (constrained object {field:value} we JSON.stringify), `sort`, `limit` (≤1000, def 100), `offset`. HONESTY: CKAN's envelope carries a real result.total — the DEFAULT is an EXACT total (exact totalAvailable + hasMore); the rare estimated total (total_was_estimated:true) is disclosed via totalIsEstimated + a note and does NOT drive pagination (it can be above OR below the truth). Genuine-empty ⇒ complete:true/total:0; an outage/404/409 or success:false THROWS (never a fake empty). Values are typed per result.fields[].type.",
         inputSchema: CkanQueryInput,
         handler: (input) => ckan.query(input),
     }),
@@ -5260,12 +5263,12 @@ export const TOOLS = [
     }),
     // ━━━ Bonfire (Euna) — keyless per-org open-opportunity RSS (SLED bids) ━━━
     // SLED bid campaign. Thousands of US state/local govs on Bonfire expose a keyless
-    // RSS of open opportunities. Ships a curated 186-org live-verified seed directory
+    // RSS of open opportunities. Ships a curated 195-org live-verified seed directory
     // (Bonfire's authoritative org API is auth-gated → out of bounds). Fixed-suffix
     // SSRF (.bonfirehub.com). RSS = the complete open set (totalAvailable honest).
     defineTool({
         name: "bonfire_list_organizations",
-        description: "List US governments on the Bonfire (Euna) eProcurement platform — the directory for bonfire_search_opportunities (keyless). Bonfire hosts thousands of US state/local governments' open-bid portals, each with a keyless RSS feed. Filter the curated seed by `state` (2-letter) / `query` (case-insensitive name substring); `limit`(1..200)/`offset`. Output: { organizations:[{ org, name, state }] }. Feed a result's `org` to bonfire_search_opportunities. ★HONESTY: this is a CURATED, live-verified SEED of 186 US orgs — Bonfire has NO keyless org-list API (its authoritative directory is auth-gated, out of bounds), and Euna markets up to ~900 US orgs, so the seed is PARTIAL (disclosed in _meta); probe `{slug}.bonfirehub.com/opportunities/rss` to extend. totalAvailable = the exact filtered seed count.",
+        description: "List US governments on the Bonfire (Euna) eProcurement platform — the directory for bonfire_search_opportunities (keyless). Bonfire hosts thousands of US state/local governments' open-bid portals, each with a keyless RSS feed. Filter the curated seed by `state` (2-letter) / `query` (case-insensitive name substring); `limit`(1..200)/`offset`. Output: { organizations:[{ org, name, state }] }. Feed a result's `org` to bonfire_search_opportunities. ★HONESTY: this is a CURATED, live-verified SEED of 195 US orgs — Bonfire has NO keyless org-list API (its authoritative directory is auth-gated, out of bounds), and Euna markets up to ~900 US orgs, so the seed is PARTIAL (disclosed in _meta); probe `{slug}.bonfirehub.com/opportunities/rss` to extend. totalAvailable = the exact filtered seed count.",
         inputSchema: BonfireListOrganizationsInput,
         handler: (input) => bonfire.listOrganizations(input),
     }),
@@ -5679,7 +5682,7 @@ async function main() {
     // not using the default (all). The default instructions stay byte-identical.
     // B2: unknown toolset names are reported here (not only stderr) because
     // stderr is invisible in Claude Desktop.
-    const BASE_INSTRUCTIONS = "This server wraps US government open data (keyless-first). If a tool result looks wrong, a tool stays broken, or the user wants a capability this server lacks, help improve it: call the `feedback` tool — or use the `report` URL present on schema_drift / upstream_unavailable errors — to get a PREFILLED GitHub issue link, and offer it to the user to open and submit. Nothing is posted automatically; the user submits. Never include secrets or personal data in a report (the repo is public).";
+    const BASE_INSTRUCTIONS = "This server wraps US government open data (keyless-first). State/local dataset IDs (Socrata, CKAN, etc.) are listed in the MCP resource samgov://data-map/state-local. If a tool result looks wrong, a tool stays broken, or the user wants a capability this server lacks, help improve it: call the `feedback` tool — or use the `report` URL present on schema_drift / upstream_unavailable errors — to get a PREFILLED GitHub issue link, and offer it to the user to open and submit. Nothing is posted automatically; the user submits. Never include secrets or personal data in a report (the repo is public).";
     let serverInstructions;
     if (isAllTools && tsResult.unknown.length === 0) {
         // Default: byte-identical to main.
@@ -5708,7 +5711,7 @@ async function main() {
         serverInstructions = `${BASE_INSTRUCTIONS} ${parts.join(" ")}`;
     }
     const server = new Server({ name: SERVER_NAME, version: SERVER_VERSION }, {
-        capabilities: { tools: {} },
+        capabilities: { tools: {}, resources: {} },
         // Surfaced to the agent at initialize. Tells it how to route real-usage
         // friction back to the project WITHOUT the server ever posting anything.
         instructions: serverInstructions,
@@ -5723,6 +5726,38 @@ async function main() {
             })),
         };
     });
+    // ── MCP Resources: state & local data map ──────────────────────────────
+    const DATA_MAP_URI = "samgov://data-map/state-local";
+    const DATA_MAP_NAME = "State & local data map";
+    const DATA_MAP_DESCRIPTION = "Jurisdiction → verified tool call → row count for every allowlisted state/local Socrata, CKAN, Tableau and Open Checkbook dataset.";
+    server.setRequestHandler(ListResourcesRequestSchema, async () => {
+        return {
+            resources: [
+                {
+                    uri: DATA_MAP_URI,
+                    name: DATA_MAP_NAME,
+                    description: DATA_MAP_DESCRIPTION,
+                    mimeType: "text/markdown",
+                },
+            ],
+        };
+    });
+    server.setRequestHandler(ReadResourceRequestSchema, async (req) => {
+        const { uri } = req.params;
+        if (uri !== DATA_MAP_URI) {
+            throw new Error(`Unknown resource: ${uri}`);
+        }
+        return {
+            contents: [
+                {
+                    uri: DATA_MAP_URI,
+                    mimeType: "text/markdown",
+                    text: renderDataMapMarkdown(),
+                },
+            ],
+        };
+    });
+    // ── end MCP Resources ──────────────────────────────────────────────────
     server.setRequestHandler(CallToolRequestSchema, async (req) => {
         const { name, arguments: args } = req.params;
         // Check if the tool exists but is not loaded in the current toolset profile.