# HowToRomania

HowToRomania — an MCP server for Claude Code and Codex that gives agents access to Romanian company records, invoices, and legislation. Ask it to check a CUI, court cases, or e-Factura data.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: howtoromania
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/howtoromania/howtoromania-mcp
- Updated: 2026-11-02
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/howtoromania

## What it does

HowToRomania connects an agent to Romanian public records. Its tools retrieve company details by CUI, filed financials, and legal representatives; they can also gather court cases and return a KYB risk report. Other calls check company fields extracted from an invoice or contract and handle e-Factura: create or validate an invoice, parse its XML, or turn it into a PDF.

Agents can search legislation and read current acts split into articles. Separate tools return BNR exchange rates, ROBOR, and IRCC values. The service runs remotely, so there is no local server process to start. Most calls use credits: each new key comes with 100 free credits, while the BNR, ROBOR, and IRCC rate tools cost nothing. Access requires an API key sent in the `Authorization: Bearer` header; the demo key has daily per-IP limits and only enables a subset of tools.

## Requirements
- Remote server: `https://api.howtoromania.io/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http howtoromania https://api.howtoromania.io/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add howtoromania --url https://api.howtoromania.io/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "howtoromania": {
            "url": "https://api.howtoromania.io/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "howtoromania": {
            "type": "http",
            "url": "https://api.howtoromania.io/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http howtoromania https://api.howtoromania.io/mcp
```

## When to use it
- look up a Romanian company by CUI
- retrieve filed accounts and company representatives
- gather court cases and a KYB risk report
- validate company details extracted from an invoice
- find the current text of a Romanian law

## Example prompts
- Look up the Romanian company with CUI RO12345678.
- Check the company details extracted from this contract and list fields that need review.
- Find the current version of Legea 31/1990 and summarize article 5.

## Similar
- [ONRC trade register](https://affpapa.org/en/nevibecode/mcp/onrc-trade-register.md) — MCP server · ★ 5 repo stars
- [x402-endpoints](https://affpapa.org/en/nevibecode/mcp/x402-endpoints.md) — MCP server · 185 installs
- [Oblio](https://affpapa.org/en/nevibecode/mcp/oblio.md) — MCP server · ★ 5 repo stars
- [America's Law Graph](https://affpapa.org/en/nevibecode/mcp/americas-law-graph.md) — MCP server · 1586 installs
- [openstates-mcp-server](https://affpapa.org/en/nevibecode/mcp/openstates-mcp-server.md) — MCP server · 1468 installs
- [Virkly CVR](https://affpapa.org/en/nevibecode/mcp/virkly-cvr.md) — MCP server

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
