MCP Server

MacTech Federal Market

com.mactechsolutionsllc.www/federal-market
Business & Operations Search & Research Public & reachable MCP 2025-11-25

What this MCP does

Searches SAM.gov contract opportunities, federal awards, agencies, entities, NAICS codes, and aggregated government spending.

find_agency
Find a federal agency by name
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.
Read only Open world Idempotent
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['query'], 'properties': {'query': {'type': 'string', 'description': 'Agency name fragment, e.g. "navy" or "DISA"'}}}
find_naics
Find NAICS codes
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.
Read only Open world Idempotent
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['query'], 'properties': {'query': {'type': 'string', 'description': 'Industry description ("cybersecurity services") or a NAICS code ("541512")'}}}
get_award
Get one federal award (USASpending)
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.
Read only Open world Idempotent
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['award_id'], 'properties': {'award_id': {'type': 'string', 'description': 'generated_internal_id / generated_unique_award_id from search_awards'}}}
lookup_entity
Look up a SAM.gov registered entity
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.
Read only Open world Idempotent
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'uei': {'type': 'string', 'description': '12-character Unique Entity ID'}, 'name': {'type': 'string', 'description': 'Legal business name (partial match allowed) - used when no UEI given'}, 'sam_api_key': {'type': 'string', 'description': 'Optional: your own free SAM.gov API key (from sam.gov â\x86\x92 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.'}}}
search_awards
Search federal contract awards (USASpending)
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.
Read only Open world Idempotent
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'limit': {'type': 'integer', 'maximum': 25, 'minimum': 1, 'description': 'Max results (default 10)'}, 'end_date': {'type': 'string', 'description': 'YYYY-MM-DD (default: today)'}, 'keywords': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Keyword filters'}, 'psc_codes': {'type': 'array', 'items': {'type': 'string'}}, 'recipient': {'type': 'string', 'description': 'Recipient (contractor) name search'}, 'max_amount': {'type': 'number'}, 'min_amount': {'type': 'number'}, 'start_date': {'type': 'string', 'description': 'YYYY-MM-DD (default: 1 year ago)'}, 'agency_name': {'type': 'string', 'description': 'Awarding toptier agency name, e.g. "Department of Defense"'}, 'naics_codes': {'type': 'array', 'items': {'type': 'string'}}}}
search_opportunities
Search SAM.gov contract opportunities
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.
Read only Open world Idempotent
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'limit': {'type': 'integer', 'maximum': 25, 'minimum': 1, 'description': 'Max results (default 10)'}, 'agency': {'type': 'string', 'description': 'Department/agency name filter'}, 'keywords': {'type': 'string', 'description': 'Free-text keywords, e.g. "CMMC compliance"'}, 'posted_to': {'type': 'string', 'description': 'YYYY-MM-DD (default: today)'}, 'set_aside': {'type': 'array', 'items': {'enum': ['SDVOSBC', 'SDVOSBS', 'VSA', 'VSS', 'SBA', 'SBP', '8A', '8AN', 'HZC', 'HZS', 'WOSB', 'EDWOSB'], 'type': 'string'}, 'description': 'Set-aside codes: SDVOSBC/SDVOSBS (SDVOSB), VSA/VSS (VOSB), SBA/SBP (small business), 8A/8AN, HZC/HZS (HUBZone), WOSB/EDWOSB'}, 'naics_codes': {'type': 'array', 'items': {'type': 'string'}, 'description': 'NAICS codes, e.g. ["541512"]'}, 'notice_type': {'type': 'array', 'items': {'enum': ['o', 'p', 'r', 'k', 'g', 's', 'a', 'i', 'u'], 'type': 'string'}, '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'}, 'posted_from': {'type': 'string', 'description': 'YYYY-MM-DD (default: 90 days ago; SAM allows at most a 1-year window)'}, 'sam_api_key': {'type': 'string', 'description': 'Optional: your own free SAM.gov API key (from sam.gov â\x86\x92 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.'}}}
spending_by_category
Federal spending rollups
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.
Read only Open world Idempotent
Input schema
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['category'], 'properties': {'limit': {'type': 'integer', 'maximum': 20, 'minimum': 1, 'description': 'Top N (default 10)'}, 'category': {'enum': ['naics', 'psc', 'recipient', 'awarding_agency'], 'type': 'string'}, 'end_date': {'type': 'string', 'description': 'YYYY-MM-DD (default: today)'}, 'keywords': {'type': 'array', 'items': {'type': 'string'}}, 'start_date': {'type': 'string', 'description': 'YYYY-MM-DD (default: 1 year ago)'}, 'agency_name': {'type': 'string'}, 'naics_codes': {'type': 'array', 'items': {'type': 'string'}}}}
Added
spending_by_category
Sept. 17, 2026, 12:36 p.m.
Added
find_naics
Sept. 17, 2026, 12:36 p.m.
Added
find_agency
Sept. 17, 2026, 12:36 p.m.
Added
get_award
Sept. 17, 2026, 12:36 p.m.
Added
search_awards
Sept. 17, 2026, 12:36 p.m.
Added
lookup_entity
Sept. 17, 2026, 12:36 p.m.
Added
search_opportunities
Sept. 17, 2026, 12:36 p.m.