# HowToRomania (remote · api.howtoromania.io)

Romanian company data, e-Factura and legislation: CUI lookup, courts, risk, invoices, laws

- Trust score: 79/100 (medium)
- Change this week: −2
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-11-04

## Components

- remote · `api.howtoromania.io`: 79/100 (this document), [markdown](https://verifymcp.io/servers/io-howtoromania-api/api.md), [page](https://verifymcp.io/servers/io-howtoromania-api/api)

## Channel facts

- Endpoint: `https://api.howtoromania.io/mcp`
- Transports: `streamable-http`
- Auth: `none`
- Version: `0.5.0`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-11-04.

- **Endpoint Security**: 80/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - No authorisation is required to call this server. Every tool declares its destructiveHint and none is destructive, so open access doesn't expose one.
  - HTTPS is enforced; there's no plaintext access path.
  - The HSTS (Strict-Transport-Security) header is present.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 66/100
  - AI-judged instruction clarity (good).
  - Context-footprint check failed: tool/resource definitions use about 3160 tokens (~158/item across 20 items; 20 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 59/100
  - Stability check failed: schema churn in the 19 days we've observed: 0 tool removals, 0 breaking changes, 1 auth/transport breaks, 5 additions.
- **Tool Coverage**: 84/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 51% of tool parameters carry a description.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - We read all 20 captured tool definition(s), and no name or description among them implies an irreversible operation.
  - An AI judge read all 20 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### How do I install the HowToRomania MCP server?

HowToRomania is a hosted endpoint at https://api.howtoromania.io/mcp, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add --transport http io-howtoromania-api 'https://api.howtoromania.io/mcp'
```

### Cursor

```json
{
  "mcpServers": {
    "io-howtoromania-api": {
      "url": "https://api.howtoromania.io/mcp"
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "io-howtoromania-api": {
      "type": "http",
      "url": "https://api.howtoromania.io/mcp"
    }
  }
}
```

### Codex

```toml
[mcp_servers.io-howtoromania-api]
url = "https://api.howtoromania.io/mcp"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "io-howtoromania-api": {
      "type": "remote",
      "url": "https://api.howtoromania.io/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add io-howtoromania-api --url 'https://api.howtoromania.io/mcp' --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  io-howtoromania-api:
    url: "https://api.howtoromania.io/mcp"
```

### Netclaw

```json
{
  "McpServers": {
    "io-howtoromania-api": {
      "Transport": "http",
      "Url": "https://api.howtoromania.io/mcp"
    }
  }
}
```

### Vellum

```bash
assistant mcp add io-howtoromania-api -t streamable-http -u 'https://api.howtoromania.io/mcp'
```

### Other

```json
{
  "mcpServers": {
    "io-howtoromania-api": {
      "type": "http",
      "url": "https://api.howtoromania.io/mcp"
    }
  }
}
```

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-11-04 (score 79, +1)

No change was recorded against any check on this day. Stability & Change Management went from 56 to 59.

### 2026-11-03 (score 78, −5)

- [security regression] Stability: 0.57 → fail
- [security improvement] Authorization: fail → partial
- [security] Tool “get_bnr_exchange_rate” rewrote its description, which is the text the model reads
- [security] Tool “get_ircc” rewrote its description, which is the text the model reads
- [security] Tool “get_robor” rewrote its description, which is the text the model reads
- [functional regression] Tool coverage: 57% → 51%
- [functional regression] Schema quality: 2752 → 3160
- [functional] New tool “check_identifier_format”
- [functional] New tool “validate_extracted_company_data”

### 2026-11-02 (score 83, +1)

No change was recorded against any check on this day. Stability & Change Management went from 53 to 57. That category is still filling its 30-day observation window: 16 days of observed history at the previous scan, 17 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-10-31 (score 82, +1)

No change was recorded against any check on this day. Stability & Change Management went from 47 to 50. That category is still filling its 30-day observation window: 14 days of observed history at the previous scan, 15 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-10-30 (score 81, 0)

- [security] Tool “generate_efactura” rewrote its description, which is the text the model reads
- [security] Tool “get_company_risk_report” rewrote its description, which is the text the model reads

### 2026-10-29 (score 81, 0)

- [functional regression] Tool coverage: 67% → 57%
- [functional regression] Schema quality: 2289 → 2722
- [functional] Schema quality: excellent → good
- [functional] New tool “get_bnr_exchange_rate”
- [functional] New tool “get_ircc”
- [functional] New tool “get_robor”

### 2026-10-28 (score 81, +1)

No change was recorded against any check on this day. Stability & Change Management went from 37 to 40. That category is still filling its 30-day observation window: 11 days of observed history at the previous scan, 12 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-10-26 (score 80, +1)

No change was recorded against any check on this day. Stability & Change Management went from 30 to 33. That category is still filling its 30-day observation window: 9 days of observed history at the previous scan, 10 at this one. The score rises as the window fills, whether or not the server changes.

## MCP tools (20)

### `lookup_company` (~105 tokens)

Look up a Romanian 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.

Input parameters:

- `cui` (string, required): Romanian CUI, e.g. 14399840 or RO14399840
- `include_fx` (boolean): Include BNR EUR/RON rate (default true)

### `get_company_financials` (~137 tokens)

Romanian company financial statements

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.

Input parameters:

- `cui` (string, required): Romanian CUI, e.g. 14399840 or RO14399840
- `years` (integer): Most recent filed years to return (default 3, max 5)

### `get_company_court_cases` (~250 tokens)

Romanian court cases of a company

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 (criminalDetailsWithheld: true). Costs 15 credits; not billed if nothing is found.

Input parameters:

- `category` (string): Filter by category, e.g. Civil, Penal, Insolventa, Contencios administrativ si fiscal
- `cui` (string, required): Romanian CUI, e.g. 14399840
- `limit` (integer): Max cases returned (default 50, max 200); summary covers all
- `role` (string): Filter by the company's role, e.g. Reclamant (plaintiff), Pârât (defendant), Debitor, Creditor
- `since` (string): Only cases registered on/after this date (YYYY-MM-DD). Default: Jan 1, three years ago

### `get_court_case` (~114 tokens)

Romanian court case by number

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.

Input parameters:

- `case_number` (string, required): Case number as shown by courts, e.g. 9430/271/2025

### `get_company_risk_report` (~167 tokens)

Romanian 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 financials, court cases and registry reads are not billed again. Not billed if the CUI is unknown. Billed in full even if some sections are unavailable (listed in unavailableSections).

Input parameters:

- `cui` (string, required): Romanian CUI, e.g. 14399840 or RO14399840

### `get_company_representatives` (~105 tokens)

Romanian company legal representatives (ONRC)

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.

Input parameters:

- `cui` (string, required): Romanian CUI, e.g. 14399840 or RO14399840

### `validate_extracted_company_data` (~202 tokens)

Check extracted Romanian company data (ANAF, ONRC)

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 saving to an ERP or paying. Costs 2 credits, +5 with legalRepresentative, +1 with invoice; not billed on errors or when ANAF is unreachable. Checked against public sources (ANAF, ONRC) and checksums. Not a KYC/AML check. A structurally valid IBAN does not prove the account belongs to the company. Always review before paying.

Input parameters:

- `asOfDate` (string): YYYY-MM-DD, default today (Europe/Bucharest)
- `invoice` (object)
- `party` (object, required)

### `check_identifier_format` (~158 tokens)

Free format check: CUI, IBAN, trade register number, invoice arithmetic

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. Free, works without an API key; rate-limited per IP. For registry checks use validate_extracted_company_data.

Input parameters:

- `cui` (string)
- `iban` (string)
- `invoice` (object)
- `name` (string)
- `registrationNumber` (string)

### `validate_efactura` (~154 tokens)

Validate a Romanian e-Factura XML

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 unreachable.

Input parameters:

- `xml` (string, required): UBL 2.1 Invoice or CreditNote XML (RO e-Factura / CIUS-RO)

### `generate_efactura` (~289 tokens)

Generate a Romanian e-Factura XML

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 (public validation service). Does NOT submit to SPV. Costs 2 credits; not billed on errors or if ANAF's validator is unreachable (the XML is still returned).

Input parameters:

- `autofill` (boolean): Fill parties from ANAF by CUI (default true)
- `buyer` (object, required)
- `currency` (string): Default RON
- `dueDate` (string)
- `issueDate` (string): YYYY-MM-DD, default today
- `lines` (array, required)
- `note` (string)
- `number` (string, required): Invoice number, e.g. HTR-0001
- `paymentTerms` (string)
- `seller` (object, required)
- `vatToRonRate` (number): Required if currency != RON (RON per unit, e.g. BNR rate)

### `parse_efactura` (~132 tokens)

Parse a Romanian e-Factura XML to JSON

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.

Input parameters:

- `xml` (string, required): UBL 2.1 Invoice or CreditNote XML (RO e-Factura / CIUS-RO)

### `efactura_to_pdf` (~89 tokens)

Render a Romanian e-Factura XML as 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.

Input parameters:

- `xml` (string, required): UBL 2.1 Invoice or CreditNote XML (RO e-Factura / CIUS-RO)

### `search_legislation` (~216 tokens)

Search Romanian 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 Justice); informational, consolidated forms are unofficial, only Monitorul Oficial text is authentic.

Input parameters:

- `limit` (integer)
- `number` (string)
- `q` (string, required): Citation or title words, e.g. 'Legea 31/1990' or 'Codul fiscal'
- `type` (string): Act type filter, e.g. LEGE, ORDONANTA DE URGENTA, HOTARARE, ORDIN
- `year` (string)

### `get_legal_act` (~198 tokens)

Romanian legal act (current consolidated form)

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 procedură fiscală 170007, Legea 31/1990 798) also work offline. Costs 1 credit. Source: legislatie.just.ro (Ministry of Justice); informational, consolidated forms are unofficial, only Monitorul Oficial text is authentic.

Input parameters:

- `id` (string, required): legislatie.just.ro DetaliiDocument id, e.g. 171282
- `limit` (integer)
- `offset` (integer)

### `get_legal_article` (~141 tokens)

Article of a Romanian legal act

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 authentic.

Input parameters:

- `article` (string, required): Article number, e.g. 291 or 293^1
- `id` (string, required): Act id, e.g. 171282 for Codul fiscal

### `get_legal_act_history` (~119 tokens)

Amendment history of a Romanian act

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.

Input parameters:

- `article` (string): Limit to one article, e.g. 291
- `id` (string, required)

### `get_new_legal_acts` (~103 tokens)

New Romanian 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.

Input parameters:

- `since` (string)

### `get_bnr_exchange_rate` (~156 tokens)

BNR exchange rate (RON reference 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.

Input parameters:

- `currency` (string): ISO code, e.g. EUR, USD, GBP (history default EUR)
- `date` (string): YYYY-MM-DD; default latest
- `from` (string)
- `to` (string)

### `get_robor` (~187 tokens)

ROBOR / ROBID interbank rates

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.

Input parameters:

- `date` (string)
- `from` (string)
- `tenor` (string): ON, 1W, 1M, 3M, 6M or 12M (history default 3M)
- `to` (string)

### `get_ircc` (~138 tokens)

IRCC consumer-credit reference index

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 source.

Input parameters:

- `date` (string)
- `from` (string)
- `history` (string)
- `to` (string)

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/io-howtoromania-api/api#diagnostics

## Score history

- 2026-11-04: 79
- 2026-11-03: 78
- 2026-11-02: 83
- 2026-11-01: 82
- 2026-10-31: 82
- 2026-10-30: 81
- 2026-10-29: 81
- 2026-10-28: 81
- 2026-10-27: 80
- 2026-10-26: 80
- 2026-10-25: 79
- 2026-10-24: 79
- 2026-10-23: 78
- 2026-10-22: 71
- 2026-10-21: 71
- 2026-10-20: 70
- 2026-10-19: 70
- 2026-10-18: 69
- 2026-10-17: 69
- 2026-10-16: 68
- 2026-10-15: 28
- 2026-10-14: 28

## Common questions

### What is the HowToRomania MCP server?

HowToRomania is an MCP server listed in the public MCP registry as io.howtoromania/api. Romanian company data, e-Factura and legislation: CUI lookup, courts, risk, invoices, laws. This page covers its hosted endpoint (https://api.howtoromania.io/mcp).

### Is the HowToRomania MCP server safe to use?

HowToRomania scores 79 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the HowToRomania MCP server expose?

HowToRomania exposes 20 tools: lookup_company, get_company_financials, get_company_court_cases, get_court_case, get_company_risk_report, and 15 more. Their descriptions and schemas cost roughly 3,160 tokens of context every time the server is loaded.

### Does the HowToRomania MCP server require authentication?

No. We connected to HowToRomania without credentials and it answered, so anything it exposes is reachable by anyone who knows the address.

### Is the HowToRomania MCP server still maintained?

HowToRomania is still listed as active in the MCP registry. We last reached this channel on 4 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

## Links

- Remote endpoint: https://api.howtoromania.io/mcp
- Authorisation metadata: https://api.howtoromania.io/.well-known/oauth-protected-resource/mcp
- Website: https://howtoromania.io/
- Changelog RSS feed: https://verifymcp.io/servers/io-howtoromania-api/api.xml
- Changelog JSON feed: https://verifymcp.io/servers/io-howtoromania-api/api.json
- HTML version of this page: https://verifymcp.io/servers/io-howtoromania-api/api