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 only when you ask for them.

  • compact
  • cursor
  • fields
  • include_subunits
  • live
  • 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

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"]

Data and sources

Enhetsregisteret
Main units and sub-units from Brønnøysundregistrene, rebuilt from the full register every week. When an entry is removed from open data, it disappears from Brreg within 24 hours.
Regnskapsregisteret
Key figures from the latest filed annual accounts, fetched only when you explicitly ask for them and always shown with 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.
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, and the assistant can ask how current the data is.

Not included

  • Roles and persons: no board members, managing directors or owners.
  • Full annual accounts, notes or auditor’s reports.
  • 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
Up to 30 fresh fetches from Regnskapsregisteret per minute per account. Beyond that you get figures 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 through at most 10,000 results. Narrow it with filters to reach the rest.

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.
  • 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

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