MCP > Tool-uri

Tool-uri

Asistentul alege singur ce tool apelează. Lista de mai jos e utilă dacă vrei să știi ce poate face sau construiești propriul client. Toate tool-urile doar citesc date.

TOOLlist_metricsPublic

Listează toate metricile disponibile, cu numele de folosit în get_metric_datapoints.

Exemplu de apel
Copiază
{
  "name": "list_metrics",
  "arguments": {}
}

Parametri

Fără parametri.

Întoarce

Pentru fiecare metrică: numele, eticheta în română, categoria, unitatea, descrierea, sursele, agregarea implicită, sumele cumulate permise și dacă există doar la nivel național. Plus regulile de interpretare a datelor.
TOOLlist_regionsPublic

Listează toate regiunile: țara, zonele și județele.

Exemplu de apel
Copiază
{
  "name": "list_regions",
  "arguments": {}
}

Parametri

Fără parametri.

Întoarce

Pentru fiecare regiune: slug-ul, numele în română, tipul și dacă are prețuri cerute, cu orașul la care se referă (pentru Ilfov, București).
TOOLget_metric_datapointsPublic

Întoarce o metrică pentru o regiune în timp, cu variația față de anul trecut și față de perioada anterioară. Metricile macroeconomice vin mereu pentru România.

Exemplu de apel
Copiază
{
  "name": "get_metric_datapoints",
  "arguments": {
    "metric_name": "transactions_count_individual_units",
    "region_name": "cluj",
    "aggregation_interval": "year",
    "time_range": "5Y"
  }
}

Parametri

metric_namestringobligatoriu
Numele metricii, din list_metrics.
region_namestringobligatoriu
Slug-ul regiunii, din list_regions: romania pentru toată țara sau un județ, de exemplu bucuresti, cluj, iasi.
aggregation_intervalstringopționalimplicit month
Intervalul de agregare: month, quarter, half sau year.
time_rangestringopționalimplicit 3Y
Cât de departe în urmă: 3Y, 5Y, 10Y, 15Y sau 20Y.
rolling_sumstringopțional
Sumă cumulată pe ultimele 3, 6 sau 12 perioade, doar pentru metricile care o permit.

Întoarce

Metrica, regiunea, unitatea, sursele și lista de valori pe perioade, plus source_url, adresa acelorași date pe Minside.
TOOLcalculate_inflation_adjusted_pricePublic

Ajustează un preț imobiliar din trecut cu inflația (indicele IPC de la INS) și arată cum s-ar fi mișcat același preț cu salariul mediu net și cu prețurile cerute pe m² din județ. Nu este o evaluare a locuinței.

Exemplu de apel
Copiază
{
  "name": "calculate_inflation_adjusted_price",
  "arguments": {
    "price_eur": 85000,
    "month": "2018-06",
    "region_name": "cluj"
  }
}

Parametri

price_eurnumberobligatoriu
Prețul din trecut, în euro.
monthstringobligatoriu
Luna în care a fost stabilit prețul, YYYY-MM, înainte de ultima lună IPC publicată.
region_namestringobligatoriu
Slug-ul județului din list_regions, sau romania. Se folosește pentru comparațiile cu salariile și prețurile cerute.

Întoarce

Prețul ajustat cu inflația și inflația cumulată până la ultima lună publicată, plus creșterea și prețul ajustat după salariu și după prețurile cerute la apartamente (toate, noi, vechi), cu regiunea folosită, și source_url, adresa calculatorului pe Minside.
TOOLcalculate_rental_yieldPublic

Calculează randamentul brut din chirie și perioada de amortizare a unei locuințe de închiriat, din prețul de achiziție și chiria lunară. Cifre brute, fără taxe, întreținere sau finanțare.

Exemplu de apel
Copiază
{
  "name": "calculate_rental_yield",
  "arguments": {
    "purchase_price_eur": 120000,
    "monthly_rent_eur": 600
  }
}

Parametri

purchase_price_eurnumberobligatoriu
Prețul de achiziție, în euro.
monthly_rent_eurnumberobligatoriu
Chiria lunară brută estimată, în euro.

Întoarce

Chiria anuală brută, perioada de amortizare în ani și randamentul brut în procente, cu reperele uzuale (aproximativ 14–16 ani, cel puțin 6–7%), și source_url, adresa calculatorului pe Minside.
TOOLget_mortgage_termsCont Minside

Întoarce dobânzile și condițiile actuale ale creditelor ipotecare, pentru fiecare bancă. Se întoarce mereu doar cea mai recentă variantă a fiecărei bănci.

Exemplu de apel
Copiază
{
  "name": "get_mortgage_terms",
  "arguments": {
    "banks": [
      "bcr",
      "ing"
    ]
  }
}

Parametri

banksstring[]opțional
Id-urile băncilor. Dacă lipsește, vin toate băncile. Valori posibile: banca_transilvania (Banca Transilvania), bcr (BCR), brd (BRD), ing (ING), raiffeisen (Raiffeisen Bank), unicredit (UniCredit Bank), cec (CEC Bank), exim (Exim Banca Românească), garanti (Garanti BBVA), libra (Libra Internet Bank), intesa (Intesa Sanpaolo), procredit (ProCredit Bank), patria (Patria Bank), vista (Vista Bank), nexent (Nexent Bank).

Întoarce

Pentru fiecare bancă: id-ul, numele, site-ul, data de la care se aplică (valid_from) și condițiile în markdown, în română: produsele cu dobânzile lor, apoi condițiile generale.