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.
- brreg_mcp-0.1.0/.gitignore +32 -0
- brreg_mcp-0.1.0/PKG-INFO +90 -0
- brreg_mcp-0.1.0/README.md +58 -0
- brreg_mcp-0.1.0/pyproject.toml +72 -0
- brreg_mcp-0.1.0/src/brreg_mcp/__init__.py +20 -0
|
@@ -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/
|
brreg_mcp-0.1.0/PKG-INFO
ADDED
|
@@ -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"]
|