Connect your MCP client to GovBlitz in three steps:
gb_ API keyClaude Desktop Custom Connectors support OAuth authentication. Add GovBlitz in a few clicks:
gb_ API keyOAuth 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.
If you prefer to use Bearer tokens directly (no OAuth flow), use mcp-remote as a local stdio bridge. Requires Node.js.
claude_desktop_config.jsonConfig file location:
~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.jsonAdd 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:
gb_YOUR_KEY with your actual API keyAuthorization:\${AUTH_HEADER}env, not inline in args (Desktop does not escape spaces properly, especially on Windows)Verify: click + on the chat box → Connectors, or check Developer settings for MCP logs.
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"
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
codex mcp add govblitz --url https://mcp.govblitz.com/mcp \ --bearer-token-env-var GOVBLITZ_API_KEY
Verify with /mcp in Codex.
Grok Bot supports public HTTPS MCP servers. Add GovBlitz as a custom connector:
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.
Go to Connectors → Add connectors → Custom MCP → Direct configuration, then use the same values above.
Add to Cursor Settings → MCP or mcp.json:
{
"name": "govblitz",
"type": "http",
"url": "https://mcp.govblitz.com/mcp",
"auth": {
"type": "bearer",
"token": "YOUR_API_KEY"
}
}| Tool | Description |
|---|---|
| search_opportunities | Search federal contract opportunities (SAM.gov notices) |
| get_opportunity | Get full details for a specific opportunity |
| recent_changes | Track recently modified opportunities |
| search_awards | Search contract awards by company, agency, or NAICS |
| get_award | Get detailed award information by contract number |
| search_contracts | Search FPDS prime contract transactions |
| get_contract | Get contract details by PIID |
| lookup_entity | Look up registered SAM entities by UEI or CAGE |
| search_entities | Search SAM entities by name, NAICS, or location |
| check_exclusion | Check if an entity is debarred or suspended |
| lookup_agency | Find federal agency information by name or code |
| Tool | Description |
|---|---|
| search_state_bids | Search TX, GA, and UT state bid listings (NYC if entitled). Requires a state add-on ($10/mo each). |
State add-ons: Subscribe to TX, GA, or UT in your dashboard. $10/mo each, cancel anytime.
"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"
"Show me Georgia GPR construction bids due in the next 2 weeks"
"Find all Texas IT solicitations with 'cybersecurity' in the title"
"Search state bids in all my subscribed states due after March 1"
$10/month base plan includes 1,000 MCP tool calls
$0.01 per additional call above 1,000
$10/month per state add-on (TX, GA, or UT)
Usage resets on the first day of each month. Each request to any tool (federal or state) counts as one call.
State add-ons appear as separate subscription items and can be added or removed anytime from your dashboard.
View your current usage at https://mcp.govblitz.com/api/usage (requires Bearer auth).
Federal tools use GovBlitz data sourced from: