Merit company lookup

Skill Elnora-AI/elnora-merit-aktiva/skills/merit-company-lookup

Look up Estonian companies in the Business Register (äriregister) using the two FREE live services via `elnora-merit ariregister`: invoicing requisites (legal name, VAT number, status, address) by registry code, and e-invoice capability. Use to fill or verify customer/invoice details from the authoritative source, or to check whether a company can receive e-invoices before sending one. Use when: looking up a company's registry data, getting a VAT number or address by registry code, verifying customer details before invoicing, or checking e-invoice capability. TRIGGERS: "äriregister lookup", "business register", "registrikood", "look up company", "company requisites", "VAT number for", "registry data", "verify customer", "e-invoice check", "can they receive e-invoices", "e-arve check", "kmkr number".From its SKILL.md

Install

npx -y skills add Elnora-AI/elnora-merit-aktiva --skill merit-company-lookup

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

8 stars8 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

3.2 KB, as published. Nobody here has run it

Merit Company Lookup — äriregister free services

Two FREE (tasuta), read-only services from the Estonian Business Register, exposed via elnora-merit ariregister. Nothing here writes to the books or costs money.

When to use

Before creating a customer/invoice — pull the authoritative legal name, VAT number, and address instead of typing them by hand or trusting a stale value.
Before sending an e-invoice — confirm the recipient actually has an active e-invoice channel, so you don't send into a void.

Commands

Requisites (needs credentials)

elnora-merit ariregister requisites <regCode> [--include-deleted] [--lang eng]

Returns JSON: regCode, name, vatNo, status, statusText, address {street, ehakCode, ehakText, postalIndex}, registryLink. status R = registered/active; K = deleted.

Example:

$ elnora-merit ariregister requisites 16818352
{"regCode":"16818352","name":"Elnora AI OÜ","vatNo":"EE102672514","status":"R", ...}

E-invoice capability (no credentials)

elnora-merit ariregister e-invoice-check <regCode> [<regCode> ...]

One row per code: status OK = active e-invoice relationship (canReceiveEInvoice: true), MR = none/invalid; plus name and provider (operator).

Mapping requisites to a Merit customer

äriregister field	Merit customer field
`name`	`Name`
`vatNo`	`VatRegNo`
`regCode`	`RegNo`
`address.street`	`Address`
`address.ehakText`	`City` / `County`
`address.postalIndex`	`PostalCode`

Setup & limits

Requisites needs ARIREG_XML_USER / ARIREG_XML_PASSWORD in the environment or ~/.config/elnora-merit/.env. Create an XML-authorised user in the e-äriregister portal (Haldus → Kasutajate haldamine) and use that account's credentials. A "credential rejected" error means they are missing or wrong.
E-invoice-check needs no credentials at all.
Only these two free services are wired. Detailed company data, beneficial owners, and representation rights are billable in the register and are intentionally not exposed.
Endpoint defaults to production; set ARIREG_XML_ENV=test to hit the demo endpoint.

See also: merit-sales-invoices (issuing the invoice once requisites are confirmed) and the merit-company-lookup agent for a guided flow.