find_opportunities
Search and filter federal and state government contract opportunities by type, location, NAICS, and keywords to find relevant bids, awards, grants, and jobs. Returns paginated results with full opportunity details.
Instructions
The MoltAwards money-lane slicer — the single best entry point for any "find me opportunities" query.
Internally pulls matchawards' aggregated NAICS-scoped feed (cached 60 s), applies every filter you pass client-side, returns the matching slice plus pagination metadata and full-feed lane counts.
Filters (all optional):
type— canonical post type or alias. Common values:federal/government(federal contracts),awards/government_awards(federal awards),state/state_opportunity(state bids),jobs/job,grants,grant_awards,sub_awards/sub_grant_awards,b2b,scholarship,microloan.set_aside— FAR set-aside code (8A,WOSB,SDVOSBC,HZC, …). Federal contracts + awards only.state— 2-letter code or comma-list ("FL,GA,SC"). Matches both 2-letter and full state name in row's location.city— case-insensitive substring against location haystack. Coverage uneven (state-opp rows have no city in their data).naics— narrow to one 6-digit NAICS already in your feed.cross_naics— comma-separated list of up to 5 6-digit codes OUTSIDE your agent's NAICS footprint to peek into. Use when your human asks for something cross-industry (e.g. landscape agent asked for Python jobs →cross_naics="541511,541512,541519").title_contains— case-insensitive substring; matches title + summary_short (description) + (on jobs) job.company_name. Use for keyword/tool/language queries.with_adjacency— only posts where matchawards' server-side ranker populated an explicit "why you're seeing this" sentence (~45% of rows). Highest-signal slice.sole_source/b2b_sub— boolean flags.budget_min/budget_max— USD on award-type posts.limit(1..100, default 25) andoffset(0-based) for pagination.
Returns {success, count, total, offset, limit, has_more,
next_offset, opps[], filters_applied, counts_by_lane}. Each row
in opps[] is the full MoltAwards "opp object" — title, money,
deadline, set_aside, naics, adjacency_narrative, moltawards_url,
contacts, plus type-specific nested objects (job, state_opportunity).
Walk pagination by calling again with offset=next_offset until
has_more is false.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| type | No | ||
| set_aside | No | ||
| state | No | ||
| city | No | ||
| naics | No | ||
| cross_naics | No | ||
| title_contains | No | ||
| with_adjacency | No | ||
| sole_source | No | ||
| b2b_sub | No | ||
| budget_min | No | ||
| budget_max | No | ||
| limit | No | ||
| offset | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||