@cliwant/mcp-sam-gov 1.7.0 → 1.9.0

package/src/server.ts

@@ -102,7 +102,7 @@ import { realpathSync } from "node:fs";
 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.7.0";
+const SERVER_VERSION = "1.9.0";
 
 // ─── Tool input schemas (Zod) ────────────────────────────────────
 
@@ -572,6 +572,22 @@ const EcfrSearchInput = z.object({
 
 const EcfrListTitlesInput = z.object({});
 
+const EcfrGetSectionInput = z.object({
+  titleNumber: z
+    .number()
+    .int()
+    .min(1)
+    .max(50)
+    .describe("CFR title (1–50). e.g. 2 = federal financial assistance (grants), 29 = Labor, 26 = IRS. For FAR/DFARS (title 48) prefer far_clause_lookup."),
+  section: z
+    .string()
+    .describe("The section citation, e.g. '200.1' (2 CFR 200.1) or '52.204-21' — the part number is the pre-dot integer. Charclass-validated (^[0-9]{1,3}\\.[0-9]{1,4}(-[0-9]{1,4})?$)."),
+  date: z
+    .string()
+    .optional()
+    .describe("Optional eCFR issue date YYYY-MM-DD; omit to use the title's LATEST issue (disclosed in _meta)."),
+});
+
 // FAR / DFARS clause lookup (eCFR versioner full endpoint)
 const FarClauseLookupInput = z.object({
   clauseNumber: z
@@ -5381,14 +5397,21 @@ export const TOOLS: ToolDef[] = [
     handler: (input) => fedreg.publicInspection(input),
   }),
 
-  // ━━━ eCFR (5) ━━━
+  // ━━━ eCFR (6) ━━━
   defineTool({
     name: "ecfr_search",
     description:
-      "Full-text search across the entire CFR (Code of Federal Regulations). Use for compliance questions — pass titleNumber=48 for FAR (Federal Acquisition Regulation), titleNumber=2 for federal financial assistance, etc. Returns excerpt + section path + ecfrUrl.",
+      "Full-text search across the entire CFR (Code of Federal Regulations). Use for DISCOVERY — pass titleNumber=48 for FAR (Federal Acquisition Regulation), titleNumber=2 for federal financial assistance, etc. Returns a ranked EXCERPT (snippet, not full text) + section path + ecfrUrl per hit. To then read the COMPLETE text of a hit: for a FAR/DFARS clause (title 48) use far_clause_lookup (adds prescription + revision); for any other title's section use ecfr_get_section; or open the ecfrUrl.",
     inputSchema: EcfrSearchInput,
     handler: (input) => ecfr.search(input),
   }),
+  defineTool({
+    name: "ecfr_get_section",
+    description:
+      "Get the FULL in-force text of ONE CFR section by citation (the companion to ecfr_search, which returns only snippets). Input titleNumber (1–50) + section (e.g. '200.1' → 2 CFR 200.1, uniform grants guidance; '1601.1' → 29 CFR labor) + optional issue date (default = the title's latest). Returns { citation, alternateReference, heading, fullText, issueDate, ecfrUrl }. ★For a FAR/DFARS clause (title 48) prefer far_clause_lookup — it adds the prescription, revision, and FAR-overhaul-risk this generic tool does not; use ecfr_get_section for the OTHER 49 titles (grants/labor/IRS/SBA/…). HONESTY: text is the eCFR's own, de-XMLed (no fabrication); a nonexistent section ⇒ not_found (never a fake/wrong section); the resolved issue date is disclosed (the title's latest is a moving target); a bad section format ⇒ invalid_input (SSRF charclass); an outage ⇒ throws. Keyless.",
+    inputSchema: EcfrGetSectionInput,
+    handler: (input) => ecfr.getSection(input),
+  }),
   defineTool({
     name: "ecfr_list_titles",
     description:

package/src/socrata.ts

@@ -130,6 +130,15 @@ export const SOCRATA_DOMAINS = [
   "data.pa.gov", // PA — e.g. mcba-yywm
   "data.mo.gov", // MO — e.g. gfq7-aa86
   "data.delaware.gov", // DE — e.g. 5zy2-grhr
+  // ── SLED city/county tier (loop cycle 1, 2026-07-18; host-scoped catalog +
+  //    /resource/<4x4>.json 200 bare-array live-verified; all .gov; B2G
+  //    procurement/vendor/contract data — the fragmented local layer above the
+  //    state portals). ─────────────────────────────────────────────────────
+  "data.austintexas.gov", // Austin TX (city) — e.g. 3ebq-e9iz (Purchase Orders)
+  "data.kingcounty.gov", // King County WA — e.g. dqit-zt74 (Procurement Contracts)
+  "data.montgomerycountymd.gov", // Montgomery County MD — e.g. vmu2-pnrc (Contracts)
+  "data.mesaaz.gov", // Mesa AZ (city) — e.g. j7s9-qiuq (Vendor Payments)
+  "data.cambridgema.gov", // Cambridge MA (city) — e.g. gp98-ja4f (Contracts bid list)
   "opendata.usac.org", // USAC E-rate (.org, m6) — e.g. avi8-svp9
 ] as const;
 

package/src/usaspending.ts

@@ -2112,6 +2112,11 @@ export async function getAgencyProfile(toptierCode: string) {
     website: json.website,
     subtierAgencyCount: json.subtier_agency_count,
     congressionalJustificationUrl: json.congressional_justification_url,
+    // #4 (agent-eval 2026-07-18): this endpoint carries NO spending total, and an
+    // agent asked "how much did agency X obligate?" dead-ends here. Point it to
+    // where obligations actually live (account-level vs award-level vs contracts).
+    spendingNote:
+      "This profile has NO obligation/spending figure. For this agency's obligations use: usas_get_agency_awards_summary(toptierCode) = AWARD-level obligations for a fiscal year; usas_list_toptier_agencies → this agency's `obligatedAmount` = ACCOUNT-level total (all spending, higher than award-level). For CONTRACTS-only, usas_spending_over_time / usas_search_*_spending by the agency's canonical name.",
   };
 }
 
@@ -2169,6 +2174,7 @@ export async function getAgencyAwardsSummary(args: {
     filtersApplied: ["toptierCode", "fiscalYear"],
     notes: [
       "SCOPE: `obligations` and `transactionCount` cover ALL award types (contracts, grants, direct payments incl. benefits, loans) for this agency — NOT prime contracts only. For a benefit-heavy agency (VA/SSA/HHS) direct benefit payments DOMINATE this figure (VA FY2024: ~$238B all-awards vs ~$67B prime contract awards A/B/C/D); for a procurement-heavy agency (DoD/DHS) obligations closely tracks contract spending. For the CONTRACTS-only obligation use usas_spending_over_time (contractObligations) or usas_search_*_spending — those filter by the agency's canonical NAME, so first resolve it from this toptierCode via usas_get_agency_profile (→ name).",
+      "LEVEL: this is AWARD-level obligations (award transactions). It is LOWER than the agency's ACCOUNT-LEVEL total in usas_list_toptier_agencies.obligatedAmount, which counts ALL obligations, not just awards (e.g. VA ~$205B award-level here vs ~$298B account-level there) — pick the one your question means.",
     ],
   });
 }
@@ -2842,7 +2848,9 @@ export async function listToptierAgencies(args: { limit?: number }) {
         totalAvailable: results.length,
         limitHonored: false,
         extraNotes: [
-          "The toptier_agencies endpoint returns the COMPLETE list of ~111 toptier agencies regardless of the `limit` value (limit is ignored upstream).",
+          "The toptier_agencies endpoint returns the COMPLETE list of ~111 toptier agencies regardless of the `limit` value (limit is ignored upstream) — the returned count IS the total.",
+          "The list is ordered ALPHABETICALLY by name, NOT by spending — for 'top N agencies by obligation', sort the returned rows by obligatedAmount client-side (there is no server-side ranking).",
+          "`obligatedAmount` is each agency's ACCOUNT-LEVEL total obligations for its active fiscal year (ALL spending). This is HIGHER than usas_get_agency_awards_summary.obligations, which counts AWARD transactions only (e.g. VA ~$298B account-level vs ~$205B award-level) — do not conflate the two.",
         ],
       }),
       // P5 provenance — threaded ONLY when NON-live ⇒ live stays byte-identical.