Server data from the Official MCP Registry
Search SAM.gov federal contract opportunities by NAICS, PSC, set-aside, agency, state and date.
About
Search SAM.gov federal contract opportunities by NAICS, PSC, set-aside, agency, state and date.
Security Report
Valid MCP server (1 strong, 3 medium validity signals). 4 known CVEs in dependencies Package registry verified. Imported from the Official MCP Registry.
6 files analyzed · 5 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
Permissions Required
This plugin requests these system permissions. Most are normal for its category.
What You'll Need
Set these up before or after installing:
Environment variable: APIFY_TOKEN
Environment variable: SAMGOV_MAX_CHARGE_USD
Environment variable: SAMGOV_ACTOR_BUILD
How to Install
Add this to your MCP configuration file:
{
"mcpServers": {
"samgov-opportunities-mcp": {
"command": "uvx",
"args": [
"samgov-opportunities-mcp==0.2.1"
],
"env": {
"APIFY_TOKEN": "your-apify-token-here",
"SAMGOV_ACTOR_BUILD": "your-samgov-actor-build-here",
"SAMGOV_MAX_CHARGE_USD": "your-samgov-max-charge-usd-here"
}
}
}
}Some servers take additional arguments. See the repository for details.
Documentation
View on GitHubFrom the project's GitHub README.
SAM.gov Opportunities MCP server
This MCP server lets an AI assistant (Claude Desktop, Cursor, VS Code, Claude Code or any other MCP client) search U.S. federal contract opportunities on SAM.gov: solicitations, sources sought, presolicitations and award notices.
Each call runs the Apify actor cleandatalabs/samgov-opportunities under your own Apify token. You don't need a SAM.gov API key and there is no 10-requests-per-day limit.
Not a developer? If you'd rather have a person watch a SAM.gov search for you, Clean Data Labs offers a free hand-checked sample: one search, the last 7 days, up to 10 notices.
Tools
| Tool | What it does |
|---|---|
search_opportunities | Searches active notices, newest first. Filters: keywords, naics_codes, psc_codes (both accept prefixes, e.g. 2362 or Z2), set_asides (SBA, 8A, HZC, SDVOSBC, WOSB, EDWOSB and others), agencies (by name), states (place of performance), notice_types, posted_since (YYYY-MM-DD, posted or updated on or after that date; default is the last 7 days), deadline_within_days, open_for_response_only, max_results (default 25, max 200) and detail (compact or full). |
get_opportunity | Fetches one notice by notice ID, sam.gov/opp/... URL or solicitation number. A solicitation number returns all of its notices, including the award (winner, UEI, amount). |
what_changed_since_last_check | Monitor mode: give a stable monitor_id plus the same filters each time and get only notices that are new or changed since the previous call, each with change_type (new, amended, deadline_changed, amount_changed, awarded, canceled, notice_type_changed, updated), changed_fields, plain-English change_summary, structured text_diff (title, description passages, attachments, deadline/amount/etc.) and previous values (previous_response_deadline, previous_award_amount_usd, previous_notice_id). Unchanged notices are free. The first call defaults to a free baseline. |
Compact rows include the notice ID, title, solicitation number, type, department, agency and office, posted and deadline dates, NAICS, PSC, set-aside, place of performance, primary contact, attachment count, award fields (amount, date, awardee name, UEI, CAGE, award number), monitor change fields (change_type, changed_fields, change_summary, text_diff, previous values), optional attachment_archive / attachments_archived when the actor archived files, and the SAM.gov link. detail: "full" adds the description, all contacts and attachment links.
search_opportunities and get_opportunity are read-only. what_changed_since_last_check stores its memory (a samgov-monitor-state key-value record) in your own Apify account.
Cost
The actor charges $0.003 per returned notice (25 results cost $0.075), billed to the Apify account that owns the token. Apify's free plan includes $5 of monthly credit. Each tool call carries a spending cap: the lower of max_results × $0.003 and SAMGOV_MAX_CHARGE_USD (default $0.30). Each result reports estimated_cost_usd.
Install
You need uv (for uvx), or Python 3.10+ with pip, and an Apify API token from Console > Settings > API & Integrations.
Claude Desktop / Cursor / any client with an mcpServers config
{
"mcpServers": {
"samgov": {
"command": "uvx",
"args": ["samgov-opportunities-mcp"],
"env": { "APIFY_TOKEN": "apify_api_..." }
}
}
}
Claude Code
claude mcp add samgov --env APIFY_TOKEN=apify_api_... -- uvx samgov-opportunities-mcp
VS Code (.vscode/mcp.json)
{
"inputs": [{ "type": "promptString", "id": "apify-token", "description": "Apify API token", "password": true }],
"servers": {
"samgov": { "type": "stdio", "command": "uvx", "args": ["samgov-opportunities-mcp"],
"env": { "APIFY_TOKEN": "${input:apify-token}" } }
}
}
From source
git clone https://github.com/clean-data-labs-org/samgov-opportunities-mcp && cd samgov-opportunities-mcp
pip install -e .
APIFY_TOKEN=apify_api_... samgov-opportunities-mcp # speaks MCP over stdio
Configuration
| Env var | Default | Meaning |
|---|---|---|
APIFY_TOKEN | (required) | Your Apify API token. Runs are billed to this account. |
SAMGOV_MAX_CHARGE_USD | 0.30 | Spending cap per tool call. |
SAMGOV_ACTOR_BUILD | latest | Actor build tag or number to run. latest is actor 0.3.7 (monitor change_summary/text_diff, opt-in downloadAttachments → attachment_archive). Leave unset so the default latest is used. get_opportunity needs 0.3+, what_changed_since_last_check needs 0.3.4+. |
Actor 0.3.7 (on latest): monitor rows include change_summary and text_diff, and every row carries set_aside / set_aside_description. Attachment archiving is opt-in on the actor via downloadAttachments: true (files land in a persistent KV store with sha256 dedupe; rows get attachment_archive[] / attachments_archived). This MCP package does not yet expose a download_attachments tool flag; set it only if you call the actor directly.
Example prompts
- "Find small-business set-aside janitorial contracts in Colorado posted this week."
- "Any VA construction solicitations under NAICS 2362 due in the next 30 days?"
- "Who won solicitation FA813226Q0061, and for how much?"
- "What changed since last check in my construction-co watch (NAICS 236220, Colorado)?"
- "Show me HUBZone IT services opportunities (NAICS 5415) from the Army since 2026-11-01."
No-install alternative: Apify's hosted MCP server
To skip installing anything, point your client at Apify's hosted server and limit it to this actor:
{ "mcpServers": { "samgov": { "url": "https://mcp.apify.com/?tools=cleandatalabs/samgov-opportunities" } } }
It signs you in with OAuth, or you can send Authorization: Bearer <APIFY_TOKEN>. It exposes the actor as one generic tool with every raw actor input, plus run and dataset helper tools. This package instead offers three focused tools with typed filters, compact output and a per-call spending cap.
Development
pip install -e ".[test]"
pytest # offline tests over a real MCP stdio session
SAMGOV_LIVE=1 APIFY_TOKEN=... pytest # adds a live search + get (about $0.01)
npx @modelcontextprotocol/inspector -e APIFY_TOKEN=... -- samgov-opportunities-mcp
Data source and disclaimer
The data comes from public SAM.gov notices. This project is not affiliated with or endorsed by the U.S. General Services Administration or SAM.gov. Always confirm deadlines and requirements on the official notice before you bid.
License
MIT
Reviews
No reviews yet
Be the first to review this server!
More Developer Tools MCP Servers
Rea
Freeby Morluto · Developer Tools
Reverse engineer anything from your terminal or agent with one CLI and MCP server.
Paperclip
Freeby Paperclipai · Developer Tools
Trending hip-hop artist momentum scores across four cultural dimensions.
Scrapling
Freeby D4Vinci · Developer Tools
Web scraping with stealth HTTP, real browsers, and Cloudflare bypass. CSS selectors supported.
Git
Freeby Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
MCP Marketplace
Freeby mcp-marketplace · Developer Tools
Search and install MCP servers from inside your AI client.
