brreg-mcp 0.1.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,32 @@
1
+ # Python
2
+ __pycache__/
3
+ *.py[cod]
4
+ *.egg-info/
5
+ .venv/
6
+ venv/
7
+ .mypy_cache/
8
+ .ruff_cache/
9
+ .pytest_cache/
10
+ htmlcov/
11
+ .coverage
12
+ dist/
13
+ build/
14
+
15
+ # Runtime data
16
+ *.db
17
+ *.sqlite
18
+ *.sqlite3
19
+ data/
20
+
21
+ # Env / secrets
22
+ .env
23
+ .env.*
24
+ !.env.example
25
+
26
+ # Node (npm wrapper package)
27
+ node_modules/
28
+
29
+ # Editors / OS
30
+ .DS_Store
31
+ .idea/
32
+ .vscode/
@@ -0,0 +1,90 @@
1
+ Metadata-Version: 2.5
2
+ Name: brreg-mcp
3
+ Version: 0.1.0
4
+ Summary: MCP server for brreg — look up Norwegian companies in Brønnøysundregistrene / Enhetsregisteret by organisasjonsnummer (orgnr, org.nr): status, VAT (MVA) registration and filing deadlines. Alias package for registry-mcp.
5
+ Project-URL: Homepage, https://api.foretak.dev
6
+ Project-URL: Documentation, https://api.foretak.dev/llms-full.txt
7
+ Project-URL: Repository, https://github.com/foretak/registry-mcp
8
+ Project-URL: Issues, https://github.com/foretak/registry-mcp/issues
9
+ Project-URL: Canonical package, https://pypi.org/project/registry-mcp/
10
+ Author: Kim
11
+ License: MIT
12
+ Keywords: ai-agents,bronnoysund,bronnoysundregistrene,brreg,brønnøysund,brønnøysundregistrene,business-registry,company-data,company-lookup,company-registry,enhetsregisteret,foretak,mcp,mcp-server,model-context-protocol,mva,norway,norway-company-lookup,norwegian-business-registry,org.nr,organisasjonsnummer,orgnr,vat
13
+ Classifier: Development Status :: 3 - Alpha
14
+ Classifier: Environment :: Console
15
+ Classifier: Intended Audience :: Developers
16
+ Classifier: Intended Audience :: Financial and Insurance Industry
17
+ Classifier: Intended Audience :: Legal Industry
18
+ Classifier: License :: OSI Approved :: MIT License
19
+ Classifier: Natural Language :: English
20
+ Classifier: Natural Language :: Norwegian
21
+ Classifier: Operating System :: OS Independent
22
+ Classifier: Programming Language :: Python :: 3
23
+ Classifier: Programming Language :: Python :: 3 :: Only
24
+ Classifier: Programming Language :: Python :: 3.12
25
+ Classifier: Programming Language :: Python :: 3.13
26
+ Classifier: Topic :: Office/Business :: Financial
27
+ Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
28
+ Classifier: Typing :: Typed
29
+ Requires-Python: >=3.12
30
+ Requires-Dist: registry-mcp==0.1.0
31
+ Description-Content-Type: text/markdown
32
+
33
+ # brreg-mcp
34
+
35
+ **MCP server for brreg — Norwegian company lookup in Brønnøysundregistrene / Enhetsregisteret by organisasjonsnummer (orgnr, org.nr).**
36
+
37
+ `brreg-mcp` is an **alias package**. It contains no logic: it depends on
38
+ [`registry-mcp`](https://pypi.org/project/registry-mcp/) and its `brreg-mcp`
39
+ console script is the same entry point, serving the same five tools over stdio.
40
+ Install whichever name you searched for — you get the same server.
41
+
42
+ ```bash
43
+ uvx brreg-mcp # identical to: uvx registry-mcp
44
+ ```
45
+
46
+ ## Add to Claude Code
47
+
48
+ ```bash
49
+ claude mcp add brreg-mcp -- uvx brreg-mcp
50
+ ```
51
+
52
+ ```json
53
+ {
54
+ "mcpServers": {
55
+ "brreg-mcp": {
56
+ "command": "uvx",
57
+ "args": ["brreg-mcp"],
58
+ "env": { "REGISTRY_MCP_CONTACT_EMAIL": "you@example.com" }
59
+ }
60
+ }
61
+ }
62
+ ```
63
+
64
+ The same block works for Cursor (`~/.cursor/mcp.json`) and Claude Desktop
65
+ (`claude_desktop_config.json`).
66
+
67
+ ## Tools
68
+
69
+ | Tool | What it does |
70
+ |---|---|
71
+ | `lookup_company(id, country="NO")` | Full report for one company by organisasjonsnummer |
72
+ | `search_company(name, country="NO", limit=10)` | Find a Norwegian company by name |
73
+ | `company_deadlines(id, country="NO", today=None)` | Årsregnskap, skattemelding, mva-melding, a-melding and the rest, next occurrence of each |
74
+ | `validate_company_id(id, country="NO")` | MOD11-validate an orgnr with no network call |
75
+ | `list_countries()` | Which national registries are supported |
76
+
77
+ ```console
78
+ $ curl https://api.foretak.dev/v1/NO/company/923609016
79
+ {"country": "NO", "registry": "brreg", "id": "923609016", "name": "EQUINOR ASA",
80
+ "legal_form_code": "ASA", "status": "active", "vat_registered": true,
81
+ "vat_number": "NO923609016MVA", "employees": 21239, "license": "NLOD 2.0"}
82
+ ```
83
+
84
+ Full documentation, REST endpoints, and the guide to adding another country:
85
+ **https://github.com/foretak/registry-mcp**
86
+
87
+ ## Data source and licence
88
+
89
+ Data from Enhetsregisteret (Brønnøysundregistrene) under NLOD 2.0. Code MIT
90
+ licensed. Not affiliated with or endorsed by Brønnøysundregistrene.
@@ -0,0 +1,58 @@
1
+ # brreg-mcp
2
+
3
+ **MCP server for brreg — Norwegian company lookup in Brønnøysundregistrene / Enhetsregisteret by organisasjonsnummer (orgnr, org.nr).**
4
+
5
+ `brreg-mcp` is an **alias package**. It contains no logic: it depends on
6
+ [`registry-mcp`](https://pypi.org/project/registry-mcp/) and its `brreg-mcp`
7
+ console script is the same entry point, serving the same five tools over stdio.
8
+ Install whichever name you searched for — you get the same server.
9
+
10
+ ```bash
11
+ uvx brreg-mcp # identical to: uvx registry-mcp
12
+ ```
13
+
14
+ ## Add to Claude Code
15
+
16
+ ```bash
17
+ claude mcp add brreg-mcp -- uvx brreg-mcp
18
+ ```
19
+
20
+ ```json
21
+ {
22
+ "mcpServers": {
23
+ "brreg-mcp": {
24
+ "command": "uvx",
25
+ "args": ["brreg-mcp"],
26
+ "env": { "REGISTRY_MCP_CONTACT_EMAIL": "you@example.com" }
27
+ }
28
+ }
29
+ }
30
+ ```
31
+
32
+ The same block works for Cursor (`~/.cursor/mcp.json`) and Claude Desktop
33
+ (`claude_desktop_config.json`).
34
+
35
+ ## Tools
36
+
37
+ | Tool | What it does |
38
+ |---|---|
39
+ | `lookup_company(id, country="NO")` | Full report for one company by organisasjonsnummer |
40
+ | `search_company(name, country="NO", limit=10)` | Find a Norwegian company by name |
41
+ | `company_deadlines(id, country="NO", today=None)` | Årsregnskap, skattemelding, mva-melding, a-melding and the rest, next occurrence of each |
42
+ | `validate_company_id(id, country="NO")` | MOD11-validate an orgnr with no network call |
43
+ | `list_countries()` | Which national registries are supported |
44
+
45
+ ```console
46
+ $ curl https://api.foretak.dev/v1/NO/company/923609016
47
+ {"country": "NO", "registry": "brreg", "id": "923609016", "name": "EQUINOR ASA",
48
+ "legal_form_code": "ASA", "status": "active", "vat_registered": true,
49
+ "vat_number": "NO923609016MVA", "employees": 21239, "license": "NLOD 2.0"}
50
+ ```
51
+
52
+ Full documentation, REST endpoints, and the guide to adding another country:
53
+ **https://github.com/foretak/registry-mcp**
54
+
55
+ ## Data source and licence
56
+
57
+ Data from Enhetsregisteret (Brønnøysundregistrene) under NLOD 2.0. Code MIT
58
+ licensed. Not affiliated with or endorsed by Brønnøysundregistrene.
@@ -0,0 +1,72 @@
1
+ [project]
2
+ name = "brreg-mcp"
3
+ version = "0.1.0"
4
+ description = "MCP server for brreg — look up Norwegian companies in Brønnøysundregistrene / Enhetsregisteret by organisasjonsnummer (orgnr, org.nr): status, VAT (MVA) registration and filing deadlines. Alias package for registry-mcp."
5
+ readme = "README.md"
6
+ requires-python = ">=3.12"
7
+ license = { text = "MIT" }
8
+ authors = [{ name = "Kim" }]
9
+ keywords = [
10
+ "brreg",
11
+ "brønnøysund",
12
+ "brønnøysundregistrene",
13
+ "enhetsregisteret",
14
+ "organisasjonsnummer",
15
+ "orgnr",
16
+ "org.nr",
17
+ "foretak",
18
+ "bronnoysund",
19
+ "bronnoysundregistrene",
20
+ "norway",
21
+ "norway-company-lookup",
22
+ "norwegian-business-registry",
23
+ "company-registry",
24
+ "company-lookup",
25
+ "company-data",
26
+ "business-registry",
27
+ "vat",
28
+ "mva",
29
+ "mcp",
30
+ "mcp-server",
31
+ "model-context-protocol",
32
+ "ai-agents",
33
+ ]
34
+ classifiers = [
35
+ "Development Status :: 3 - Alpha",
36
+ "Environment :: Console",
37
+ "Intended Audience :: Developers",
38
+ "Intended Audience :: Financial and Insurance Industry",
39
+ "Intended Audience :: Legal Industry",
40
+ "License :: OSI Approved :: MIT License",
41
+ "Natural Language :: English",
42
+ "Natural Language :: Norwegian",
43
+ "Operating System :: OS Independent",
44
+ "Programming Language :: Python :: 3",
45
+ "Programming Language :: Python :: 3 :: Only",
46
+ "Programming Language :: Python :: 3.12",
47
+ "Programming Language :: Python :: 3.13",
48
+ "Topic :: Office/Business :: Financial",
49
+ "Topic :: Scientific/Engineering :: Artificial Intelligence",
50
+ "Typing :: Typed",
51
+ ]
52
+
53
+ # The whole point of this distribution: install registry-mcp.
54
+ dependencies = ["registry-mcp==0.1.0"]
55
+
56
+ [project.urls]
57
+ Homepage = "https://api.foretak.dev"
58
+ Documentation = "https://api.foretak.dev/llms-full.txt"
59
+ Repository = "https://github.com/foretak/registry-mcp"
60
+ Issues = "https://github.com/foretak/registry-mcp/issues"
61
+ "Canonical package" = "https://pypi.org/project/registry-mcp/"
62
+
63
+ # Same entry point as `registry-mcp`, re-exported by `brreg_mcp/__init__.py`.
64
+ [project.scripts]
65
+ brreg-mcp = "brreg_mcp:main"
66
+
67
+ [build-system]
68
+ requires = ["hatchling"]
69
+ build-backend = "hatchling.build"
70
+
71
+ [tool.hatch.build.targets.wheel]
72
+ packages = ["src/brreg_mcp"]
@@ -0,0 +1,20 @@
1
+ """``brreg-mcp`` — alias package for ``registry-mcp``.
2
+
3
+ This distribution contains no logic of its own. It exists so that the search
4
+ terms an agent actually generates for Norwegian company data — ``brreg``,
5
+ ``brønnøysund``, ``enhetsregisteret``, ``organisasjonsnummer``, ``orgnr`` —
6
+ resolve on PyPI to the same server that ``registry-mcp`` installs
7
+ (``KEYWORDS.md`` §3, ``BRREG_MCP_BUILD_PLAN.md`` §3.2).
8
+
9
+ The console script ``brreg-mcp`` is the *same* entry point as ``registry-mcp``:
10
+ :func:`registry_mcp.mcp.server.main`, serving the five MCP tools over stdio.
11
+ Never fork behaviour here — if the two commands ever diverge, one of them is a
12
+ bug.
13
+ """
14
+
15
+ from __future__ import annotations
16
+
17
+ from registry_mcp import __version__ as registry_mcp_version
18
+ from registry_mcp.mcp.server import main, mcp
19
+
20
+ __all__ = ["main", "mcp", "registry_mcp_version"]