HowToRomania
Romanian company, court, e-Factura and legislation data for agents, billed in credits
- Pricing
- Freemium
- Platforms
- API
- Runs
- Remotely
- Version
- 0.5.1
- Listing updated
- 3 days ago
About HowToRomania
HowToRomania is a freemium MCP server for legal and government. It runs as a hosted remote server, so there is nothing to install locally.
Built for KYB, invoicing and compliance work, this server returns data from Romanian public registries as English JSON. Company lookup by CUI or VAT id draws on ANAF, financial statements cover up to five years in RON, and the ONRC tool returns trade-register status, CAEN codes and legal representatives. A risk report scores a company from 0 to 100 with explained flags, and court tools list a company's cases or fetch one case by number.
For invoicing it validates, generates, parses and converts CIUS-RO e-Factura XML to PDF. Legislation tools search laws, fetch an act or article, show an act's history and list new acts. BNR exchange rates, ROBOR, IRCC and identifier format checks are free. A tool can verify extracted company data against ANAF and ONRC and return pass, review or reject for each field.
About 16 services are paid per successful call; errors and source outages are not billed, though a risk report with missing sections is.
Install
Run in a terminal
claude mcp add --transport http api https://api.howtoromania.io/mcpAdd to Settings → Connectors → Add custom connector
https://api.howtoromania.io/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"api": {
"url": "https://api.howtoromania.io/mcp"
}
}
}Add to .vscode/mcp.json
{
"servers": {
"api": {
"type": "http",
"url": "https://api.howtoromania.io/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"api": {
"serverUrl": "https://api.howtoromania.io/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"api": {
"type": "http",
"url": "https://api.howtoromania.io/mcp"
}
}
}Tools this server provides (20)
Read directly from the server.
- lookup_company
- Given a Romanian CUI/CIF (fiscal code, optionally prefixed RO), returns ANAF public registry data in English: name, addresses, trade register number, VAT status, active/inactive, e-Factura registration, plus the BNR EUR/RON rate.
- get_company_financials
- Annual financial statements filed with ANAF for a Romanian company (by CUI), in English: net turnover, revenue, expenses, gross/net profit (negative = loss), employees, assets, cash, debts, equity, plus net margin, debt-to-equity, ROE/ROA and YoY revenue growth. Amounts in RON. Costs 3 credits; not billed if nothing is found.
- get_company_court_cases
- Court cases (portal.just.ro, Ministry of Justice) where a Romanian company (by CUI) is a party: summary (total, by category/stage/company role, pending vs decided, insolvency) and a case list with court, subject, stage, company role, other parties and last/next hearing. Natural persons are masked (GDPR). Criminal cases show only category, stage, dates and the company's own role (criminalDetailsWit
- get_court_case
- Full detail of a Romanian court case by its number (e.g. 9430/271/2025) from portal.just.ro: court, subject, stage, parties with roles (natural persons masked), all hearings with outcomes, and appeals. Criminal cases return only category, stage and dates (criminalDetailsWithheld: true). Costs 1 credit; not billed if not found.
- get_company_risk_report
- One-call due-diligence report for a Romanian company (by CUI): ANAF status (active/inactive, VAT, e-Factura), last 3 years of financials, court-case summary (portal.just.ro) and ONRC registry data when available, with a transparent rule-based score 0-100 (higher = fewer risk signals) and explained flags. Informational only, NOT credit advice. Costs 30 credits once for this call; the included finan
- get_company_representatives
- Trade-register data for a Romanian company (by CUI) from the ONRC monthly open-data snapshot: registration number, EUID, legal form, registry status (decoded), authorized CAEN codes and legal representatives (names and roles, e.g. administrator, lichidator). Costs 5 credits; not billed if the CUI is not found.
- validate_extracted_company_data
- Checks company data an AI extracted from an invoice, contract or form against Romanian public sources (ANAF, ONRC) and checksums. Returns a verdict and the registered value per field (CUI, name, registration number, VAT status, company status, address, IBAN, legal representative), optional invoice arithmetic checks, and a deterministic confidence score with pass / review / reject. Use before savin
- check_identifier_format
- Free, local-only checks with no registry lookup: CUI checksum, IBAN checksum (and Romanian bank from the code), trade register number format (old and new), company name normalization, and invoice arithmetic (total = net + VAT, Romanian VAT rates, date not in the future). Does not check that the company exists; the last digit of new-format registration numbers (e.g. J2020001234400) is not verified.
- validate_efactura
- Validates a UBL 2.1 invoice/credit note against RO e-Factura rules (CIUS-RO) using ANAF's public validation service (XSD + Schematron, no ANAF account needed) plus fast local checks (totals, VAT breakdown, CUI checksums, RO county codes, Bucharest SECTORn). Returns valid true/false and the exact rule codes (BR-xx, BR-RO-xx) with English/Romanian messages. Costs 1 credit; not billed if ANAF is unre
- generate_efactura
- Builds a valid RO e-Factura (CIUS-RO 1.0.1, UBL 2.1) invoice XML from simple JSON: seller/buyer (just the CUI is enough: name, address, county code and VAT status are auto-filled from ANAF), lines with quantity, unit price and VAT rate (default 21%; categories S, Z, E, AE reverse charge, K, G, O not subject). Computes line, VAT and grand totals and returns the XML plus ANAF's validation verdict (p
- parse_efactura
- Turns a UBL 2.1 e-Factura invoice or credit note XML (e.g. downloaded from ANAF SPV) into clean English JSON: number, dates, type, currency, seller/buyer (name, VAT id, CUI, address, contact), payment means and IBAN, lines (name, quantity, unit, price, net, VAT), VAT breakdown and totals. Costs 1 credit; not billed on errors.
- efactura_to_pdf
- Renders a valid e-Factura XML as PDF using ANAF's public transformation service (no ANAF account). Returns the PDF as a base64 resource. The XML must pass validation. Costs 1 credit; not billed on errors.
- search_legislation
- Finds Romanian normative acts on legislatie.just.ro by citation or title words: 'Legea 31/1990', 'OUG 195/2002', 'HG 1/2016', 'Codul fiscal', 'Codul muncii', or words from the title. Ranked so the main act comes first (codes and laws before decrees/orders). Returns act ids for get_legal_act / get_legal_article. Costs 1 credit; not billed if nothing matches. Source: legislatie.just.ro (Ministry of
- get_legal_act
- Current consolidated text of a Romanian act by legislatie.just.ro id (from search_legislation), split by article: title, issuer, publication, consolidation date, version list and articles (number, heading, text, count of amendments). Paged with offset/limit (default 50 articles). Core codes (Codul fiscal 171282, Codul muncii 41627, Codul civil 175630, Codul de procedură civilă 140271, Codul de pro
- get_legal_article
- One article in its current consolidated form, e.g. Codul fiscal (171282) art. 291 (VAT rates), with paragraph/letter structure and dated amendment notes (what changed it and when). Article numbers like '293^1' are supported. Costs 1 credit; not billed if not found. Source: legislatie.just.ro (Ministry of Justice); informational, consolidated forms are unofficial, only Monitorul Oficial text is aut
- get_legal_act_history
- Consolidation dates (with version ids) and the dated list of amendments for a whole act or one article: date in force, what was changed and by which act. Useful for 'what was the VAT rule on date X'. Costs 2 credits; not billed if not found. Source: legislatie.just.ro (Ministry of Justice); informational, consolidated forms are unofficial, only Monitorul Oficial text is authentic.
- get_new_legal_acts
- Acts newly indexed by legislatie.just.ro (laws, government ordinances and decisions, ministerial orders, court decisions published in Monitorul Oficial) with an in-force date on/after `since` (default: last 7 days, max 35). Costs 1 credit. Source: legislatie.just.ro (Ministry of Justice); informational, consolidated forms are unofficial, only Monitorul Oficial text is authentic.
- get_bnr_exchange_rate
- BNR reference exchange rates in RON from 2005-01-03: one date (latest fixing on/before the date; all currencies or one), or a daily series for one currency with from/to (max 366 days). Free (0 credits); works without an API key (keyless calls are rate-limited per IP). Source: Banca Națională a României (bnr.ro); informational, values unchanged from BNR source.
- get_robor
- ROBOR (offered) and ROBID (bid) fixings, % p.a., tenors ON, 1W, 1M, 3M, 6M, 12M, from 1995-08-01: one date (latest fixing on/before) or a series for one tenor with from/to (max 366 days). Free (0 credits); works without an API key (keyless calls are rate-limited per IP). Source: Banca Națională a României (bnr.ro); informational, values unchanged from BNR source.
- get_ircc
- IRCC (indicele de referință pentru creditele consumatorilor), % p.a.: the quarterly value applicable on a date (plus the next quarter's if published) and the latest daily value; or history (type daily with from/to, or quarterly). Free (0 credits); works without an API key (keyless calls are rate-limited per IP). Source: Banca Națională a României (bnr.ro); informational, values unchanged from BNR
What it does
- Company lookup
- ANAF data by CUI or VAT id with status, address and e-Factura flag.
- KYB risk report
- Score from 0 to 100 combining status, financials and court cases.
- Court case access
- Search a company's cases or fetch one by number.
- e-Factura toolkit
- Validate, generate, parse and render CIUS-RO invoices.
- Legislation tools
- Search laws and read acts, articles and history.
- Data verification
- Checks extracted company fields and returns pass, review or reject.
Good for
- Run a KYB check on a Romanian supplier
- Validate an e-Factura invoice before sending
- Check extracted invoice data against the registries
- Look up the law in force on a topic
Pricing
Freemium
100 free credits per key; 1 credit = EUR 0.005 in the smallest pack
Prices change. Check howtoromania.io before you buy.
HowToRomania FAQ
What does a call cost?
1 credit is 0.005 euro in the smallest pack; company lookup is 1 credit and a risk report is 30.
Is there a free tier?
Each key gets 100 free credits, and a demo key allows limited daily calls on some services.
Are failed calls billed?
No for errors, not-found and source outages, but a partial risk report is billed in full.
Which tools are free?
BNR rates, ROBOR, IRCC and check_identifier_format.
Is HowToRomania free?
HowToRomania has a free plan, with paid plans for more usage or features.
How do I add HowToRomania to Claude Code?
Run this command in your terminal: claude mcp add --transport http api https://api.howtoromania.io/mcp
What are the best alternatives to HowToRomania?
The closest alternatives to HowToRomania are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Tapetide - Indian Stock Market MCP, World Monitor and CompanyData.
Alternatives to HowToRomania

Agent-Native Analytics
MCP serverOpen-source analytics app where an AI agent builds charts and dashboards from your data
- Remote
- Open source
- 7.7K GitHub stars
- Analytics and data

Google Ads + Meta Ads + SEO/GEO MCP
MCP serverHosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat
- 8 tools
- Remote
- Freemium
- 8.1K GitHub stars
- Marketing and SEO

Tapetide - Indian Stock Market MCP
MCP serverIndian NSE and BSE stock market data for AI assistants through 48 MCP tools
- 17 tools
- Remote
- Freemium
- 150 GitHub stars
- Finance and payments

World Monitor
MCP serverLive geopolitical intelligence dashboard with an API and MCP server for agents
- Remote
- Freemium
- Analytics and data

CompanyData
MCP serverSearch and enrich company records from official registers via the CompanyData API
- 3 tools
- Remote
- Paid
- 3 GitHub stars
- Analytics and data

NY LLC Publication (FileMyPublication)
MCP serverNew York LLC publication rules, deadline, county prices, clerks and notice text
- 8 tools
- Remote
- Free
- Legal and government