# govbid-mcp-server [Health: Active]

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/imgproc-git/govbid-mcp-server  
**GitHub Stars:** 0  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/govbid-mcp-server

## Description
U.S. federal contract opportunities from SAM.gov. Daily updates. Public Domain.

## Claude Desktop Quick Installation
Remote MCP endpoint (confidence: high). Install path detected from listing signals. Add as a URL/SSE server in your client:

```json
"mcpServers": {
  "govbid-mcp-server": {
    "url": "https://modelcontextprotocol.io"
  }
}
```

## Documentation & 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](https://github.com/imgproc-git/govbid-mcp-server/blob/HEAD/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.