# HowToRomania

> Data from Romanian public registries for AI agents: companies (ANAF, ONRC), courts, e-Factura, legislation. REST + MCP. Prepaid credits, 1 credit = €0.005 at the smallest pack, 100 free credits.

Base URL: https://api.howtoromania.io · MCP (streamable HTTP): https://api.howtoromania.io/mcp · OpenAPI: https://api.howtoromania.io/openapi.json · Docs: https://api.howtoromania.io/docs

## Services (credits per successful call)
- GET /v1/company/{cui} · MCP lookup_company · 1 cr · ANAF registry data by CUI/VAT id: name, address, status, VAT, e-Factura, BNR EUR/RON
- GET /v1/company/{cui}/financials · MCP get_company_financials · 5 cr · Up to 5 years of filed accounts + ratios (RON)
- GET /v1/company/{cui}/representatives · MCP get_company_representatives · 2 cr · Trade-register status, CAEN codes, representatives (name, role)
- GET /v1/company/{cui}/risk-report · MCP get_company_risk_report · 8 cr · Status + financials + court cases + registry, score 0-100 with explained flags
- GET /v1/company/{cui}/court-cases · MCP get_company_court_cases · 3 cr · Cases where the company is a party (portal.just.ro), summary + list
- GET /v1/court-cases/{caseNumber} · MCP get_court_case · 1 cr · Parties, hearings, outcomes, appeals
- POST /v1/efactura/validate · MCP validate_efactura · 1 cr · validated with ANAF's public validation service (CIUS-RO) + local checks, rule codes
- POST /v1/efactura/generate · MCP generate_efactura · 2 cr · CIUS-RO UBL from simple JSON; parties auto-filled from CUI; validated with ANAF's public validation service
- POST /v1/efactura/parse · MCP parse_efactura · 1 cr · UBL Invoice/CreditNote -> English JSON
- POST /v1/efactura/pdf · MCP efactura_to_pdf · 1 cr · rendered with ANAF's public PDF service
- GET /v1/legislation/search · MCP search_legislation · 1 cr · By citation ('Legea 31/1990') or title words
- GET /v1/legislation/act/{id} · MCP get_legal_act · 1 cr · Current consolidated text, split by article
- GET /v1/legislation/act/{id}/article/{n} · MCP get_legal_article · 1 cr · One article + dated amendment notes
- GET /v1/legislation/act/{id}/history · MCP get_legal_act_history · 2 cr · Consolidation dates, dated amendments per article
- GET /v1/legislation/new · MCP get_new_legal_acts · 1 cr · Acts in force since a date (max 35 days)

## Pricing
€5 = 1,000 credits (€0.005/credit) · €20 = 5,000 · €100 = 30,000. 100 free credits per key. Errors and not-found are never billed.

## Keys
- Free key (100 credits): POST https://api.howtoromania.io/v1/keys {"email":"you@example.com","accept_terms":true} → {"apiKey":"htr_…"} (shown once)
- Public demo key: `htr_demo`, no signup, 20 calls/day per IP, only: company.lookup, court.case, efactura.validate, efactura.parse, legislation.search, legislation.article, legislation.new
- Send as `x-api-key: <key>` or `Authorization: Bearer <key>`. MCP initialize/tools/list work without a key.
- Out of credits → HTTP 402 with checkout links. Balance: GET /v1/me. Prices: GET /v1/pricing.