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

Entity & registration

Opportunities & exclusions

Contract awards

Company intelligence

API rate limits

Rate limits are per API key per day and reset at midnight UTC.

For production use, a system account key is recommended. Apply through your SAM.gov account settings.

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