HowToServer MCP pentru date din România
Dai agentului tău AI acces la date despre firme din România, dosare în instanță, unelte e-Factura și legislația în vigoare printr-un singur server MCP remote. Streamable HTTP, autentificare cu cheie bearer, 18 tool-uri și aceleași credite per apel ca API-ul REST.
Exemplu curl
curl -X POST "https://api.howtoromania.io/mcp" -H "content-type: application/json" -H "accept: application/json, text/event-stream" -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
Cheie gratuită: curl -X POST https://api.howtoromania.io/v1/keys -H "content-type: application/json" -d '{"email":"you@example.com","accept_terms":true}'
Exemplu MCP
{ "mcpServers": { "howtoromania": { "url": "https://api.howtoromania.io/mcp", "headers": { "Authorization": "Bearer htr_demo" } } } }
Cere agentului: “Listează reprezentanții legali ai CUI 14399840 și rolurile lor, apoi verifică dacă are dosare pe rol.”
Cum îl conectezi
Adaugi configurația de mai sus în clientul MCP. Merge cu orice client care acceptă servere remote prin streamable HTTP: Claude Desktop și claude.ai, conectorii ChatGPT, Cursor, Cline, VS Code și altele. Înlocuiește htr_demo cu cheia ta pentru tool-urile pe care cheia demo nu le acoperă.
Lista completă a celor 18 tool-uri este în documentație și pe pagina în engleză.
Endpoint-uri și prețuri
| Serviciu | Endpoint | Credite | ≈ EUR |
|---|---|---|---|
| Company lookup ANAF registry data by CUI/VAT id: name, address, status, VAT, e-Factura, BNR EUR/RON | GET /v1/company/{cui}MCP lookup_company | 1 | €0.005 |
| Financial statements Up to 5 years of filed accounts + ratios (RON) | GET /v1/company/{cui}/financialsMCP get_company_financials | 3 | €0.015 |
| Legal representatives (ONRC) Trade-register status, CAEN codes, representatives (name, role) | GET /v1/company/{cui}/representativesMCP get_company_representatives | 5 | €0.025 |
| Risk report (KYB) Status + financials + court cases + registry, score 0-100 with explained flags | GET /v1/company/{cui}/risk-reportMCP get_company_risk_report | 30 | €0.150 |
| Company court cases Cases where the company is a party (portal.just.ro), summary + list | GET /v1/company/{cui}/court-casesMCP get_company_court_cases | 15 | €0.075 |
| Court case by number Parties, hearings, outcomes, appeals | GET /v1/court-cases/{caseNumber}MCP get_court_case | 1 | €0.005 |
| Validate invoice XML validated with ANAF's public validation service (CIUS-RO) + local checks, rule codes | POST /v1/efactura/validateMCP validate_efactura | 1 | €0.005 |
| Generate invoice XML CIUS-RO UBL from simple JSON; parties auto-filled from CUI; validated with ANAF's public validation service | POST /v1/efactura/generateMCP generate_efactura | 2 | €0.010 |
| Search acts By citation ('Legea 31/1990') or title words | GET /v1/legislation/searchMCP search_legislation | 1 | €0.005 |
| Article (in force) One article + dated amendment notes | GET /v1/legislation/act/{id}/article/{n}MCP get_legal_article | 1 | €0.005 |
Pachete preplătite (TVA inclus): €5 = 1,000 · €20 = 5,000 · €100 = 30,000 credits. 100 credite gratuite per cheie, fără contract.
De ce HowToRomania
- JSON în engleză, gata de folosit de agenți AI și de cod
- Firme, dosare în instanță, e-Factura și legislație în vigoare într-un singur API
- REST și server MCP remote cu aceleași chei
- Plată per apel (1 credit = 0,005 €, pachetul minim), fără contract; erorile și indisponibilitatea sursei nu se taxează (raportul de risc parțial se taxează integral)
- 100 de credite gratuite la fiecare cheie
- Abonamente pentru volume mari, la cerere: hello@howtoromania.io.
Întrebări frecvente
Am nevoie de cheie?
Listarea tool-urilor nu cere cheie. Apelarea lor cere o cheie: cheia demo pentru tool-urile incluse în ea (lookup_company, get_court_case, validate_efactura, parse_efactura, search_legislation, get_legal_article, get_new_legal_acts) sau o cheie gratuită cu 100 de credite.
Cât costă?
Plătești per apel reușit, în credite (1 credit = 0,005 €, pachetul minim). Fiecare cheie primește 100 de credite gratuite. Pachete: 5 € = 1.000 credite, 20 € = 5.000 credite, 100 € = 30.000 credite. Preplătit, fără contract; erorile, „negăsit” și apelurile la care sursa (ex. ANAF) nu răspunde nu se taxează. Un raport de risc cu secțiuni indisponibile se taxează integral.
Pot testa fără cont?
Da. Cheia demo htr_demo merge, cu o limită zilnică per IP, pe căutarea firmei după CUI, dosarul după număr, validarea și parsarea e-Factura, căutarea în legislație, articolele în vigoare și actele noi. O cheie gratuită cu 100 de credite se obține cu un singur POST la /v1/keys.
Este un serviciu oficial ANAF?
Nu. HowToRomania este un serviciu independent care preia surse publice (ANAF, date deschise ONRC, BNR, portal.just.ro, legislatie.just.ro) și le livrează ca JSON. Nu este afiliat sau aprobat de vreo autoritate. Doar informativ; nu este consultanță juridică sau de credit.