Built for AI agents

Romania, readable by agents.

Romanian official data is public, but messy, Romanian-language, and built for browsers. HowToRomania is one front door: clean English JSON, one API key, REST and MCP.

Get a free key API · api.howtoromania.io

What it is

One key, one billREST and MCP share the same prepaid credits. Agents authenticate once and keep calling.
Official sourcesANAF taxpayer data and BNR FX rates, mapped into a stable English schema with citations.
Agent-nativeStreamable HTTP MCP, deterministic errors, an llms.txt, no HTML scraping.

Live now: company lookup by CUI

Hand any Romanian fiscal code (CUI/CIF) to the API or the MCP tool lookup_company and get name, trade-register number, VAT status, addresses, active/inactive flags, and the BNR EUR/RON rate.

HTTP

curl -s https://api.howtoromania.io/v1/company/14399840 \
  -H "x-api-key: $HTR_API_KEY"

MCP (Streamable HTTP)

Remote endpoint: https://api.howtoromania.io/mcp. Send your key as Authorization: Bearer <key> (or x-api-key).

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

Tool: lookup_company · args cui, optional include_fx health check →

Need a key? See Get started: self-serve, 100 free credits, no card required.

Get started in one call

Create a key with your email. You get 100 free credits immediately. The key is shown once, so store it.

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

Check your balance and usage:

curl -s https://api.howtoromania.io/v1/me -H "x-api-key: $HTR_API_KEY"

Pricing

100 free credits on signup, then prepaid packs that never expire. One credit = one successful company lookup. Invalid CUI, not-found, and upstream errors are free.

Free
100 credits

Enough to evaluate and wire an agent. One email = one key.

Starter
€5 / 1,000 credits

For early integrations and low-volume agents.

Pro
€20 / 5,000 credits

Best value for day-to-day agent workloads.

Scale
€100 / 30,000 credits

Higher volume, same per-call semantics.

Prices exclude VAT, which is added at checkout where applicable. Top up any time with your key:

curl -s "https://api.howtoromania.io/v1/billing/checkout?pack=starter" \
  -H "x-api-key: $HTR_API_KEY"   # returns a Stripe checkout URL

When credits run out, the API returns 402 with checkout links, so an agent can hand payment to a human. Credits are added automatically after payment.

Roadmap

One garden of Romania APIs behind the same key. Next up, based on demand:

e-Factura for agentsCreate, validate, send, and read ANAF e-Factura without wrestling with XML and certificates.
SEAP / SICAP watcherPublic procurement tenders, summarized and matched to companies.
Legal navigatorStructured laws, Monitorul Oficial updates, and step-by-step procedures with citations.
Couriers & commerceAgent-friendly shipping and local checkout (Fan Courier, Sameday, and more).

Contact

Questions, early access, or partnership: hello@howtoromania.io placeholder

GitHub: github.com/howtoromania/howtoromania