Documentație

Server MCP

Conectează Claude, Cursor sau orice client MCP la datele Datero: setup pe client, autentificare și lista tool-urilor.

Datero expune un server MCP (Model Context Protocol) — agenții AI folosesc API-ul ca set de tool-uri, fără să scrie cod HTTP. Serverul rulează pe Streamable HTTP:

https://api.datero.ro/mcp

Fiecare tool MCP este aceeași operație ca endpoint-ul REST echivalent: aceeași validare, același cost în credite, aceleași limite, același contor per organizație.

Conectare din clienți

Claude (claude.ai / Claude Desktop): Settings → Connectors → Add custom connector → URL: https://api.datero.ro/mcp. Autorizarea OAuth pornește automat.

Claude Code:

claude mcp add --transport http datero https://api.datero.ro/mcp

Cursor / VS Code (sau orice client cu config JSON):

{
  "mcpServers": {
    "datero": {
      "url": "https://api.datero.ro/mcp"
    }
  }
}

Acces programatic (fără OAuth): trimite cheia API în header:

{
  "mcpServers": {
    "datero": {
      "url": "https://api.datero.ro/mcp",
      "headers": { "Authorization": "Bearer dat_live_CHEIA_TA" }
    }
  }
}

Tool-uri disponibile

Tool Ce face Cost Docs
get_company Get a company by CUI 1 credit detalii
search_companies Search companies 1 credit detalii
search_caen_codes Search the CAEN Rev.3 classification gratuit detalii
get_caen_code Get a CAEN code with hierarchy and Rev.2 mapping gratuit detalii
search_counties List / search Romanian counties (județe) gratuit detalii
search_cities Search Romanian localities (localități) gratuit detalii
get_fx_rates BNR exchange rates for one day gratuit detalii
get_fx_rate_history BNR exchange-rate history for one currency gratuit detalii
convert_currency Convert an amount between currencies at the BNR rate gratuit detalii

Lista de mai sus este generată din același registru care servește API-ul — un tool nou apare aici automat. Costurile și creditele rămase vin pe fiecare răspuns în _meta.creditsUsed / _meta.creditsRemaining.