search_tenders, get_tender), two work with your saved search templates (list_saved_searches, run_saved_search), and one surfaces your bookmarked tenders (list_saved_tenders). All tools require an authenticated session — see Connect to set up credentials.
search_tenders
Search Belarusian public-procurement tenders in the Tendy database by keyword, status, source, region, OKRB code, amount range, publish date, and urgency. Returns a compact, paginated list.Parameters
string
A keyword, UUID, or external ID to search for. Leave empty to browse without a keyword filter.
array
Filter by tender status. Accepted values:
active, closed, cancelled. Pass multiple values to include more than one status.array
Limit results to one or more procurement platforms. Accepted values:
goszakupki, icetrade, butb, ppt_butb.string
Filter by region using a substring match — for example,
Минск returns tenders in the Minsk region and city.string
Filter by OKRB commodity code prefix — for example,
45.2 matches all construction-related codes under that branch.string
Filter by procedure type using a substring match.
number
Return only tenders with a contract value at or above this amount.
number
Return only tenders with a contract value at or below this amount.
boolean
When
true, include tenders that have no published contract value alongside priced results.string
Return tenders published on or after this date. Format:
YYYY-MM-DD.string
Return tenders published on or before this date. Format:
YYYY-MM-DD.boolean
When
true, return only tenders whose deadline falls within the next 3 days.number
default:"1"
Page number for paginated results.
number
default:"20"
Number of results per page. Maximum:
50.Returns
number
Total number of tenders matching the query across all pages.
number
The current page number.
number
The page size used for this request.
number
Number of tender objects returned on this page.
array
Array of compact tender objects. Each object includes:
id, external_id, title, amount, currency, deadline, status, source, region, company_name, procedure_type, published_at, url.Example
“Find active IT-related tenders in Minsk published since 1 January 2025 with a value above 100,000 BYN, sorted by the most urgent deadlines.”
get_tender
Fetch the full details of a single tender by its Tendy UUID. Returns all available information: title, description, amount, deadline, procuring entity, OKRB codes, lots, documents, events, and requirements.Parameters
string
required
The Tendy tender UUID. Obtain this from the
id field in search_tenders results.Returns
The full tender record including:string
Human-readable tender title.
string
Full tender description and scope of work.
number
Contract value.
string
Currency code, e.g.
BYN.string
Submission deadline in ISO 8601 format.
string
Name of the procuring entity (contracting authority).
string
Tax identification number (УНП) of the procuring entity.
string
Name and contact details of the responsible officer.
array
List of OKRB commodity classification codes attached to this tender.
array
Individual lots, each with its own description, amount, and requirements.
array
Attached procurement documents with download URLs.
array
Timeline of key events such as publication, clarification deadlines, and award.
array
Qualification and technical requirements for participating suppliers.
Example
“Get the full details for the tender with id 3f2a1b4c-…, including all attached documents and lot breakdowns.”
list_saved_searches
List the authenticated user’s saved search templates, including the filters stored in each template and how often Tendy notifies you of new matches.Parameters
This tool requires no parameters.Returns
number
Total number of saved searches in your account.
array
Array of saved search objects. Each object includes:
Example
“Show me all my saved searches so I can see which procurement categories I’m monitoring.”
run_saved_search
Execute one of your saved search templates by its id and return matching tenders. Optionally override the page or page size to paginate through results.Parameters
string
required
The saved search id. Retrieve available ids by calling
list_saved_searches first.number
Page number to retrieve. Defaults to
1.number
Number of results per page. Maximum:
50.Returns
Returns the same paginated tender list assearch_tenders, applying the filters stored in the saved search template.
Example
“Run my saved search called ‘Road construction Grodno’ and show me the latest matching tenders.”
list_saved_tenders
List the tenders you have bookmarked in Tendy, returned in reverse chronological order so your most recently saved opportunities appear first.Parameters
number
Page number to retrieve. Defaults to
1.number
Number of bookmarked tenders per page. Maximum:
50.Returns
number
Current page number.
number
Number of results on this page.
number
Number of bookmarked tender objects returned on this page.
array
Array of compact tender objects in the same format returned by
search_tenders.Example
“List the tenders I’ve bookmarked so I can review the ones I flagged earlier this week.”