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.

Try company lookup 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 →

Production access today uses a key we issue for you. Self-serve signup and Stripe top-ups are on the roadmap (coming soon).

Pricing coming soon

Billing is built but not live yet. Planned model: 100 free credits on signup, then prepaid packs. 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.

When billing goes live, a 402 response will include a Checkout URL so agents can surface payment to a human.

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