Romania MCP server

Give your AI agent Romanian company data, court cases, e-Factura tools and legislation in force through one remote MCP server. Streamable HTTP, bearer-key auth, 15 tools, the same pay-per-call credits as the REST API.

Get a free key (100 credits)Docs

curl example

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"}'

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

MCP example

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

Ask your agent: “List the legal representatives of CUI 14399840 and their roles, then check for pending court cases.”

Endpoints and prices

Service	Endpoint	Credits	≈ 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}/financials` MCP `get_company_financials`	5	€0.025
Legal representatives (ONRC) Trade-register status, CAEN codes, representatives (name, role)	`GET /v1/company/{cui}/representatives` MCP `get_company_representatives`	2	€0.010
Risk report (KYB) Status + financials + court cases + registry, score 0-100 with explained flags	`GET /v1/company/{cui}/risk-report` MCP `get_company_risk_report`	8	€0.040
Company court cases Cases where the company is a party (portal.just.ro), summary + list	`GET /v1/company/{cui}/court-cases` MCP `get_company_court_cases`	3	€0.015
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/validate` MCP `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/generate` MCP `generate_efactura`	2	€0.010
Parse invoice XML UBL Invoice/CreditNote -> English JSON	`POST /v1/efactura/parse` MCP `parse_efactura`	1	€0.005
Invoice PDF rendered with ANAF's public PDF service	`POST /v1/efactura/pdf` MCP `efactura_to_pdf`	1	€0.005
Search acts By citation ('Legea 31/1990') or title words	`GET /v1/legislation/search` MCP `search_legislation`	1	€0.005
Act (in force) Current consolidated text, split by article	`GET /v1/legislation/act/{id}` MCP `get_legal_act`	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
Amendment history Consolidation dates, dated amendments per article	`GET /v1/legislation/act/{id}/history` MCP `get_legal_act_history`	2	€0.010
New acts Acts in force since a date (max 35 days)	`GET /v1/legislation/new` MCP `get_new_legal_acts`	1	€0.005

Prepaid packs (VAT included): €5 = 1,000 · €20 = 5,000 · €100 = 30,000 credits. 100 free credits per key, no subscription.

Why HowToRomania

English JSON, ready for code and AI agents
Companies, court cases, e-Factura and legislation in force in one API
REST and a remote MCP server with the same key
Pay per call (1 credit = €0.005), no subscription; errors are not billed
100 free credits on every key

FAQ

Which clients work?

Any MCP client that supports remote streamable HTTP servers: Claude Desktop and claude.ai, ChatGPT connectors, Cursor, Cline, VS Code and others.

Do I need a key?

Listing tools does not. Calling tools needs a key: the demo key for 1-credit tools, or a free key with 100 credits.

How much does it cost?

Pay per successful call in credits (1 credit = €0.005). Every key gets 100 free credits. Packs: €5 = 1,000 credits, €20 = 5,000 credits, €100 = 30,000 credits. Prepaid, no subscription; errors and not-found are not billed.

Can I try it without signing up?

Yes. The demo key htr_demo works on 1-credit endpoints with a small daily limit per IP. A free key with 100 credits is one POST to /v1/keys.

Is this an official ANAF or government service?

No. HowToRomania is an independent service that reads public sources (ANAF, ONRC open data, BNR, portal.just.ro, legislatie.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.