DataDriven API — Documentație tehnică

Unelte MCP disponibile

Server-ul MCP la https://api.datadriven.ro/mcp expune următoarele unelte cu descrieri optimizate pentru consum LLM. Definițiile complete sunt în mcp-tools.yaml.

Cont

get_me

Identitatea proiectului asociat cheii: { projectId, projectName }.

get_usage

Contorul de retrieve-uri + creditele de overflow + starea limitei de operațiuni: callsCap = max(callsCapFloor, creditsUsedThisCycle × callsPerCredit) — fiecare credit folosit ridică limita de apeluri cu 500. Ciclurile sunt ancorate pe ziua de plată Stripe.

Licitații — listări

list_monitored_tenders

Licitațiile care matchează criteriile proiectului (CPV/cuvinte cheie/autorități) — același feed ca Monitorizare Licitații. Include overlay tags/color/comment.

list_saved_tenders

Licitațiile salvate (bookmarked) în proiect — același set ca meniul Salvate. Include și licitațiile expirate.

list_all_tenders

Caută/listează în întreg corpusul (Toate Licitațiile) — fără filtre de monitorizare, fără overlay. Căutarea text acoperă și numele autorității și CUI-ul; rezultatele text sunt ordonate după relevanță.

Licitații — detalii

get_tender_by_id

Obiectul complet (NoticeComplete) după id-ul intern — loturi, atribuiri, attachments cu SAS, AI, plus overlay tags/color/comment. Consumă 1 full-retrieval per ciclu (deduplicat).

get_tender_by_notice

Aceeași licitație după numărul public SEAP/SICAP (ex. SCN1174909). Aceeași limită.

get_tender_history

Date pentru panoul Istoric: licitații similare ale autorității + top furnizori pe acel CPV/categorie. Nu intră în limită.

Licitații — text din documente

Toate trei împart același pool de deduplicare cu get_tender_by_id: dacă ai cerut deja licitația în acest ciclu, sunt gratuite.

get_tender_toc

Cuprins structurat — fișiere + capitole (opțional subcapitole) cu interval de pagini. Outline compact (~1-3 KB) sau JSON. maxDepth 1/2/3, format outline/json. Pasul de start când întrebarea e despre conținut — folosește id-ul de capitol în get_tender_markdown.

get_tender_markdown

Markdown curățat pagină cu pagină pentru un attachment — tabele reconstruite, headinguri intacte. Adresare prin chapterId (din TOC) sau attachmentId + pageStart/pageEnd. Buget 60 000 caractere cu paginare.

get_tender_pages

Textul OCR-uit din attachments, paginat (pages.json). Răspuns tăiat la ~60 000 caractere cu nextPage/nextAttachment pentru a continua.

download_tender_pages

URL SAS 15-min către pages.json + preview per-attachment (totalPages + primele 200 caractere). Pentru agenți cu acces filesystem care vor să descarce și să grep-uiască local.

find_in_tender

Căutare în textul attachment-urilor. Trei moduri: substring (literal, default — pentru coduri/cifre/date exacte), semantic (vector search cu multilingual-e5-base, INT8 CPU — pentru întrebări în limbaj natural, rezolvă morfologie și sinonime), hybrid (substring + semantic combinate). Modurile semantice cer ca licitația să fi trecut prin pipeline-ul structured-MD.

get_tender_attachments

Lista attachment-urilor cu link-uri de descărcare: originalUrl (fișierul brut) și searchableUrl (PDF OCR-uit, text selectabil), arhivele zip (originale + searchable) și pagesJsonUrl (textul extras pagină cu pagină). Pentru când utilizatorul cere fișiere, PDF-uri sau „textul licitației”.

get_attachment_image

Randează paginile unui PDF în imagini (JPEG base64) returnate inline, ca modelul să vadă pagina originală — pentru scanuri, ștampile sau tabele care nu s-au extras curat ca text. Funcționează și în clienți sandboxed (claude.ai, mobil). Max 5 pagini/apel, dpi 72–150 (default 130). MCP-only. Împarte pool-ul de deduplicare byId.

Atribuiri

search_awards_full

Aceeași căutare ca meniul Atribuiri — toate filtrele (CPV, categorie, zonă, autoritate, companie, date, valori) plus flag-urile applyMonitoringCriteria și onlyOngoingAcquisitions.

Companii

get_company

Identitate + statistici precomputate din tabelul companyStats (valori câștigate, număr loturi, top autorități, top competitori). Două citiri punctuale, fără agregare on-the-fly.