Documentation

Connect Brreg and put it to work

Everything you need: how to connect, the tools your assistant receives, where the data comes from, the limits and how personal data is treated.

Connect

Brreg is a remote MCP server. Your assistant connects to one address and you sign in with your Publifye account. Access is granted through that sign-in only — there is no API key to create, copy or rotate.

https://brreg.publifye.com/mcp

Access needs a Brreg plan on your Publifye account. See plans

Claude on the web and Claude Desktop

  1. Open Settings, then Connectors.
  2. Choose Add custom connector, name it Brreg and paste the address above.
  3. Select Connect and sign in with your Publifye account, then approve access.
  4. In a chat, make sure Brreg is enabled under the tools menu, and ask your question.

Claude Code

Add the server once, then run /mcp inside Claude Code to sign in:

claude mcp add --transport http brreg https://brreg.publifye.com/mcp

Other MCP clients

Transport
Streamable HTTP (JSON-RPC over POST) at the address above.
Sign-in
OAuth 2.1 with PKCE against the Publifye sign-in. Clients register themselves automatically (dynamic client registration), so there is nothing to set up in advance.
Discovery
https://brreg.publifye.com/.well-known/oauth-protected-resource

Tools

These are the tools your assistant receives when you connect, listed straight from the live server. All of them only read data.

entity_lookup

Looks up one or more organisations by organisation number and returns the register entry. Key financials, the years of filed annual accounts and the filed document itself only when you ask for them.

  • compact
  • cursor
  • document_year
  • fields
  • include_subunits
  • live
  • max_bytes
  • orgnr
  • orgnrs
  • snapshot_id

entity_nearby

Finds the organisations registered nearest a map point, closest first, with the distance to each. The point is the address in the register, not where the business actually operates.

  • radius_km
  • city
  • compact
  • cursor
  • employees_max
  • employees_min
  • fields
  • kind
  • lat
  • limit
  • lon
  • max_bytes
  • municipality
  • nace
  • org_form
  • orgnr
  • parent_orgnr
  • postcode
  • public_body
  • sector
  • snapshot_id
  • status
  • vat_registered

entity_distance

Measures how far apart organisations are, and which of several is nearest a given place. This is the straight-line distance between registered addresses, not driving distance and not travel time.

  • from
  • to
  • compact
  • cursor
  • max_bytes
  • snapshot_id

entity_financials

Fetches key figures from the annual accounts, the years a company has actually filed, a comparison with its industry, and the filed document itself, only for the companies you ask about.

  • compact
  • cursor
  • document_year
  • include
  • max_bytes
  • orgnr
  • orgnrs
  • snapshot_id

entity_resolve

Turns a company name, including a former name, into candidate organisations with their numbers, without picking one for you.

  • name
  • compact
  • cursor
  • fields
  • include_deleted
  • kind
  • limit
  • max_bytes
  • municipality
  • public_body
  • snapshot_id

entity_structure

Shows how organisations belong together: parent, sub-units and, for public bodies, the agencies below them.

  • orgnr
  • compact
  • cursor
  • fields
  • limit
  • max_bytes
  • section
  • snapshot_id

code_list

Lists the codes you can filter by, such as organisation forms, industries and municipalities.

  • list
  • compact
  • cursor
  • fields
  • limit
  • max_bytes
  • query
  • snapshot_id

snapshot_status

Tells how fresh the register data is: when it was last fetched from Brønnøysundregistrene.

  • detail
  • max_bytes

operator_guide

Explains what Brreg can do, how to connect, and ways to use it with your assistant.

Search near a place

Give entity_search a point and a radius (lat, lon and radius_km) and it lists organisations whose registered address lies within that distance, nearest first, each with its distance and the address point. With a name query the order stays by relevance and the radius works as a filter.

  • The radius can be up to 10 km on its own, or up to 50 km together with another filter such as organisation form, industry or a name.
  • The point is the Kartverket address point of the registered address — the business address for main units, the location address for sub-units. It is not a building footprint and not necessarily where the work is done.
  • Addresses given as c/o, post boxes, foreign addresses and addresses that do not match the address register get no point, and never appear in a radius search.
  • Many organisations share one address, such as an accountant’s office. Each result says how many share its point.
entity_search lat=60.3913 lon=5.3221 radius_km=2 org_form=["KIRK"]

Match a field with a pattern

Give entity_search a match filter and it keeps only the organisations whose field matches your pattern — up to four of them, one per field, applied together with your other filters.

  • Seven fields can be matched: activity, address, city, email, name, phone and website.
  • Patterns are RE2 regular expressions, matched without regard to case, and you anchor them yourself. A bare full stop tests only that the field is there at all.
  • Anchor when you can: ^post narrows the scan and is fast. An unanchored pattern reads every value of its field the first time it is used — about a tenth of a second — and the answer is then kept for later callers.
  • Matching runs on the weekly edition, so an organisation registered, or a value changed, since the last rebuild is matched on what that edition held.
entity_search match=[{"field":"email","pattern":"^post"}] municipality="4601"

Data and sources

