Tools / Contract Opportunities

Search Opportunities

Search live and recent public procurement opportunities across official tender sources with filters for buyer, codes, geography, dates, values, and set-asides.

Returns: Normalized tender opportunities with buyer, deadline, value, code, and source metadata

Parameters

querystringKeyword, service, product, buyer, or sector phrase to search for

sourcestringSource to search: all, sam, ted, contracts_finder, public_contracts_scotland, or world_bank

country_codesarrayOptional ISO alpha-2 country codes to keep results near target markets

buyer_namestringBuyer, agency, or authority name to narrow the search

classification_systemstringClassification system to interpret classification_code

classification_codestringNAICS, PSC, CPV, or UNSPSC code fragment to match

published_fromstringOnly include notices published on or after this date (YYYY-MM-DD)

deadline_beforestringOnly include opportunities with response deadlines on or before this date (YYYY-MM-DD)

value_minnumberMinimum contract value to include when a value is available

value_maxnumberMaximum contract value to include when a value is available

set_asidestringSet-aside or small-business term to match when the source exposes it

include_expiredbooleanWhen true, keep expired opportunities in the results

limitnumberMaximum opportunities to return per page (1-20, default 10)

pagenumberPage number for pagination (default 1)

Example

Find cyber security tenders across public procurement sources

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "contract-opportunities",
  "skill": "search_opportunities",
  "input": {
    "query": "cyber security",
    "source": "all",
    "limit": 6
  }
}' \
  https://api.toolrouter.com/v1/tools/call

Opportunity Details

Open the canonical notice details for one procurement opportunity so you can inspect deadlines, buyer data, codes, and source documents.

Returns: The normalized detail record for one opportunity with source-specific identifiers and metadata

Parameters

source *stringSource that owns the notice record

record_idstringRecord identifier returned by search_opportunities

notice_idstringOptional alias for record_id when you already have a notice id

ocidstringOptional alias for record_id when the source uses an OCDS identifier

Example

Open a TED notice by publication number

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "contract-opportunities",
  "skill": "opportunity_details",
  "input": {
    "source": "ted",
    "record_id": "102534-2016"
  }
}' \
  https://api.toolrouter.com/v1/tools/call

Search Awards

Search recent contract awards and incumbents across official public spending and procurement award sources.

Returns: Award matches with buyers, incumbents, dates, values, and source metadata

Parameters

querystringKeyword, service, buyer, or sector phrase to search awards for

sourcestringSource to search: all, sam, usaspending, contracts_finder, or public_contracts_scotland

country_codesarrayOptional ISO alpha-2 country codes to keep awards near target markets

buyer_namestringBuyer or agency name to narrow the award search

supplier_namestringAwarded supplier or incumbent name to match

classification_systemstringClassification system to interpret classification_code

classification_codestringNAICS, PSC, CPV, or UNSPSC code fragment to match

awarded_fromstringOnly include awards on or after this date (YYYY-MM-DD)

value_minnumberMinimum award value to include when available

value_maxnumberMaximum award value to include when available

limitnumberMaximum awards to return per page (1-20, default 10)

pagenumberPage number for pagination (default 1)

Example

Find recent cyber security contract awards

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "contract-opportunities",
  "skill": "search_awards",
  "input": {
    "query": "cyber security",
    "source": "all",
    "awarded_from": "2025-01-01",
    "limit": 6
  }
}' \
  https://api.toolrouter.com/v1/tools/call

Buyer Intelligence

Summarize a buyer or agency by combining open opportunities, recent awards, top suppliers, and value signals from the available sources.

Returns: A buyer-level procurement summary covering open opportunities, recent awards, and incumbent signals

Parameters

buyer_name *stringBuyer, agency, authority, or contracting body to analyze

sourcestringOptional source focus: all or any supported procurement source

country_codesarrayOptional ISO alpha-2 country codes to keep the buyer analysis geographically tight

published_fromstringOnly include opportunities published on or after this date (YYYY-MM-DD)

awarded_fromstringOnly include awards on or after this date (YYYY-MM-DD)

limitnumberNumber of opportunities and awards to sample for the summary (1-20, default 10)

Example

Summarize a buyer across open tenders and recent awards

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "contract-opportunities",
  "skill": "buyer_intelligence",
  "input": {
    "buyer_name": "Ministry of Defence",
    "source": "all",
    "limit": 8
  }
}' \
  https://api.toolrouter.com/v1/tools/call

Match Supplier Profile

Score opportunities against a supplier profile using classification codes, geography, value range, set-asides, target buyers, and freshness.

Returns: Ranked opportunity matches with fit scores and reasons tied to the supplier profile

Parameters

querystringOptional search phrase to seed the candidate opportunity set

sourcestringSource to score opportunities from: all, sam, ted, contracts_finder, public_contracts_scotland, or world_bank

classification_systemstringClassification system used by target_classification_codes

target_classification_codesarrayTarget NAICS, PSC, CPV, or UNSPSC codes that define the supplier fit

target_country_codesarrayTarget ISO alpha-2 country codes where the supplier wants to bid

target_regionsarrayTarget subregions, states, or regions that matter for delivery coverage

preferred_buyersarrayBuyer names that should boost the fit score when matched

set_aside_eligibilityarraySet-aside terms the supplier is eligible for

value_minnumberPreferred minimum deal size for the supplier profile

value_maxnumberPreferred maximum deal size for the supplier profile

limitnumberMaximum scored matches to return per page (1-20, default 10)

pagenumberPage number for pagination after scoring (default 1)

Example

Score technology procurement opportunities against a supplier profile

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "contract-opportunities",
  "skill": "match_supplier_profile",
  "input": {
    "query": "software development",
    "classification_system": "cpv",
    "target_classification_codes": [
      "72000000"
    ],
    "target_country_codes": [
      "GB",
      "US"
    ],
    "value_min": 50000,
    "value_max": 5000000,
    "limit": 6
  }
}' \
  https://api.toolrouter.com/v1/tools/call

Watchlist Snapshot

Return a compact tender watchlist snapshot sorted by deadline, publication recency, or value for alerting and automation use cases.

Returns: A compact, sortable watchlist snapshot for recurring procurement monitoring

Parameters

querystringKeyword, service, buyer, or sector phrase to monitor

sourcestringSource to monitor: all, sam, ted, contracts_finder, public_contracts_scotland, or world_bank

country_codesarrayOptional ISO alpha-2 country codes to keep the watchlist relevant to target markets

buyer_namestringBuyer or authority name to monitor

classification_systemstringClassification system to interpret classification_code

classification_codestringClassification code fragment to filter by

published_fromstringOnly include notices published on or after this date (YYYY-MM-DD)

deadline_beforestringOnly include notices due on or before this date (YYYY-MM-DD)

set_asidestringSet-aside term to monitor when available

include_expiredbooleanWhen true, include expired notices in the snapshot

sort_bystringHow to rank the snapshot items

limitnumberMaximum snapshot items to return (1-20, default 10)

Example

Build a deadline-sorted watchlist for cyber security tenders

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{
  "tool": "contract-opportunities",
  "skill": "watchlist_snapshot",
  "input": {
    "query": "cyber security",
    "sort_by": "deadline",
    "limit": 6
  }
}' \
  https://api.toolrouter.com/v1/tools/call

Quick Start

MCP (Claude Code)

claude mcp add --transport stdio \
  --env TOOLROUTER_API_KEY=YOUR_API_KEY \
  toolrouter -- npx -y toolrouter-mcp

REST API

curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
  -d '{"tool":"contract-opportunities","skill":"search_opportunities","input":{}}' \
  https://api.toolrouter.com/v1/tools/call