README.md
AI-powered federal procurement intelligence via the Model Context Protocol
EzBiz Government Contracting MCP Server
AI-powered federal procurement intelligence via the Model Context Protocol (MCP). Give your AI assistant the ability to search federal contracts, analyze agency spending, track competitor wins, and monitor small business set-aside opportunities — all using SAM.gov, USASpending.gov, and FPDS data.
Tools
| Tool | Description |
|---|---|
search_contracts |
Search federal contract opportunities on SAM.gov — filter by NAICS code, set-aside type, agency, dollar range, and keywords. Returns active solicitations with due dates, contact info, and bid requirements. |
analyze_agency |
Analyze a federal agency's spending patterns and contracting behavior — top contractors, spending trends, preferred NAICS codes, contract types, and upcoming opportunities. Uses USASpending.gov data. |
competitor_win_analysis |
Analyze a competitor's federal contract wins — awarded contracts, agencies they work with, contract values, NAICS codes, and win patterns. Find out who's winning in your space. |
set_aside_tracker |
Track small business set-aside opportunities across federal agencies — 8(a), HUBZone, SDVOSB, WOSB, and SBA set-asides. Shows trending categories, upcoming deadlines, and agency set-aside spending patterns. |
Quick Start (Hosted)
No installation required. Use the hosted version:
- Get a free API key at govcon.ezbizservices.com/signup
- Add to your MCP client config (Claude Desktop, Cursor, etc.):
{
"mcpServers": {
"ezbiz-govcon": {
"url": "https://govcon.ezbizservices.com/mcp",
"headers": {
"x-api-key": "YOUR_API_KEY"
}
}
}
}
- Ask your AI assistant to research federal contracts!
Example Prompts
- "Search for IT services contracts at the Department of Defense"
- "Analyze the Department of Veterans Affairs spending patterns"
- "What contracts has [Competitor Name] won in the last year?"
- "Show me HUBZone set-aside opportunities in NAICS 541512"
Self-Hosting
git clone https://github.com/ezbiz-services/mcp-govcon.git
cd mcp-govcon
bun install
cp .env.example .env
# Edit .env with your OpenAI API key and admin secret
bun run server.ts
Environment Variables
| Variable | Required | Description |
|---|---|---|
OPENAI_API_KEY |
Yes | OpenAI API key for AI-powered analysis |
ADMIN_SECRET |
Yes | Secret for admin API endpoints |
MCP_PORT |
No | Server port (default: 4203) |
Pricing
| Tier | Price | Requests/Month |
|---|---|---|
| Free | $0 | 10 |
| Starter | $19/mo | 200 |
| Pro | $49/mo | 1,000 |
| Business | $99/mo | 5,000 |
Start free at govcon.ezbizservices.com
Architecture
- Runtime: Bun
- Protocol: MCP SDK (Streamable HTTP transport)
- AI: OpenAI GPT-4o for analysis
- Data Sources: SAM.gov, USASpending.gov, FPDS
- Auth: API key-based with tiered rate limiting
Links
- Homepage: govcon.ezbizservices.com
- API Docs: govcon.ezbizservices.com/docs
- Sign Up: govcon.ezbizservices.com/signup
- GitHub: github.com/ezbiz-services/mcp-govcon
License
MIT — see LICENSE
Tools (4)
search_contractsSearch federal contract opportunities on SAM.gov with filters for NAICS code, set-aside type, agency, and dollar range.analyze_agencyAnalyze a federal agency's spending patterns, top contractors, and preferred NAICS codes using USASpending.gov data.competitor_win_analysisAnalyze a competitor's federal contract wins including awarded contracts, agencies, and win patterns.set_aside_trackerTrack small business set-aside opportunities across federal agencies including 8(a), HUBZone, SDVOSB, and WOSB.Environment Variables
OPENAI_API_KEYrequiredOpenAI API key for AI-powered analysisADMIN_SECRETrequiredSecret for admin API endpointsMCP_PORTServer port (default: 4203)Configuration
claude_desktop_config.json
{"mcpServers": {"ezbiz-govcon": {"url": "https://govcon.ezbizservices.com/mcp", "headers": {"x-api-key": "YOUR_API_KEY"}}}}Try it
→Search for IT services contracts at the Department of Defense
→Analyze the Department of Veterans Affairs spending patterns
→What contracts has [Competitor Name] won in the last year?
→Show me HUBZone set-aside opportunities in NAICS 541512