com.victano/victano

Tools

• connect_start

  Begin authentication. Send the user's work email; Victano mails them a six-digit code valid for 15 minutes and returns a request_id. Ask the user for the code, then call connect_verify with both. Nothing is charged and no card is needed.

  shallow
• connect_verify

  Complete authentication with the request_id from connect_start and the six-digit code the user received. On success this session is authenticated immediately, with no reconnect, and the full toolset appears. Save the returned api_key into this client's MCP config as an Authorization: Bearer header so future conversations start connected. The key is shown once and cannot be recovered.

  shallow
• get_opportunity

  The complete normalised record plus the document inventory. Use this before advising on a bid; a search card is not enough. Follow with read_document for the text that actually decides eligibility and scoring. Lithuanian notices may name the perkančioji organizacija and use terms like skelbimas apie pirkimą or kelio darbai.

  shallow
• get_workflow

  The complete step-by-step playbook for one workflow id, including the decision gates, the EU procurement specifics that decide eligibility, and the pitfalls that lose bids. Follow it rather than summarising it.

  shallow
• list_workflows

  The playbook library: how bid professionals actually run this work, from the weekly scan through qualification, eligibility screening, reading a specification, clarification questions, and the proposal skeleton. READ A WORKFLOW BEFORE IMPROVISING A PROCESS. Pass persona='consultant' to see the multi-client ones. Follow with get_workflow.

  shallow
• search_opportunities

  Hybrid keyword and semantic search across the corpus. Lithuanian queries work: viešieji pirkimai, skelbimas apie pirkimą. query optional — without one, order is soonest deadline. Works cross-language: the search is WIDENED with the buyer-language wording for the closest CPV categories, and the response carries `widened_search` saying which terms were added. Pass expand_languages=false to search exactly as typed. Results carry cpv_label/cpv_labels and nuts_names — use the labels with a person, not the raw codes. Returns ranked cards, not full records. Follow a promising card with get_opportunity, then read_document. Scope by country when you can: EU-wide costs ~10x one country. Filters: countries (ISO3 'LTU', or 'LT'), cpv (any prefix: '45', '452' or a full code), status ('open' by default; 'forthcoming' for calls not yet open, 43% of the grant corpus; 'any' adds expired), deadline_after / deadline_before (ISO dates), min_value / max_value (in EUR, converted from the buyer's currency; notices we cannot price in euros are excluded from a value filter rather than guessed at). Two filters are worth knowing about because no keyword tool has them: criteria_stated=true returns only notices whose SELECTION CRITERIA the buyer published, so you can answer 'may this company bid' rather than guess - about half of TED; and no_guarantee=true returns only notices that state no bid bond is required, which is cash a small company has to find before it can bid at all. NOTE on cpv and contract_nature: sources that publish neither (Lithuanian CVP notices, EU grant calls) are INCLUDED alongside those filters and ranked rather than dropped; pass cpv_strict=true or nature_strict=true to exclude them. Results that are lots of one procurement are collapsed into a single entry carrying `lots` and `lot_ids`; report those as one opportunity, not several. Cards are COMPACT by default: a field that repeats another is omitted (the original title when the English one contains it, the raw CPV codes beside their labels). Pass fields='full' for the raw codes or 600 characters of summary rather than 400 — neither is the whole text, and a cut one carries `summary_cut` saying so. Filters beyond the obvious: source ('ted', 'cvp', 'ft'), type ('tender' or 'grant' — use it when the user asks specifically for grant calls), contract_nature ('works', 'supplies', 'services'), lang, and exclude_results=true to drop award notices for things already decided. nuts narrows BELOW country level to a NUTS2 region ('DE30', 'LT01') — the granularity that decides whether a site is reachable, which country-level filtering cannot express. Not every notice publishes one, so a region filter excludes notices whose location is unstated. Call explore_slice first if you are unsure which values exist. RECALL DEPENDS ON THE LANGUAGE YOU ASK IN. Notices carry the buyer's own wording and no English translation of it: 99.6% of foreign-language notices have an English title that is only 'Country - sector - <the original title>'. Queries in the notice's language find their target 75% of the time against 25% for English ones (36 known-item probes, measured 2026-08-28). So TRANSLATE THE QUERY YOURSELF and pass the translations in `queries`, one per country in scope: queries=['<in Spanish>', '<in Italian>']. Keep `query` as the user typed it - phrasings are ADDED, not substituted, each fused as its own ranking. Translate the DISTINCTIVE TERMS, not the sentence: a native phrasing of common words measures WORSE than the English one. Send the trade term. This tool aims for RECALL rather than a tidy shortlist: expect candidates worth filtering, and do that filtering yourself. Every response carries a `coverage` block with matching_your_filters - how many notices the filters admit in total, all of which were ranked rather than sampled. Tell the user that number: ten results mean something different out of twelve than out of four hundred.

  shallow
• whoami

  The connected account, its tier, how much quota remains in the current window, and how fresh the corpus is. Call this when a user asks about limits, or when you are unsure whether you are authenticated.

  shallow

Embed this server’s score

Tool count and median score across every tool in this server’s corpus — honest in a way a single cherry-picked tool’s badge wouldn’t be.

[![Vouch score](https://vouch.tools/api/servers/ac975f6b-ae84-4884-b55a-442dc403a54a/badge.svg)](https://vouch.tools/servers/ac975f6b-ae84-4884-b55a-442dc403a54a)