{"name": "nabavnik", "about": "Who in the Slovenian public sector buys what, from whom, and what comes next: purchases under the tender threshold, calls, awards, and models over them.", "start": "nabavnik_sell: say what a firm sells and get to whom, for how much and when", "auth": "Authorization: Bearer <key>; a key comes with the plan Nabavnik of a MediaAtlas account: https://services.mediaatlas.si/sl/account.html", "free": ["nabavnik_kinds", "nabavnik_models", "nabavnik_open_calls", "nabavnik_search", "nabavnik_things"], "tools": [{"name": "nabavnik_who_buys", "path": "/api/v1/nabavnik_who_buys", "description": "Who in the Slovenian public sector buys a thing without a public tender (purchases under the tender threshold, from the buyers' own yearly lists). Returns buyers with their purchases, current suppliers and, for each purchase, model predictions: again (bought again next year), switch (from another supplier), stay (the tie to the supplier holds this year), keep (a tie paid this year holds next year too), with reasons in `why`. Use sort=chance to put first where a new supplier has the best chance.", "arguments": {"type": "object", "properties": {"what": {"type": "string", "description": "A kind of purchase by its id (see nabavnik_kinds, e.g. ciscenje, programska, zivila) or free words in Slovenian (e.g. »licence«, »toner«)."}, "region": {"type": "string", "description": "A statistical region of Slovenia in Slovenian, lower case (e.g. gorenjska, osrednjeslovenska); leave out for the whole country."}, "limit": {"type": "integer", "minimum": 1, "maximum": 30}, "sort": {"type": "string", "enum": ["eur", "chance"]}}, "required": ["what"], "additionalProperties": false}, "free": false}, {"name": "nabavnik_sell", "path": "/api/v1/nabavnik_sell", "description": "The one question a seller comes with. Give `what` (what the firm sells, in Slovenian words or a kind id) and get the whole answer: the market in words and numbers, what one order is worth (median, the middle half, by type of buyer), whom to call first (open doors with the likely successor), the buyers with the best chance and the price to beat at each, who sells it now and which of them lose buyers, the months buyers pay, what is bought beside it, the open calls. Without `what`: what is best to sell, ranked.", "arguments": {"type": "object", "properties": {"what": {"type": "string", "description": "What the firm sells, as a buyer would write it (»čistila«, »licence«, »prevoz otrok«) or a kind id from nabavnik_kinds. Empty: what is best to sell."}, "region": {"type": "string", "description": "A statistical region of Slovenia in Slovenian, lower case (e.g. gorenjska, osrednjeslovenska); leave out for the whole country."}}, "required": [], "additionalProperties": false}, "free": false}, {"name": "nabavnik_buy", "path": "/api/v1/nabavnik_buy", "description": "The other question: »this is what I buy«, or »who undercuts whom«. Who sells a thing to the public sector, ranked by how cheaply they take purchases over from other suppliers, with how the price moves when a buyer changes supplier and when it does not. Read from the same buyer's alike purchase a year before: the lists state no unit price.", "arguments": {"type": "object", "properties": {"what": {"type": "string", "description": "What is bought, as a buyer would write it, or a kind id from nabavnik_kinds."}, "region": {"type": "string", "description": "A statistical region of Slovenia in Slovenian, lower case (e.g. gorenjska, osrednjeslovenska); leave out for the whole country."}}, "required": ["what"], "additionalProperties": false}, "free": false}, {"name": "nabavnik_check_supplier", "path": "/api/v1/nabavnik_check_supplier", "description": "For one who lends to a firm, insures it or depends on it: of its sales to the public sector, how much hangs on buyers that stopped paying it this year or on ties likely to break next year, how much on one buyer, whom it gained, how it prices. Not a credit rating: the public-sector part only.", "arguments": {"type": "object", "properties": {"slug": {"type": "string", "description": "The supplier's slug, from nabavnik_search."}}, "required": ["slug"], "additionalProperties": false}, "free": false}, {"name": "nabavnik_buyer_report", "path": "/api/v1/nabavnik_buyer_report", "description": "For a public buyer about itself (or a seller preparing a pitch to it): what it has bought three years or more running from the same supplier, how such prices move when buyers change supplier and when they do not, and who else sells each of those things.", "arguments": {"type": "object", "properties": {"id": {"type": "string", "description": "The buyer's registry number, from nabavnik_search."}}, "required": ["id"], "additionalProperties": false}, "free": false}, {"name": "nabavnik_market", "path": "/api/v1/nabavnik_market", "description": "Start here when you do not know yet what to sell or where: every kind of purchase (by=kind) or every named thing (by=thing) with its size, buyers, suppliers, median purchase, how concentrated it is (top5), how much of it repeats, and how loose the money is (ranked by it). Pick a row, then nabavnik_doors or nabavnik_who_buys with its id or name.", "arguments": {"type": "object", "properties": {"by": {"type": "string", "enum": ["kind", "thing"]}, "limit": {"type": "integer", "minimum": 1, "maximum": 200}}, "required": [], "additionalProperties": false}, "free": false}, {"name": "nabavnik_doors", "path": "/api/v1/nabavnik_doors", "description": "The open doors for a seller of a kind of thing: public buyers whose standing supplier of it was not paid this year (state left) or is paid but likely to be dropped next year (state frays, with the chance and the reasons), the most money first, with what was bought there and when the buyer pays for that kind. These are the calls to make first.", "arguments": {"type": "object", "properties": {"what": {"type": "string", "description": "A kind of purchase by its id (see nabavnik_kinds, e.g. ciscenje, programska, zivila) or free words in Slovenian (e.g. »licence«, »toner«)."}, "region": {"type": "string", "description": "A statistical region of Slovenia in Slovenian, lower case (e.g. gorenjska, osrednjeslovenska); leave out for the whole country."}, "limit": {"type": "integer", "minimum": 1, "maximum": 60}}, "required": [], "additionalProperties": false}, "free": false}, {"name": "nabavnik_things", "path": "/api/v1/nabavnik_things", "description": "What is bought, by the words the buyers themselves use, one level under the kinds: products, services, software and brands (asphalt, toner, licences, mowing) with what was spent on each, how many buyers and suppliers, and the change against the year before. `part` narrows to one part a word plays: product, service, software, brand, or the context of a purchase: action (what is done), object (on what), phase (PZI, DGD, a study: what is being designed now is built next), domain (the field). Also `works_need`: what contractors of works need.", "arguments": {"type": "object", "properties": {"q": {"type": "string", "description": "A word of the seller's own, e.g. asfalt, licence, kurilno olje."}, "part": {"type": "string", "enum": ["product", "service", "software", "brand", "action", "object", "phase", "domain"]}, "kind": {"type": "string", "description": "A kind of purchase, an id from nabavnik_kinds."}, "limit": {"type": "integer", "minimum": 1, "maximum": 300}}, "required": [], "additionalProperties": false}, "free": true}, {"name": "nabavnik_thing", "path": "/api/v1/nabavnik_thing", "description": "One thing by its id (from nabavnik_things): how much of it is bought each year, which buyers buy it and for how much, from which suppliers, the things beside it, the open calls that name it, and for each buyer `chance_eur`: what of it a new supplier may win this year.", "arguments": {"type": "object", "properties": {"id": {"type": "string", "description": "The thing's id, from nabavnik_things."}, "limit": {"type": "integer", "minimum": 1, "maximum": 100}}, "required": ["id"], "additionalProperties": false}, "free": false}, {"name": "nabavnik_need", "path": "/api/v1/nabavnik_need", "description": "Who needs a building material or trade: the contractors of works under the tender threshold that need it (asphalt, concrete, gravel, pipes, excavation, traffic signs, waste removal, electricians, mechanical installers, facade, scaffolding, roofers, floors), and the buyers that order such works. For someone who sells to contractors.", "arguments": {"type": "object", "properties": {"id": {"type": "string", "enum": ["asfalt", "beton", "gramoz", "cevi", "mehanizacija", "promet", "odpadki", "elektro", "strojne", "fasada", "odri", "streha", "tlaki"]}, "limit": {"type": "integer", "minimum": 1, "maximum": 100}}, "required": ["id"], "additionalProperties": false}, "free": false}, {"name": "nabavnik_buyer", "path": "/api/v1/nabavnik_buyer", "description": "One public buyer by registry number (matična številka): what it buys under the threshold year by year, from whom, how open it is to new suppliers, its open calls and its tenders; `things`: what it buys by name; `context` and `done_on`: what it does, on what, in which phase and field; `works_need`: what the contractors of its works need.", "arguments": {"type": "object", "properties": {"id": {"type": "string", "description": "The buyer's registry number, from nabavnik_search or another tool's result."}, "limit": {"type": "integer", "minimum": 1, "maximum": 120}}, "required": ["id"], "additionalProperties": false}, "free": false}, {"name": "nabavnik_supplier", "path": "/api/v1/nabavnik_supplier", "description": "One supplier by its slug: to which public buyers it sells without a tender, what, the tenders it won and the open calls of its buyers. A person in business (s.p.) has no name here.", "arguments": {"type": "object", "properties": {"slug": {"type": "string", "description": "The supplier's slug, from nabavnik_search or another tool's result."}}, "required": ["slug"], "additionalProperties": false}, "free": false}, {"name": "nabavnik_next_buyers", "path": "/api/v1/nabavnik_next_buyers", "description": "Whom a firm should sell to next: the public buyers it does not sell to yet, ranked by the model `next` (a new tie within the year), each with reasons (alike its buyers, spends on its kind of thing, its region, open to new suppliers), what the buyer buys of that kind now and from whom, the months it pays, its open calls; `already_pay_a_little`: buyers that pay it small sums under what the yearly lists show and can grow; `became_buyers_this_year`: suggestions that already came true; `room_at_own_buyers`: its own buyers that buy its kind of thing from others too; and `defend`: the firm's own buyers whose tie frays. The firm must already sell to the public sector; for a newcomer use nabavnik_who_buys with sort=chance.", "arguments": {"type": "object", "properties": {"slug": {"type": "string", "description": "The supplier's slug, from nabavnik_search."}, "limit": {"type": "integer", "minimum": 1, "maximum": 20}}, "required": ["slug"], "additionalProperties": false}, "free": false}, {"name": "nabavnik_search", "path": "/api/v1/nabavnik_search", "description": "Find a public buyer or a firm by a piece of its name or its registry number. Returns ids and slugs for the other tools.", "arguments": {"type": "object", "properties": {"q": {"type": "string"}}, "required": ["q"], "additionalProperties": false}, "free": true}, {"name": "nabavnik_open_calls", "path": "/api/v1/nabavnik_open_calls", "description": "Public calls for tenders that take bids today, the nearest deadline first, by kind, words or region.", "arguments": {"type": "object", "properties": {"what": {"type": "string", "description": "A kind of purchase by its id (see nabavnik_kinds, e.g. ciscenje, programska, zivila) or free words in Slovenian (e.g. »licence«, »toner«)."}, "q": {"type": "string", "description": "Words of the title or of the buyer's name."}, "region": {"type": "string", "description": "A statistical region of Slovenia in Slovenian, lower case (e.g. gorenjska, osrednjeslovenska); leave out for the whole country."}, "limit": {"type": "integer", "minimum": 1, "maximum": 200}}, "required": [], "additionalProperties": false}, "free": true}, {"name": "nabavnik_call", "path": "/api/v1/nabavnik_call", "description": "The life of one open call: what was before (earlier awards of the same job, purchases without a tender), what is known now, and what the models expect: its value, whether one bid will come, who is likely to bid and win, what the winner will need and who sells that, when it will be decided and when it comes round again. Each prediction names its model and its reasons.", "arguments": {"type": "object", "properties": {"call": {"type": "integer", "description": "The call's number on the procurement portal, from nabavnik_open_calls."}, "lot": {"type": "integer", "minimum": 1}}, "required": ["call"], "additionalProperties": false}, "free": false}, {"name": "nabavnik_graph", "path": "/api/v1/nabavnik_graph", "description": "The neighbourhood of a buyer or a supplier in the knowledge graph: edges by kind (buys without a tender, awarded a tender, open call, expected call, likely bidder) with weights.", "arguments": {"type": "object", "properties": {"type": {"type": "string", "enum": ["narocnik", "dobavitelj"], "description": "narocnik = a buyer (key: registry number), dobavitelj = a supplier (key: slug)."}, "key": {"type": "string"}}, "required": ["type", "key"], "additionalProperties": false}, "free": false}, {"name": "nabavnik_models", "path": "/api/v1/nabavnik_models", "description": "The models behind the predictions: what each answers (kdo = who, kaj = what, kdaj = when), which service trains it, when it last learned and how it measured on data it had not seen. Read this before relying on a probability.", "arguments": {"type": "object", "properties": {}, "required": [], "additionalProperties": false}, "free": true}, {"name": "nabavnik_kinds", "path": "/api/v1/nabavnik_kinds", "description": "The kinds of purchase (id and Slovenian label) and the regions that the other tools take.", "arguments": {"type": "object", "properties": {}, "required": [], "additionalProperties": false}, "free": true}], "mcp": "/mcp (POST, the same key)", "how": "/agenti"}