search_contractsLABSCO SUMMARY
Bid or no-bid, before the deadline eats the decision.
Finding federal work is spread across three government systems that each answer a different part of the question. Asking one place — what is open, who usually wins it, what the agency actually buys — is what changes the pace of it.
What it is
A self-hosted MCP server for federal procurement research. Four tools reading SAM.gov, USASpending.gov and FPDS data.
What you get
- Federal contract opportunities searched on SAM.gov by NAICS code, set-aside type, agency, dollar range and keyword — returned with due dates, contact information and bid requirements
- A federal agency's spending analysed: top contractors, spending trends, preferred NAICS codes, contract types and upcoming opportunities
- A competitor's federal wins analysed — awarded contracts, the agencies they work with, contract values, NAICS codes and win patterns
- Small business set-asides tracked across agencies — 8(a), HUBZone, SDVOSB, WOSB and SBA — with trending categories, upcoming deadlines and agency set-aside spending
Requirements
Clone the repo and run it with Bun; its .env wants your own OpenAI API key and an admin secret. The server mints its own API keys through /api/keys/provision, and the key goes in an x-api-key header to http://localhost:4203/mcp.
Setup effort
Build from source — git clone https://github.com/ezbiz-services/mcp-govcon.git
USE CASES
01
Finding work you can actually bid on
Search SAM.gov by your NAICS code and set-aside type, and read the due dates before anything else.
02
Deciding whether an agency is worth pursuing
Analyse its spending — who it buys from, what it buys, and how that has trended.
03
Working out who you are up against
Analyse a competitor's wins: which agencies, which NAICS codes, what values.
04
Playing the set-aside advantage properly
Track 8(a), HUBZone, SDVOSB and WOSB activity for trending categories and upcoming deadlines.
05
Building a capture plan for one agency
Search its open solicitations, read its spending patterns, and check who has been winning there.
4 tools
Listed in project docs. Your client may show a different list.
analyze_agencycompetitor_win_analysisset_aside_trackerBEFORE YOU INSTALL
What to know first
Tools you get
4 tools named in the project's documentation.
Requires
- Bun
- An OpenAI API key
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
This one is built from source rather than installed with a single command.
Server setup
TERMINAL
git clone https://github.com/ezbiz-services/mcp-govcon.git
cd mcp-govcon
bun install
cp .env.example .envSet OPENAI_API_KEY and ADMIN_SECRET in .env
TERMINAL
bun run server.tsLeave the server running. In a second terminal, mint an API key with your ADMIN_SECRET — the key in the response goes in the x-api-key header of the client entry below:
TERMINAL
curl -X POST http://localhost:4203/api/keys/provision -H "x-admin-secret: <YOUR_ADMIN_SECRET>" -H "Content-Type: application/json" -d '{"email":"<YOUR_EMAIL>","tier":"business"}'MCP Clients
Cursor
CURSOR · JSON
{
"mcpServers": {
"ezbiz-govcon": {
"url": "http://localhost:4203/mcp",
"headers": {
"x-api-key": "<YOUR_API_KEY>"
}
}
}
}