Enhetsregisteret
Main units and sub-units from Brønnøysundregistrene, rebuilt from the full register every week. Between rebuilds the register’s own update feed — read about once an hour, less often through the night — refreshes the entries the weekly edition already holds and drops the ones that are removed; an organisation registered since the last rebuild is found by a lookup on its number, but does not appear in search results until the next one. When an entry is removed from open data, it disappears from Brreg within 24 hours.
Regnskapsregisteret
Key figures from the latest filed annual accounts, which accounting years an organisation has actually filed for, and the filed accounts themselves: the complete document as filed, roughly fifteen years back, and the only route for banks and insurers whose key figures are unavailable. It comes as a private link that expires, and it is a scanned image with no text layer, so it is for a person to open and read rather than something an assistant can extract figures from. All of it is fetched only when you explicitly ask, and figures always carry the year they belong to.
Kartverket address points
The national address register (Matrikkelen – Adresse) from Kartverket, fetched weekly and matched to each organisation’s registered address to place it on the map.
Parcel and buildings
For an organisation with a map point, the matrikkel parcel (gnr/bnr, and the section number when the address has exactly one), the grunnkrets, parish and tettsted, and the existing buildings at the address when one of them is not a home. From Kartverket's Matrikkelen – Adresse, Bygningspunkt and Adresse Leilighetsnivå, weekly. It is the parcel at the registered address, not property the organisation owns.
Codes
Organisation forms, municipalities, industry codes (NACE) and institutional sectors, with counts, as the register publishes them.
Freshness
Every answer says which weekly edition of the register it comes from. A lookup by organisation number also shows changes published since then, marked with the time they were read, and the assistant can ask how current the data is.

Not included

  • Roles and persons: no board members, managing directors or owners.
  • The full annual accounts as data: detailed line items, notes and the auditor’s report — only the key figures above come as data. The filed document itself is available on request as an expiring link, but it is a scanned image with no text layer, so nothing in it can be searched or parsed; one larger than 40 MiB is not relayed, and the answer names the open source to fetch it from instead.
  • Contact details, former names and activity text for sole proprietorships.
  • Bulk exports or copies of the register.

Limits

Daily calls
Each plan includes a daily allowance of tool calls per Publifye account. It resets at midnight UTC. Allowances per plan
Key financials and filings
Up to 30 fresh fetches from Regnskapsregisteret per minute per account, shared by key figures and filing histories. A filed document is many megabytes, so it is budgeted far more tightly: 3 a minute. Beyond either you get what was already fetched, or a note saying when to try again.
Response size
About 24 KiB per answer by default, adjustable from 4 to 48 KiB. Longer results continue with a cursor that stays valid for 15 minutes.
Radius
At most 10 km for a radius on its own and 50 km with another filter.
Search depth
A search pages all the way to the end of its results: follow the cursor and nothing is left out. Only the offset shortcut, which skips ahead on the first call, stops at 10,000.

When the daily allowance is used up

Calls are refused until the reset with an error your assistant can read and explain. It looks like this:

{"reason": "quota_exceeded", "service": "brreg-service", "window": "day", "limit": …, "resets_at": "…T00:00:00Z"}

Privacy

  • Brreg is about organisations. It is not a register of persons and cannot be used to look people up.
  • A sole proprietorship is tied to one person, so for those Brreg holds back former names, activity text and contact details, and a search without a name never lists them.
  • No address-only lookups of individuals and no bulk export.
  • Parcel and building details follow the same rule: none for sole proprietorships, their sub-units or addresses given as c/o. Information from the cadastre (matrikkelen) may not be used for advertising or marketing without the consent of the party it concerns (utleveringsforskriften § 5, third paragraph).
  • Sole proprietorships and their sub-units get no map point and never appear in a radius search, and they are not counted when a point is shared.
  • Key financials are fetched only when you ask for them.
  • What we log: for every tool call on a customer account, the account, the client IP address, the tool and the outcome — never the arguments you send. The audit trail is kept for 365 days.
  • Removals: when Brønnøysundregistrene removes an entry from open data, Brreg drops it within 24 hours.

Licence and attribution

The register data is open data from Brønnøysundregistrene under the Norwegian Licence for Open Government Data (NLOD 2.0). Every answer carries the attribution the licence asks for:

Inneholder data under Norsk lisens for offentlige data (NLOD) tilgjengeliggjort av Brønnøysundregistrene.

Map points and distances come from Matrikkelen – Adresse, © Kartverket, under Creative Commons Attribution 4.0 (CC BY 4.0). Publifye has matched the address points to each organisation’s registered address; they do not show where the business physically operates. Answers with points or distances carry this attribution too. Read CC BY 4.0

Answers with a parcel or buildings say that the information is provided from a private register, as utleveringsforskriften § 5, tenth paragraph, requires.

Brreg is operated by Publifye AS and is not the authoritative register. For anything legally binding, use the official record at virksomhet.brreg.no. Read the licence

Support

Questions, a wrong answer, or something missing? Contact Publifye support and mention Brreg. Contact support

Get started