# GovCon API MCP server

> Provides AI agents access to US federal procurement data including SAM.gov opportunities, FPDS contract transactions, and GSA labor rates.

- Repository: https://github.com/govconapi/govconapi-mcp
- Page: https://hostedmcp.org/servers/govconapi/govconapi-mcp
- Transport: stdio, remote
- Stars: 0
- License: MIT
- Latest version: 0.3.1

## Install

### Claude Code

```sh
claude mcp add --env GOVCONAPI_KEY=<YOUR_GOVCONAPI_KEY> govconapi-mcp -- uvx govconapi-mcp
```

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

```json
{
  "mcpServers": {
    "govconapi-mcp": {
      "command": "uvx",
      "args": [
        "govconapi-mcp"
      ],
      "env": {
        "GOVCONAPI_KEY": "<YOUR_GOVCONAPI_KEY>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "govconapi-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "govconapi-mcp"
      ],
      "env": {
        "GOVCONAPI_KEY": "<YOUR_GOVCONAPI_KEY>"
      }
    }
  }
}
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "govconapi-mcp": {
      "command": "uvx",
      "args": [
        "govconapi-mcp"
      ],
      "env": {
        "GOVCONAPI_KEY": "<YOUR_GOVCONAPI_KEY>"
      }
    }
  }
}
```

### Codex (`~/.codex/config.toml`)

```toml
[mcp_servers.govconapi-mcp]
command = "uvx"
args = ["govconapi-mcp"]

[mcp_servers.govconapi-mcp.env]
GOVCONAPI_KEY = "<YOUR_GOVCONAPI_KEY>"
```

### Gemini CLI (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "govconapi-mcp": {
      "command": "uvx",
      "args": [
        "govconapi-mcp"
      ],
      "env": {
        "GOVCONAPI_KEY": "<YOUR_GOVCONAPI_KEY>"
      }
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `GOVCONAPI_KEY` | yes | yes | Your GovCon API key. Free 14-day trial, no credit card, at https://govconapi.com |
| `GOVCONAPI_TOOLS` | no | no | Optional. Set to all for the 53 single-purpose tools instead of the six task-shaped ones. |

## Tools (6)

- `resolve`
- `search`
- `get`
- `market`
- `price`
- `contact`

## FAQ

### Is the data real-time?

No, opportunities are refreshed on a daily basis.

### What is the difference between the six main tools and the 53 single-purpose tools?

The six main tools act as high-level interfaces for models to pick from, while the 53 single-purpose tools can be enabled via an environment variable for more granular control.

### Does the server store my chat conversations?

No, conversation content does not leave your machine; only tool parameters are sent to the API.
