How To Connect

Connect your MCP client to GovBlitz in three steps:

  1. 1. Subscribe and receive your gb_ API key
  2. 2. Add the server configuration below to your client
  3. 3. Restart your client and start querying federal contract data

Claude Desktop

Recommended: Custom Connector with OAuth

Claude Desktop Custom Connectors support OAuth authentication. Add GovBlitz in a few clicks:

  1. 1. In Claude Desktop: CustomizeConnectors
  2. 2. Click + next to Connectors → Add custom connector
  3. 3. Enter:
    Name: GovBlitz
    URL: https://mcp.govblitz.com/mcp
  4. 4. Leave Advanced settings empty (OAuth is automatic)
  5. 5. Click Add
  6. 6. You'll be redirected to authorize:
    • Existing subscriber: Paste your gb_ API key
    • New user: Subscribe via Stripe ($20/month + usage)
  7. 7. Enable per chat via + on the composer → Connectors

OAuth 2.1 + PKCE: Claude Desktop acts as the OAuth client. GovBlitz is the authorization server. Your credentials are never sent to Anthropic. The authorization page validates your API key or creates a new subscription.

Alternative: Local Bridge via mcp-remote

If you prefer to use Bearer tokens directly (no OAuth flow), use mcp-remote as a local stdio bridge. Requires Node.js.

  1. 1. Open Claude Desktop
  2. 2. Go to SettingsDeveloper
  3. 3. Click Edit Config to open claude_desktop_config.json

Config file location:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Add this configuration:

{
  "mcpServers": {
    "govblitz": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.govblitz.com/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer gb_YOUR_KEY"
      }
    }
  }
}

Important:

  • • Replace gb_YOUR_KEY with your actual API key
  • • No space around the colon in Authorization:\${AUTH_HEADER}
  • • Put Bearer value in env, not inline in args (Desktop does not escape spaces properly, especially on Windows)
  • Fully quit Claude Desktop (macOS: Cmd-Q, Windows: quit from tray). Closing the window is not enough.

Verify: click + on the chat box → Connectors, or check Developer settings for MCP logs.

Claude Code

Claude Code (CLI) is a separate product from Claude Desktop. Install GovBlitz via the CLI:

claude mcp add --transport http govblitz https://mcp.govblitz.com/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

Codex

Configuration File

Add to ~/.codex/config.toml:

[mcp_servers.govblitz]
url = "https://mcp.govblitz.com/mcp"
bearer_token_env_var = "GOVBLITZ_API_KEY"

Then export your API key as an environment variable:

export GOVBLITZ_API_KEY=gb_your_api_key_here

CLI

codex mcp add govblitz --url https://mcp.govblitz.com/mcp \
  --bearer-token-env-var GOVBLITZ_API_KEY

Verify with /mcp in Codex.

Grok Bot

Grok Bot supports public HTTPS MCP servers. Add GovBlitz as a custom connector:

  1. 1. Tell Grok Bot: "Add a custom MCP connector"
  2. 2. Provide these details:
    Name: GovBlitz
    URL: https://mcp.govblitz.com/mcp
    Header: Authorization: Bearer gb_YOUR_KEY

The connector will appear in your Grok Bot conversation after confirmation.

Note: grok.com/connectors Custom MCP is separate from Grok Bot's inline connector flow.

Manus

Settings Method

  1. 1. Open Manus
  2. 2. Go to SettingsIntegrations
  3. 3. Select Custom MCP Servers
  4. 4. Click Add Server
  5. 5. Fill in:
    Name: GovBlitz
    Transport: HTTP
    URL: https://mcp.govblitz.com/mcp
    Auth: Bearer gb_YOUR_KEY
  6. 6. Click Save and wait for tools to load

Alternate: Connectors

Go to ConnectorsAdd connectorsCustom MCP Direct configuration, then use the same values above.

Cursor

Add to Cursor SettingsMCP or mcp.json:

{
  "name": "govblitz",
  "type": "http",
  "url": "https://mcp.govblitz.com/mcp",
  "auth": {
    "type": "bearer",
    "token": "YOUR_API_KEY"
  }
}

Available Tools

ToolDescription
search_opportunitiesSearch federal contract opportunities (SAM.gov notices)
get_opportunityGet full details for a specific opportunity
recent_changesTrack recently modified opportunities
search_awardsSearch contract awards by company, agency, or NAICS
get_awardGet detailed award information by contract number
search_contractsSearch FPDS prime contract transactions
get_contractGet contract details by PIID
lookup_entityLook up registered SAM entities by UEI or CAGE
search_entitiesSearch SAM entities by name, NAICS, or location
check_exclusionCheck if an entity is debarred or suspended
lookup_agencyFind federal agency information by name or code

Example Prompts

"Show me active cybersecurity opportunities from DHS with deadlines in the next 30 days"

"Who are the top 5 contractors winning NASA awards this year?"

"Look up Lockheed Martin's SAM registration and check for exclusions"

"Find all 8(a) set-aside opportunities for NAICS 541330 posted this week"

Billing

$20/month includes 2,000 MCP tool calls

$0.01 per additional call above 2,000

Usage resets on the first day of each month. Each request to any of the 11 tools counts as one call.

View your current usage at https://mcp.govblitz.com/api/usage (requires Bearer auth).

Data Sources

GovBlitz uses GovCon API, which aggregates data from:

  • • SAM.gov contract opportunities (daily refresh)
  • • FPDS prime contract transactions (FY2025+)
  • • SAM entity registry (~887K registered firms)
  • • Federal exclusion lists (debarment/suspension)
  • • SAM Award Notices