MacTech Federal Market

Search active federal contract opportunities on SAM.gov: solicitations, presolicitations, sources sought, RFIs, and award notices - filterable by keywords, NAICS, set-aside (SDVOSB, 8(a), HUBZone, WOSB, small business), notice type, agency, and posted-date range (max 1 year). Call this when the user wants to find federal bidding opportunities or market intelligence on what agencies are buying. Uses a shared daily budget unless the caller supplies their own free SAM.gov key.

{
  "type": "object",
  "properties": {
    "keywords": {
      "description": "Free-text keywords, e.g. \"CMMC compliance\"",
      "type": "string"
    },
    "naics_codes": {
      "description": "NAICS codes, e.g. [\"541512\"]",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "set_aside": {
      "description": "Set-aside codes: SDVOSBC/SDVOSBS (SDVOSB), VSA/VSS (VOSB), SBA/SBP (small business), 8A/8AN, HZC/HZS (HUBZone), WOSB/EDWOSB",
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "SDVOSBC",
          "SDVOSBS",
          "VSA",
          "VSS",
          "SBA",
          "SBP",
          "8A",
          "8AN",
          "HZC",
          "HZS",
          "WOSB",
          "EDWOSB"
        ]
      }
    },
    "notice_type": {
      "description": "o=solicitation, p=presolicitation, r=sources sought, k=combined synopsis, g=surplus, s=special notice, a=award notice, i=intent to bundle, u=J&A",
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "o",
          "p",
          "r",
          "k",
          "g",
          "s",
          "a",
          "i",
          "u"
        ]
      }
    },
    "agency": {
      "description": "Department/agency name filter",
      "type": "string"
    },
    "posted_from": {
      "description": "YYYY-MM-DD (default: 90 days ago; SAM allows at most a 1-year window)",
      "type": "string"
    },
    "posted_to": {
      "description": "YYYY-MM-DD (default: today)",
      "type": "string"
    },
    "limit": {
      "description": "Max results (default 10)",
      "type": "integer",
      "minimum": 1,
      "maximum": 25
    },
    "sam_api_key": {
      "description": "Optional: your own free SAM.gov API key (from sam.gov → Account Details). With it you spend your own 1,000/day quota and skip the shared budget. Can also be sent once as the X-Sam-Api-Key header on the MCP connection.",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Look up a federal contractor registration in SAM.gov by Unique Entity ID (UEI) or legal business name: registration status, CAGE code, physical address, business types (SDVOSB, 8(a), HUBZone, etc.), and NAICS codes. Call this to vet a teaming partner, check a competitor, or confirm an entity is award-eligible. Public registration sections only.

{
  "type": "object",
  "properties": {
    "uei": {
      "description": "12-character Unique Entity ID",
      "type": "string"
    },
    "name": {
      "description": "Legal business name (partial match allowed) - used when no UEI given",
      "type": "string"
    },
    "sam_api_key": {
      "description": "Optional: your own free SAM.gov API key (from sam.gov → Account Details). With it you spend your own 1,000/day quota and skip the shared budget. Can also be sent once as the X-Sam-Api-Key header on the MCP connection.",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Search actual federal contract awards on USAspending.gov - who won what, from which agency, for how much. Filter by keywords, NAICS, PSC, recipient name, agency, date range, and award amount. Keyless and unlimited. Call this for competitive intelligence ("who holds contracts in this space"), incumbent research, or agency spending patterns.

{
  "type": "object",
  "properties": {
    "keywords": {
      "description": "Keyword filters",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "naics_codes": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "psc_codes": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "recipient": {
      "description": "Recipient (contractor) name search",
      "type": "string"
    },
    "agency_name": {
      "description": "Awarding toptier agency name, e.g. \"Department of Defense\"",
      "type": "string"
    },
    "start_date": {
      "description": "YYYY-MM-DD (default: 1 year ago)",
      "type": "string"
    },
    "end_date": {
      "description": "YYYY-MM-DD (default: today)",
      "type": "string"
    },
    "min_amount": {
      "type": "number"
    },
    "max_amount": {
      "type": "number"
    },
    "limit": {
      "description": "Max results (default 10)",
      "type": "integer",
      "minimum": 1,
      "maximum": 25
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Get full detail for one federal award from USAspending.gov by its generated award id (from search_awards results, e.g. "CONT_AWD_...") - description, obligations, period of performance, awarding/funding agencies, recipient, and place of performance. Keyless.

{
  "type": "object",
  "properties": {
    "award_id": {
      "type": "string",
      "description": "generated_internal_id / generated_unique_award_id from search_awards"
    }
  },
  "required": [
    "award_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Resolve a federal agency name fragment to its official awarding-agency names (toptier and subtier) as USAspending knows them - use before search_awards or spending_by_category when unsure of the exact agency name. Keyless.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Agency name fragment, e.g. \"navy\" or \"DISA\""
    }
  },
  "required": [
    "query"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Resolve an industry description to NAICS codes (or look up what a NAICS code means). Use before search_opportunities/search_awards to get the right code. Keyless.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Industry description (\"cybersecurity services\") or a NAICS code (\"541512\")"
    }
  },
  "required": [
    "query"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Aggregate federal contract spending by NAICS, PSC, recipient, or awarding agency over a date range, optionally filtered by keywords/NAICS/agency - market sizing in one call ("top contractors in NAICS 541512 last year", "which agencies buy the most cybersecurity"). Keyless.

{
  "type": "object",
  "properties": {
    "category": {
      "type": "string",
      "enum": [
        "naics",
        "psc",
        "recipient",
        "awarding_agency"
      ]
    },
    "keywords": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "naics_codes": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "agency_name": {
      "type": "string"
    },
    "start_date": {
      "description": "YYYY-MM-DD (default: 1 year ago)",
      "type": "string"
    },
    "end_date": {
      "description": "YYYY-MM-DD (default: today)",
      "type": "string"
    },
    "limit": {
      "description": "Top N (default 10)",
      "type": "integer",
      "minimum": 1,
      "maximum": 20
    }
  },
  "required": [
    "category"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}