Use case · MCP

Romanian company data inside Claude and Cursor

HowToRomania is a remote MCP server. Add one block to your MCP config and your assistant can look up Romanian companies, read their financials and court cases, parse e-Factura XML and search legislation in force, with the same key you use for REST.

Get a free key (100 credits)Docs

Setup

{ "mcpServers": { "howtoromania": { "url": "https://api.howtoromania.io/mcp", "headers": { "Authorization": "Bearer htr_demo" } } } }

Server URL: https://api.howtoromania.io/mcp. Replace htr_demo with your own key to unlock every tool; the demo key covers the 1-credit tools with a small daily limit.

Things to ask

"Is CUI 14399840 active, VAT-registered and on e-Factura?"
"Show the last 3 years of turnover and profit for CUI 14399840."
"Is this supplier in any insolvency case since 2024?"
"Parse this e-Factura XML and check the seller."
"What does article 291 of the Fiscal Code say today?"

Why teams try HowToRomania

Remote MCP server: one config block, nothing to install or host
Same key for MCP and REST, so prototypes in Claude or Cursor move straight to production code
Tools return English JSON with clear field names, which assistants can use directly
Covers companies, financials, representatives, court cases, e-Factura and legislation in force in one server
Try with htr_demo right away; 100 free credits per key; pay per call from €5

Tools and prices

MCP tool	What it does	Credits
`lookup_company`	ANAF status, VAT, e-Factura, address	1
`get_company_financials`	Filed financial statements	3
`get_company_representatives`	ONRC registry status, CAEN, representatives	5
`get_company_court_cases`	Cases where the company is a party	15
`get_court_case`	Case by number: parties, hearings, outcomes	1
`get_company_risk_report`	All-in-one risk report with flags and score	30
`validate_efactura / parse_efactura`	e-Factura XML check and English JSON	1
`generate_efactura`	CIUS-RO UBL XML from JSON	2
`search_legislation / get_legal_article`	Romanian legislation in force	1

Pay per successful call in credits (1 credit = €0.005). Every key gets 100 free credits. Prepaid packs (VAT included): €5 = 1,000 · €20 = 5,000 · €100 = 30,000 credits. No contract or minimum spend; errors and not-found are not billed. Volume subscriptions available on request: hello@howtoromania.io.

What the agent sees

{
  "data": {
    "cui": "12345678",
    "vatId": "RO12345678",
    "name": "FIRMA SRL",
    "registrationNumber": "J40/1234/2015",
    "caenCode": "4690",
    "fiscalStatus": "INREGISTRAT din data 01.03.2015",
    "vat": { "registered": true, "since": "2015-03-01", "cashAccounting": false, "splitVat": false },
    "status": { "active": true, "inactive": false, "inactiveSince": null, "reactivatedOn": null, "deregisteredOn": null },
    "eFactura": { "registered": true, "since": "2022-01-01" },
    "address": { "fiscal": { "formatted": "Str. Exemplu 1, Sector 1, Bucuresti", "...": "..." }, "registeredOffice": { "...": "..." } },
    "queriedForDate": "2026-10-23",
    "source": { "name": "ANAF PlatitorTvaRest v9", "url": "...", "fetchedAt": "2026-10-23T09:00:00.000Z" }
  },
  "fx": { "...": "BNR reference rate" }
}

Response abridged; field names are exact, values are illustrative (FIRMA SRL and CUI 12345678 are example data, not a real company).

Registry fields (status, representatives, authorized CAEN) contain filtered, decoded, translated ONRC data, from ONRC open data on data.gov.ro, licensed under CC BY 4.0.

Get a key

Get a free key (100 credits)Docs

Free key: curl -X POST https://api.howtoromania.io/v1/keys -H "content-type: application/json" -d '{"email":"you@example.com","accept_terms":true}'

FAQ

Which clients work?

Any MCP client that can connect to a remote MCP server over HTTP and send an Authorization header. In Cursor, put url and headers in mcp.json as shown above. For Claude Desktop, use the mcp-remote bridge: npx mcp-remote https://api.howtoromania.io/mcp --header "Authorization: Bearer <key>".

Is this an official ANAF or government service?

No. HowToRomania is an independent service that reads public sources (ANAF, ONRC open data, portal.just.ro) and returns them as English JSON. It is not affiliated with or endorsed by any public authority. Information only; not legal or credit advice.

Used by