Connect with MCP

For AI & Developers · the same records and the same meter as the REST API

AI agents are welcome. Your own assistants and agents may use NextBid through the API and MCP under your account. No separate agent seats.

The endpoint

Remote MCP endpoint	`https://api.nextbid.us/mcp` (Streamable HTTP)
Authentication	Your API key in the `X-API-Key` header. Without a key, an MCP client can still connect and list the tools (no data, nothing counted); every tool call needs a key.
REST base	`https://api.nextbid.us/v1`, described in openapi.json

In any MCP client that accepts a remote server with a custom header:

{ "mcpServers": { "nextbid": {
    "url": "https://api.nextbid.us/mcp",
    "headers": { "X-API-Key": "YOUR_KEY" } } } }

Create a key in your NextBid account after your subscription starts. Every subscription begins with a 14-day trial with up to 250 unique opportunities delivered (and up to 100 calls), whichever comes first. Card required.

The tools

Tool	What it does	Call
`search_opportunities`	Search by trade, keyword, agency, source, set-aside program and deadline window	Billable
`get_opportunity`	The full record: contacts, amendments, documents, official source link	Billable
`list_documents`	The documents filed for the opportunity and the portal's attachment list	Billable
`get_document_download`	A time-limited download link for one stored original document (from list_documents, where stored is true)	Billable
`list_files`	The text files stored for one opportunity	Billable
`read_file`	One file as text, the opportunity summary document first	Billable
`list_tradelines`	The trades NextBid organizes, with specialties, search aliases and open counts	Free
`list_set_asides`	Set-aside programs with official references, aliases and open counts	Free
`corpus_stats`	What is open, with the definitions behind each count	Free
`my_usage`	Your plan, calls used and remaining allowance	Free
`my_account`	Your plan, keys, what counts as a call and recorded pursuits	Free
`mark_pursuit`	Record that you are pursuing an opportunity (only when you say so)	Free

What counts as a call

One call is one metered API request or one MCP tool call. REST and MCP share one meter.
Search counts and facets use one call but do not count as delivered opportunities.
A search returns at most 25 results per request.
The trial delivers up to 250 unique opportunities: each unique opportunity returned to your account counts once toward the 250, and returning the same one again uses a call but not another delivery.
One active API key per account during the trial.

Limits

600 calls a minute per key, 4 requests in flight per key, and one text file of up to 5 MB per request. Over a limit you get a 429 with a Retry-After header, never a bill.

Try asking

"Find open concrete and paving opportunities in California due in the next 30 days."
"Which open opportunities are designated for SDVOSB firms? Show the deadline and the official link for each."
"Read the solicitation documents for this opportunity and list the submission requirements, citing the document."

Your AI should always confirm deadlines and requirements against the official notice linked in each record.

Bring your AI · API documentation · llms.txt · Pricing · API Terms · How our AI works