# SAM.gov

> SAM.gov is an open-source MCP server for legal and government. Federal contracting data from SAM.gov: opportunities, entities and exclusions. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** API, CLI, self-hosted
- **Website:** https://1102tools.com
- **Repository:** https://github.com/1102tools-dev/federal-contracting-mcps/tree/HEAD/servers/sam-gov-mcp
- **MCP Registry name:** com.1102tools/sam-gov-mcp
- **Categories:** legal and government
- **Listing updated:** 2026-11-14

## About

The server comes from 1102tools, which publishes a set of free federal-contracting MCP servers under the MIT license. It ships in two editions. The hosted edition at sam.1102tools.com needs no key and exposes 6 tools built on the public files SAM.gov releases for download. The local edition, installed from PyPI as `sam-gov-mcp`, exposes the full 20 tools and calls the live SAM.gov APIs with a free API key that expires every 90 days.

Hosted data is only as fresh as SAM.gov's own files: opportunities and exclusions are published daily and public entity registrations monthly. Each result names the source file and date that was loaded, and during a refresh the affected tool says so and asks you to retry. The local edition adds SBA certifications, reps and certs, integrity records, contract award records, the federal hierarchy and FFATA subawards, within your key's daily limit.

The publisher says every server is tested against its government source and that searches are not logged.

## Features

- **Keyless hosted edition:** Six tools run on SAM.gov's public downloads with no API key and no account.
- **Full local edition:** Twenty tools over live SAM.gov APIs, using a free key that expires every 90 days.
- **Opportunity search:** Filter notices by keyword, NAICS, PSC, set-aside, notice type, agency, state and dates.
- **Entity lookup:** Find registrations by UEI or CAGE, or search by name, NAICS, state and SBA certification code.
- **Exclusion checks:** Check debarment and exclusion records by UEI, CAGE or name.
- **Source transparency:** Results come with the source file name and date they were loaded from.

## Good for

- Match a capability statement to open contract notices
- Check a teaming partner's registration and exclusion status
- Count notices by agency, NAICS code or set-aside
- Pull award notices and justifications for market research
- Review subawards and the federal hierarchy with a local install

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http sam-gov-mcp https://sam.1102tools.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://sam.1102tools.com/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "sam-gov-mcp": {
      "url": "https://sam.1102tools.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "sam-gov-mcp": {
      "type": "http",
      "url": "https://sam.1102tools.com/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "sam-gov-mcp": {
      "serverUrl": "https://sam.1102tools.com/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "sam-gov-mcp": {
      "type": "http",
      "url": "https://sam.1102tools.com/mcp"
    }
  }
}
```

## Tools

- `search_opportunities`: Search notices by keyword, NAICS, PSC, set-aside, notice type, agency, state and dates.
- `get_opportunity`: Return the full notice with description, contacts, award details and sam.gov link.
- `summarize_opportunities`: Count opportunities by agency, NAICS, set-aside or notice type.
- `search_entities`: Look up public registrations by UEI, CAGE, name, NAICS, state or certification code.
- `search_exclusions`: Check public exclusions by UEI, CAGE or name.
- `get_data_status`: Report source file names, dates, load times and row counts.

## FAQ

### How many tools does the hosted edition have?

Six: search_opportunities, get_opportunity, summarize_opportunities, search_entities, search_exclusions and get_data_status.

### Do I need an API key?

Not for the hosted edition. The local edition needs a free SAM.gov key, which expires every 90 days.

### How current is hosted data?

It mirrors SAM.gov's public files: opportunities and exclusions daily, entity registrations monthly.

### Which transports are offered?

The registry lists stdio for the PyPI package and streamable HTTP for the hosted endpoint.

### Is SAM.gov free?

Yes. SAM.gov is open source, so you can use and self-host it for free.

### How do I add SAM.gov to Claude Code?

Run this command in your terminal: claude mcp add --transport http sam-gov-mcp https://sam.1102tools.com/mcp

### What are the best alternatives to SAM.gov?

The closest alternatives to SAM.gov are NY LLC Publication (FileMyPublication), TribuJus, SupplyClub Catalog, SynomosAI Governance MCP and MedXpert 标准检索连接器.

## Alternatives

- [NY LLC Publication (FileMyPublication)](https://ai-powered.com/mcp/ny-llc-publication-filemypublication): NY LLC Publication (FileMyPublication) is a free MCP server for legal and government.
- [TribuJus](https://ai-powered.com/mcp/tribujus): TribuJus is an open-source MCP server for legal and government.
- [SupplyClub Catalog](https://ai-powered.com/mcp/supplyclub-catalog): SupplyClub Catalog is a free MCP server for legal and government.
- [SynomosAI Governance MCP](https://ai-powered.com/mcp/synomosai-governance-mcp-2): SynomosAI Governance MCP is an open-source MCP server for security.
- [MedXpert 标准检索连接器](https://ai-powered.com/mcp/medxpert-2): MedXpert 标准检索连接器 is a free MCP server for legal and government.
- [SigPen](https://ai-powered.com/mcp/sigpen): SigPen is a freemium MCP server for files and documents.
- [SOMMON Office](https://ai-powered.com/mcp/sommon-office): SOMMON Office is a paid MCP server for communication.
- [MedXpert 全球法规连接器 (reg-connector)](https://ai-powered.com/mcp/medxpert-reg-connector): MedXpert 全球法规连接器 (reg-connector) is a free MCP server for legal and government.

---
Source: https://ai-powered.com/mcp/sam-gov
