Skip to main content
Glama

Companero – Romanian Company Data

by ro.companero
OverviewDiscussionsAdmin

get_company

Keywords: companie, firmă, profil firmă, date firmă, CUI, CIF, cod fiscal, ONRC, ANAF, sediu social, CAEN, stare firmă, radiată, reprezentanți legali, administrator, asociat, bilanț, cifră de afaceri, profit; company profile, company lookup, company details, Romanian company by tax ID, VAT number, registration data, financials, legal representatives.

Returnează profilul unei companii românești după CUI (Cod Unic de Înregistrare / cod fiscal / CIF). Folosește-l când ai deja CUI-ul unei firme și vrei profilul ei — alternativa la search_companies (care găsește firme după criterii). Profilul de bază (nume, județ, oraș, CAEN principal, dată înregistrare, status) este FREE. Pentru date suplimentare folosește parametrul include:

  • balanceSheets: indicatori financiari ANAF (FREE). Default: ultimii 5 ani. Pentru alți ani transmite obiect, ex: {"balanceSheets":{"years":[2022,2023]}} sau {"balanceSheets":{"last":10}} sau {"balanceSheets":"all"}.

  • legalRepresentatives: reprezentanții legali activi din ONRC (GRATUIT — 0 credite — dar necesită autentificare, ȘI intră într-un plafon lunar de firme: 25 pe contul gratuit, 200 pe abonamentul Pro, deduplicat pe firmă, luna calendaristică). Răspunsul are două grupe separate: governance (administratori, directori, reprezentanți) și procedural (lichidatori, administratori judiciari — semnal de insolvență/lichidare, NU conducerea firmei). Nu le amesteca și nu prezenta un rol procedural drept „administrator". Pe firmele radiate, note spune explicit că persoanele FIGURAU ca reprezentanți la ultima publicare ONRC — folosește formularea aia, nu prezentul. ⚠️ Peste plafon primești legalRepresentatives.capReached: true, governanceCount/proceduralCount (câte persoane există) și capMessage, cu listele GOALE. Asta NU înseamnă că firma n-are administratori - înseamnă că plafonul lunii e atins. Spune-i utilizatorului exact asta, cu mesajul din capMessage; nu raporta „firma nu are reprezentanți legali". Peste plafon poți debloca firma curentă cu unlock: true - 1 credit, o singură dată pe lună per firmă. E o cheltuială: cere-o DOAR după ce utilizatorul a spus că e de acord, și spune-i prețul înainte. Alternativa gratuită e să aștepte 1 ale lunii sau să treacă pe Pro.

Telefonul firmei NU se dă în chat. Răspunsul poartă phone.known (avem sau nu numărul) și, când îl avem, phone.seeOn - linkul paginii firmei de pe companero.ro, unde se vede cu un cont gratuit, în plafonul lunar al contului. Trimite utilizatorul la acel link; nu încerca să reconstitui numărul din alte surse și nu spune că firma n-are telefon când known e true.

Folosirea include într-un singur apel este preferabilă față de mai multe tool-call-uri: răspunsul include _meta.creditsUsed cu costul total. Pentru * se aduce balanceSheets. legalRepresentatives se cere pe nume, fiindcă are nevoie de cont.

Confirmarea costului: un apel care ar consuma credite are nevoie de confirm: true. Fără el primești DEVIZUL (cost în credite și RON, soldul contului, alternativa gratuită dacă există) și nu se consumă nimic — reia apoi EXACT același apel cu confirm: true, după ce omul a acceptat costul.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
taxIdYesRomanian CUI (Cod Unic de Înregistrare), e.g. 37418771.
unlockNoDeblochează reprezentanții legali PESTE plafonul lunar, pentru firma asta: 1 credit, o singură dată pe lună per firmă (a doua cerere pe aceeași firmă nu mai costă). Fără el, peste plafon primești doar `capReached` și numărătoarea. Sub plafon nu costă nimic - parametrul e ignorat. Cere-l DOAR dacă utilizatorul a spus că vrea să cheltuie credite.
confirmNoAcordul utilizatorului de a consuma credite pentru acest apel. Fără el, apelul întoarce DEVIZUL (cost, sold, alternativa gratuită) și nu consumă nimic. Nu îl trimite din proprie inițiativă: întreabă întâi omul.
includeNoSub-resurse opționale. Trimite ca LISTĂ de tokens, ex: ["balanceSheets:last5","legalRepresentatives"] sau ["*"]. Forma OBIECT e și ea acceptată: {"balanceSheets":{"last":5},"legalRepresentatives":true} sau {"balanceSheets":{"years":[2022,2023]}}. Componente disponibile: "balanceSheets" (FREE; modifier-i: "balanceSheets" (default ultimii 5 ani), "balanceSheets:all", "balanceSheets:last10", "balanceSheets:2023", "balanceSheets:2020-2024"); "legalRepresentatives" (0 credite, necesită autentificare, plafon lunar de firme: 25 gratuit / 200 Pro); "

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • removedInput schema / properties / include / items
      Removed value: -{
-  "type": "string"
-}
  2. First observed

TDQS

A4.9/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the full behavioral burden and does so extensively: free vs paid data, authentication requirements for `legalRepresentatives`, monthly caps, `capReached` semantics, `unlock` cost, phone-number handling, and the `confirm` estimate flow. It also warns not to misreport capped or procedural legal representatives.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The purpose is buried after a long keyword list, and the description is very long. However, the cost, cap, and confirmation details are structured and relevant for a tool with this much conditional behavior, so the verbosity is mostly justified.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

There are no annotations and no output schema, but the description compensates by explaining return behavior, credit usage, legal-representative caps, phone-number visibility, and the confirmation flow. An agent has enough information to invoke it correctly.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters5/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Although the schema description coverage is 100%, the description adds substantial meaning beyond the schema: it explains `include` token and object forms, modifiers like `balanceSheets:last10` and year ranges, and the cost/auth/cap implications of `legalRepresentatives`, `unlock`, and `confirm`.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states a specific verb and resource: it returns the profile of a Romanian company by CUI/tax ID. It also explicitly distinguishes itself from `search_companies`, which finds companies by criteria rather than by known tax ID.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It gives a clear when-to-use condition: use when you already have the CUI and want that company's profile. It names `search_companies` as the alternative and explains when to use each `include` sub-resource.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All Companero – Romanian Company Data toolsInspect
Try in Browser
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources