US Federal Awards Monitor (USASpending + NAICS Auto-Fix)

US Federal Contract & Grant Awards Monitor (USASpending + NAICS Auto-Fix)

A high-performance B2B GovCon intelligence Actor and Model Context Protocol (MCP) server that monitors US federal contract awards, delivery orders, and grants directly from USASpending.gov with automated NAICS code cross-expansion and deduplication.

---

⚡ The GovCon Problem: The NAICS 511210 / 513210 Blind Spot

In 2022, the federal government officially revised the North American Industry Classification System (NAICS), retiring NAICS 511210 (Software Publishers) and reclassifying commercial software under NAICS 513210 (Software Publishers).

However, thousands of active solicitations, Indefinite Delivery Vehicles (IDVs), BPA Calls, and agency contracting offices (DoD, VA, HHS, DHS, DoE) continue to issue modifications and new awards under legacy code 511210.

Contractors searching only for 513210 miss up to 40% of relevant software awards and subcontracting opportunities.

US Federal Awards Monitor solves this automatically:

• Querying 513210 automatically expands to search 511210.
• Querying 511210 automatically expands to search 513210.
• Software vendors, defense contractors, and capture teams never miss a prime or sub award.

---

🚀 Key Use Cases

1. GovCon Capture & BD Teams: Track award announcements within hours of obligation across target agencies (e.g., DoD, Army, Navy, Air Force, HHS, VA).
2. Competitor Intelligence: Monitor incumbent vendors, contract ceilings, obligated dollar amounts, and period-of-performance end dates for recompete targeting.
3. Subcontracting & Teaming: Identify prime awardees winning large definitive contracts and delivery orders to pitch teaming arrangements or subcontracting capabilities.
4. AI-Powered Procurement Assistants: Connect your AI agents (Claude, Cursor, ChatGPT, Antigravity) via MCP to answer real-time questions like "What cloud software contracts were awarded by the Air Force this month?"

---

🔌 Model Context Protocol (MCP) Integration

This Actor runs in Standby Mode as a streamable HTTP MCP server, enabling AI agents to query live federal spending without batch polling.

Connect to Any MCP Client

Add the following MCP endpoint to your client configuration:

https://mcp.apify.com/?tools=capitalist_developer/us-federal-awards-and-naics-monitor

Claude Desktop Configuration (claude_desktop_config.json)

{
  "mcpServers": {
    "us-federal-awards": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-fetch",
        "https://mcp.apify.com/?tools=capitalist_developer/us-federal-awards-and-naics-monitor"
      ]
    }
  }
}

Antigravity & Cursor Configuration

{
  "mcpServers": {
    "us-federal-awards": {
      "url": "https://mcp.apify.com/?tools=capitalist_developer/us-federal-awards-and-naics-monitor",
      "type": "sse"
    }
  }
}

---

📊 Sample Output Record

Each award record is flattened, cleaned, and standardized:

{
  "awardId": "FA880623C0002",
  "recipientName": "PALANTIR USG INC",
  "awardAmount": 130042463,
  "awardingAgency": "Department of Defense",
  "awardingSubAgency": "Department of the Air Force",
  "naicsCode": "513210",
  "startDate": "2023-06-16",
  "endDate": "2025-06-15",
  "description": "ESTABLISH BASIC LETTER CONTRACT FOR COMMERCIAL DATA AS A SERVE PLATFORM.",
  "awardType": "Contract",
  "sourceUrl": "https://www.usaspending.gov/award/CONT_AWD_FA880623C0002_9700_-NONE-_-NONE-"
}

---

⚙️ Input Parameters

Parameter	Type	Default	Description
keywords	Array of strings	[]	Keywords to match against award descriptions (e.g. ["cloud", "AI", "cyber"]).
naicsCodes	Array of strings	[]	NAICS industry classification codes (e.g. ["513210"]).
autoExpandLegacySoftwareNaics	Boolean	true	Automatically cross-expands 513210 <-> 511210 to capture legacy awards.
agencyNames	Array of strings	[]	Filter by top-tier agency or sub-agency (e.g. ["Department of Defense", "NASA"]).
awardTypes	Array of strings	["A","B","C","D"]	Award types: A (BPA Call), B (Purchase Order), C (Delivery Order), D (Definitive Contract).
minAmountUsd	Number	null	Minimum obligated award dollar amount threshold.
daysBack	Integer	30	Lookback window in days for period of performance / award date.
onlyNewSinceLastRun	Boolean	false	When true, deduplicates against previous runs via a named Key-Value store.
maxItems	Integer	100	Maximum number of awards to fetch and store.

---

🛠️ Architecture & Reliability

• Direct USASpending v2 API Ingestion: No intermediate scrapers or brittle DOM parsing. Direct JSON endpoints with official US Treasury schema compliance.
• Resilient Retry Mechanism: 3-retry exponential backoff handles upstream 429 rate-limits or temporary 5xx outages gracefully.
• Pay-Per-Event Friendly: Emits standard charging events (mcp-lookup and award-record) and respects platform charging limits.
• Lightweight & Efficient: Zero browser/Playwright dependencies; runs within 256MB–512MB RAM on Node.js 20 ESM.

---

📧 Support & Author

• Author: Harsh (harsh-maker96)
• Contact: Harsh9575286717@gmail.com
• Repository: harsh-maker96/us-federal-awards-and-naics-monitor