# Open government bids API for AI agents

One call returns open US public-sector bids and grants — state, county, city, school district, housing authority,
federal (SAM.gov) and Grants.gov — as clean Markdown or JSON: title, buyer, state, notice type, due date (UTC),
solicitation number, codes, value range, short summary and the official notice link.

Built for agents that find contracts for small businesses: no portal logins, no scraping, no API key.
Only public notices are listed; the link always goes to the official notice.

## Price
$1 USDC per call on Base, paid with x402 (HTTP or MCP). Up to 50 notices per call.

## Free preview
```bash
curl "https://search.missioncoregroup.com/v1/bids/preview?q=janitorial&state=PA"
```
Titles, state and due date of the 5 nearest matches (no link, no buyer). 20 calls per day.

## Paid call
```bash
curl -i "https://search.missioncoregroup.com/v1/bids?q=hvac+maintenance&state=PA&due_within=30&limit=20&format=json"
```
First answer is HTTP 402 with a PAYMENT-REQUIRED header; an x402 client (@x402/fetch, @x402/axios, x402 for Python)
pays and retries automatically.

| Parameter | Meaning |
|---|---|
| q | Keywords: "janitorial", "sludge removal", "roof inspection" (quoted phrases, OR, -exclusions work) |
| state | Two-letter US state, e.g. PA, VA, FL |
| kind | bid or grant (default both) |
| due_within | Only notices due in the next N days |
| limit | 1-50 (default 20) |
| format | md (default) or json |

## MCP
Tool `bids_search` ($1) and free `bids_preview` on https://search.missioncoregroup.com/mcp.
