io.github.imgproc-git/govbid-mcp-server
U.S. federal contract opportunities from SAM.gov. Daily updates. Public Domain.
Open source Repository Open in the app JSON README (API)
About
U.S. federal contract opportunities from SAM.gov. Daily updates. Public Domain.
Details
- Kind
- MCP servers
- Topic
- No topic detected
- Publisher
- imgproc-git
- Origin
- official
- Category
- ferramentas
- Transport
- http
- Version
- 1.0.0
- Last push
- 2026-09-05T13:04:38Z
- Repository state
- ativo
- Language
- TypeScript
- License
- MIT
- Added
- 2026-08-29 04:00:10
- Updated
- 2026-08-29 04:00:10
- Origin id
io.github.imgproc-git/govbid-mcp-server
README
# GovBid Global API — MCP Server
A remote [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server that gives AI agents direct, structured access to **U.S. federal contract opportunities** sourced from [SAM.gov](https://sam.gov) (System for Award Management), the official U.S. government procurement portal.
This server exposes the [GovBid Global API](https://github.com/imgproc-git/govbid-mvp) data through MCP tools so that any MCP-compatible AI agent (Claude, other LLM agents, etc.) can search, filter, and retrieve federal bid/opportunity data autonomously.
- **MCP Endpoint:** `https://govbid-mcp-server.gaikotsuimageprocessing.workers.dev/mcp`
- **Data source:** SAM.gov Opportunities API (U.S. Government, Public Domain)
- **Update frequency:** Daily, automated via GitHub Actions
- **License:** MIT
---
## What this server does
GovBid Global API MCP Server acts as a bridge between AI agents and live U.S. federal procurement data. Instead of scraping or manually querying SAM.gov, an AI agent can call this server's tools to:
- Discover the API's metadata and licensing terms
- Search recent federal contract opportunities by department, date range, and result limit
- Retrieve a direct link to the official SAM.gov page for a specific opportunity
## Available MCP Tools
| Tool | Auth required | Description |
|------|---------------|-------------|
| `get_api_info` | No | Returns metadata about the API: name, version, description, license, and the `llms.txt` URL. |
| `search_opportunities` | Yes (`api_key`) | Searches federal contract opportunities. Supports filtering by `department`, `days` (lookback window), and `limit` (result count). |
| `get_opportunity_detail` | No | Returns the official SAM.gov source URL for a specific opportunity by ID. |
## How to connect
### Cloudflare AI Playground
1. Go to [Cloudflare AI Playground](https://playground.ai.cloudflare.com)
2. Select **MCP Servers → Add**
3. Enter the endpoint: `https://govbid-mcp-server.gaikotsuimageprocessing.workers.dev/mcp`
### Generic MCP client configuration
```json
{
"mcpServers": {
"govbid-global-api": {
"url": "https://govbid-mcp-server.gaikotsuimageprocessing.workers.dev/mcp"
}
}
}
```
## Data & Licensing
- Underlying data originates from **SAM.gov**, operated by the U.S. General Services Administration (GSA), and is in the **public domain**.
- This project (the server code) is licensed under the **MIT License** — see [LICENSE](./LICENSE).
- This is an independent, unofficial project and is not affiliated with or endorsed by SAM.gov or the U.S. Government.
## Related project
- [`govbid-mvp`](https://github.com/imgproc-git/govbid-mvp) — the underlying data API (Cloudflare Worker + D1) that this MCP server wraps.
## About
Built with the Cloudflare Workers `remote-mcp-authless` template, backed by Cloudflare D1 for data storage and GitHub Actions for daily automated ingestion from SAM.gov.