howtoromania

Romanian public data for AI agents: companies (ANAF, ONRC), financials, court cases, KYB risk, validation of extracted company data, e-Factura and legislation in force. Remote MCP server + REST API. Pay per call, 100 free credits.

This repository holds the public docs, client configs and registry metadata. The server is hosted; there is nothing to install or run.

Services and prices

1 credit = €0.005 at the smallest pack. Credits are charged per successful call. Errors, not-found and source outages (e.g. ANAF unreachable) are not billed. A risk report with some sections unavailable is billed in full. BNR rates tools are free.

Credit packs

Every new key gets 100 free credits. Out of credits → HTTP 402 with checkout links. Balance: GET /v1/me.

Related MCP server: oblio-mcp

Get a key

curl -X POST https://api.howtoromania.io/v1/keys \
  -H "content-type: application/json" \
  -d '{"email":"you@example.com","accept_terms":true}'
# → {"apiKey":"htr_..."}   (shown once)

No signup needed to try: use the public demo key htr_demo (limited daily calls per IP; lookup_company, get_court_case, validate_efactura, parse_efactura, search_legislation, get_legal_article, get_new_legal_acts).

Connect

Replace htr_demo with your own key. Ready-made files are in examples/.

Cursor

~/.cursor/mcp.json (examples/cursor.json)

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

VS Code

.vscode/mcp.json (examples/vscode.json), prompts for the key:

{
  "inputs": [
    { "type": "promptString", "id": "htr-key", "description": "HowToRomania API key", "password": true }
  ],
  "servers": {
    "howtoromania": {
      "type": "http",
      "url": "https://api.howtoromania.io/mcp",
      "headers": { "Authorization": "Bearer ${input:htr-key}" }
    }
  }
}

Cline

cline_mcp_settings.json (examples/cline.json)

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

Windsurf

~/.codeium/windsurf/mcp_config.json (examples/windsurf.json)

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

Claude Desktop (and any client without remote-header support)

claude_desktop_config.json, via mcp-remote (needs Node.js 18+) (examples/claude-desktop.json)

{
  "mcpServers": {
    "howtoromania": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote", "https://api.howtoromania.io/mcp",
        "--header", "Authorization:Bearer ${HTR_API_KEY}"
      ],
      "env": { "HTR_API_KEY": "htr_demo" }
    }
  }
}

Claude Code

claude mcp add --transport http howtoromania https://api.howtoromania.io/mcp \
  --header "Authorization: Bearer htr_demo"

Agent Plugins / Cursor plugin

This repo is also a plugin following the Open Plugins / Agent Plugins standard: plugin.json + mcp.json (remote server), .mcp.json and .cursor-plugin/plugin.json for Cursor, and a skill in skills/romanian-public-data that tells agents which tool to use. The bundled config uses the demo key; swap in your own key after install.

REST

curl -H "x-api-key: htr_demo" https://api.howtoromania.io/v1/company/14399840

Example prompts

• "Before we sign with supplier RO14399840, check it's active, VAT-registered, and summarize risk flags." → get_company_risk_report (30)

• "List the legal representatives of CUI 14399840 and their roles." → get_company_representatives (5)

• "ANAF rejected this XML. Which rules fail and how do I fix them?" → validate_efactura (1)

• "What VAT rates apply in Romania today per Codul fiscal art. 291, and when did they last change?" → get_legal_article (1) + get_legal_act_history (2)

Listed on

• MCP Registry: io.howtoromania/api (server.json)

• Smithery: https://smithery.ai/servers/ipa-netot/howtoromania

• Glama: https://glama.ai/mcp/connectors/io.howtoromania/api

Data sources

ANAF (company registry, financial statements, e-Factura validator and PDF), BNR (exchange rates), ONRC open data (trade register), portal.just.ro (court cases), legislatie.just.ro (legislation). Court data masks natural persons. Consolidated legal text is informational; only Monitorul Oficial is authentic.

Informational; not legal or credit advice.

Links

• Site and docs: https://howtoromania.io

• OpenAPI: https://api.howtoromania.io/openapi.json

• For agents: https://howtoromania.io/llms.txt

• Contact: hello@howtoromania.io

License

MIT © 2026 HowToRomania. Covers the contents of this repository (docs, configs, metadata); the hosted service is subject to its own terms.