How the Torhy tools work
The Torhy MCP tools: what each one does, key parameters, usage limits and example requests.
The technical list of all tools and parameters is generated automatically: tool reference. Below is what each tool does and how to use it.
Your assistant picks tools automatically, but knowing what they do helps you ask precise questions. Read tools
carry readOnlyHint; tools that change data are separate (create, update, delete). Long results are paginated:
the response contains next_cursor, which the assistant passes back to get the next page.
Prozorro tenders
search_tenders
Searches the Torhy copy of Prozorro (refreshed every 5 minutes). Defaults to open tenders (enquiry and bidding periods), ranked by relevance.
Key parameters: query (keywords; "exact phrase", OR, -exclude; Ukrainian word forms are matched),
cpv (CPV/ДК 021 codes or prefixes such as 45 or 45261910-6), regions (names or slugs), statuses,
methods, category (goods/services/works), value_min/value_max (UAH), buyer_edrpou,
published_from/published_to, deadline_from/deadline_to, profile_id (apply a saved company profile),
sort (relevance, deadline, newest, value_desc, value_asc), limit (up to 50), cursor.
Each result has the UA-… number, title, buyer, region, expected value, deadline, status, main CPV code, Prozorro link and a short snippet. Counts towards Searches.
get_tender
Full details by UA-2026-… number, internal id or prozorro.gov.ua link: items, lots, dates, payment terms,
qualification criteria, questions and answers, documents, bidders and their prices (after the auction), awards
and contracts. Counts towards Tender views.
get_tender_documents
Without document_ids it lists the procurement's documents (title, type, format, date) at no cost. With
document_ids (up to 3 per call) it downloads the files and returns their text in pages of about 12,000
characters (page). Supports PDF, DOCX, DOC, XLSX, XLS, ODT, RTF, HTML, TXT, ZIP and e-signed .p7s files (the
signed content and signer are extracted). Scans without a text layer are flagged needs_ocr. Counts towards
Documents: one unit per document opened for the first time in 30 days.
EU tenders (TED)
search_ted
Parameters: query, countries (ISO codes such as POL, DEU, or names), cpv, published_from,
deadline_from, only_open (default: deadline in the future), limit, cursor. Returns English and
original-language titles, buyer, country, CPV codes, publication date, deadline, estimated value and links.
Counts towards Searches.
get_ted_notice
Details by publication number (e.g. 712345-2026): description, lots, procurement document links, buyer
contacts, notice PDF. Counts towards Tender views.
Analytics
find_awards
Completed procurements with winners. Filters as in search plus supplier_edrpou and a period. For each award:
winner, expected and awarded value, discount %, number of bidders. Counts towards Analytics.
get_price_benchmark
For a CPV code (optionally a unit of measure and keywords) returns the unit-price distribution from single-item lots: count, min, 25th percentile, median, 75th percentile, max. Obvious outliers (quantity entry errors) are excluded and counted. Falls back to the distribution of total values when no unit prices exist. Counts towards Analytics.
get_buyer_profile
By EDRPOU: number and value of procurements, share cancelled or unsuccessful, typical procedures, top CPV categories, frequent winners, average discount, currently open tenders. Counts towards Analytics.
get_supplier_profile
By EDRPOU (or a sole trader's tax number): wins and contract value, top buyers, categories, participation vs wins where bids are disclosed. Counts towards Analytics.
Reference and account
lookup_cpv— find CPV/ДК 021 codes by words in Ukrainian or English, or by code; shows parent levels. Free.get_usage— your plan, this month's usage and stored-object counts.
Company profile, alerts and watchlist
save_company_profile/get_company_profile— name, EDRPOU, CPV codes, regions, keywords, value range, capabilities.create_alert,update_alert,list_alerts,delete_alert— saved searches that send new tenders by email or Telegram (daily, weekly or real time depending on the plan).list_alert_matches— tenders found by your alerts.watch_tender,list_watched_tenders,unwatch_tender— change tracking for specific tenders: deadlines, new documents, questions, complaints, award decisions, contracts.
Errors
Every error has a code and a next step, e.g. quota_exceeded (monthly limit reached — includes an upgrade
link), limit_reached (maximum number of alerts or watched tenders), not_found (check the tender number),
invalid_input.