sam-mcp 0.2.0

MCP server for accessing SAM.gov APIs

sam-mcp

An MCP server for accessing SAM.gov APIs, built with FastMCP and Python.

Prerequisites

• uv
• A SAM.gov API key — get one at sam.gov/workspace/profile/account-details

Setup

git clone https://github.com/rsivilli/sam-mcp
cd sam-mcp
cp .env.example .env

Edit .env and set your API key:

SAM_API_KEY=your_api_key_here

Running the server

stdio (for MCP clients that spawn the process, e.g. Claude Desktop):

uv run sam-mcp

HTTP (for connecting remotely):

uv run sam-mcp-http

Claude Desktop configuration

Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "sam-gov": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/sam-mcp", "sam-mcp"],
      "env": {
        "SAM_API_KEY": "your_api_key_here"
      }
    }
  }
}

Available tools

Tool	Description
search_entities	Search registered entities (vendors/organizations) by name, UEI, CAGE code, state, country, or registration status
get_entity	Get full details for a specific entity by UEI
search_opportunities	Search contract opportunities/solicitations by keyword, NAICS code, set-aside type, date range, and more
search_exclusions	Search for debarred or suspended parties by name, UEI, or CAGE code

Development

Install dev dependencies and set up pre-commit hooks:

uv sync
uv run pre-commit install

Run linting and formatting checks:

uv run pre-commit run --all-files