nordic-data 0.1.0 → 0.2.0

package/README.md

@@ -1,160 +1,129 @@
-# nordic-data
+# Nordic Data MCP Server
 
-Every Norwegian company as one API, from your terminal.
+> Live Nordic public-sector and Norwegian + Swedish corporate data, exposed as 29 MCP tools for AI agents.
 
-```sh
-npx nordic-data search equinor
-npx nordic-data lookup 923609016
-npx nordic-data contacts 923609016
-npx nordic-data finances 923609016
-```
+**Hosted at:** `https://api.nordicdata.cloud/mcp`
+**Get a free API key:** [nordicdata.cloud](https://nordicdata.cloud)
+**Docs:** [nordicdata.cloud/docs#mcp](https://nordicdata.cloud/docs#mcp)
+**Smithery one-click install:** [smithery.ai/server/sofia-jameson-20/Nordic-Data](https://smithery.ai/server/sofia-jameson-20/Nordic-Data)
 
-## Install
+This repository contains setup instructions and configuration snippets. The server itself is hosted — no local install required.
 
-```sh
-npm install -g nordic-data
-# or just use npx
-npx nordic-data --help
-```
+---
 
-## Free tier
+## What's covered
 
-5,000 requests per month with an API key. Without a key, the CLI uses the public widget tier (4 full snapshots per IP per 24 hours). Get a key:
+- **Public procurement** — Nordic tender notices and contract awards across two coverage tiers: an EU-tier (above-EU-threshold notices for Norway, Sweden, Denmark, Finland, Iceland) AND a Norway-tier (Norway-only, **including below-EU-threshold municipal/county tenders that no other API exposes cleanly**)
+- **Norwegian company registry** — full company data + complete shareholder cap tables (3M+ positions across 396K companies)
+- **Swedish company data** — identity (name, address, VAT registration) for any of ~1.6M Swedish companies, plus AI-enriched contact data (verified emails, direct phones, named executives) via the dedicated Sweden contact tool
+- **Danish + Finnish company data** — identity, addresses, basic phone/employees (Denmark) and multilingual name history (Finland)
+- **Officer & ownership network** — board memberships, shortest-path queries, full role history (Norway)
+- **News** — Norwegian-language news mentioning a company
+- **R&D activity** — research-grant history per recipient
+- **Tech intelligence** — find companies using a specific technology
+- **Compliance** — sanctions screening for any name or company + officers (global watchlist coverage)
+- **AI summaries** — executive narratives and peer benchmarks per company
 
-```sh
-npx nordic-data signup
-# or visit https://nordicdata.cloud/?signup=free
-```
+## Setup
 
-Set the key as an environment variable:
+### Claude Desktop
 
-```sh
-export NORDIC_DATA_KEY=nrd_live_...
-```
+Edit `claude_desktop_config.json`:
 
-You can also pass `--key <key>` per invocation.
-
-## Commands
-
-| Command | What it does |
-|---|---|
-| `search <query>` | Search Norwegian companies by name or fragment |
-| `lookup <orgnr>` | Full snapshot for one organisation number (registry + officers + finances + sanctions + contacts) |
-| `contacts <orgnr>` | Emails, phones, and named executives |
-| `board <orgnr>` | Current board + leadership |
-| `finances <orgnr>` | Latest financial summary (revenue, operating profit, equity, ratios) |
-| `procurement <orgnr>` | Doffin public-sector contract aggregates |
-| `grants <orgnr>` | EU R&D grants (Horizon Europe, EIC) |
-| `sanctions <orgnr>` | Sanctions screening (EU, UN, OFAC) hits |
-| `shareholders <orgnr>` | Aksjonærregisteret aggregates |
-| `mcp` | Show MCP setup snippet for Claude Desktop or Cursor |
-| `signup` | Open the free-tier signup in your browser |
-
-## Examples
-
-Find a company:
-
-```sh
-$ npx nordic-data search equinor
-8 result(s) for "equinor"
-  923609016  EQUINOR ASA  · STAVANGER
-  959733600  EQUINOR PENSJON  · STAVANGER
-  ...
+```json
+{
+  "mcpServers": {
+    "nordic-data": {
+      "url": "https://api.nordicdata.cloud/mcp",
+      "headers": {
+        "X-API-Key": "YOUR_API_KEY_HERE"
+      }
+    }
+  }
+}
 ```
 
-Get the full picture (verified live against api.nordicdata.cloud):
-
-```sh
-$ npx nordic-data lookup 923609016
-EQUINOR ASA (923609016)
-  Status           active
-  Founded          1995-03-12
-  Legal form       ASA (Allmennaksjeselskap)
-  NACE             06.100  Utvinning av råolje
-  Address          Forusbeen 50
-  City             4035 STAVANGER
-  Employees        21376
-  VAT reg.         yes
-  Website          www.equinor.com
-  Phone            +47 406 37 334
-  Email            apost@equinor.com
-
-Key personnel
-  Chief Executive Officer          Anders Opedal
-  Chief Financial Officer          Torgrim Reitan
-  Chairman of the Board            Jon Erik Reinhardsen
-  ...
-```
+Restart Claude Desktop. The 29 tools appear in the MCP picker.
 
-Financials:
-
-```sh
-$ npx nordic-data finances 923609016
-Financials (FY2024) for EQUINOR ASA
-  Revenue          USD 72.54B
-  Operating profit USD 10.35B
-  Net result       USD 8.14B
-  Total assets     USD 109.15B
-  Equity           USD 41.09B
-  Equity ratio     37.6%
-  Net margin       11.2%
-```
-
-JSON output for scripting:
+### Cursor
 
-```sh
-$ npx nordic-data lookup 923609016 --json | jq .identity.name
-"EQUINOR ASA"
-```
+Edit `~/.cursor/mcp.json` with the same JSON.
 
-Sanctions screening:
+### Any MCP-aware client
 
-```sh
-$ npx nordic-data sanctions 923609016
-Sanctions screening for EQUINOR ASA
-  ● Officer hits: 1 (of 15 screened)
 ```
-
-## MCP setup for Claude Desktop / Cursor
-
-```sh
-$ npx nordic-data mcp
+URL:       https://api.nordicdata.cloud/mcp
+Header:    X-API-Key: <your key>
+Transport: Streamable HTTP
 ```
 
-prints the JSON snippet to drop into your MCP client config. Or visit our listings:
-
-- [Smithery](https://smithery.ai/servers/sofia-jameson-20/Nordic-Data)
-- [mcp.so](https://mcp.so/server/nordic-data)
-- [PulseMCP](https://www.pulsemcp.com/servers/nordic-data)
-
-## What data is in Nordic Data?
-
-Every Norwegian company joined on the organisation number:
-
-- **Brønnøysundregistrene** — name, address, NACE, status, board, signatories (real-time, < 5 min lag)
-- **Aksjonærregisteret** — shareholders with recursive UBO chain (annual snapshot)
-- **Doffin** — public-sector procurement filings (live)
-- **EU R&D grants** — Horizon Europe, EIC, joined to Norwegian recipients
-- **Sanctions** — EU, UN, OFAC, screened by org and by officer
-- **Enriched contacts** — 4-layer pipeline lifts contact-fill rate from 23% to 81% on the top 5,000 companies. [How it works](https://nordicdata.cloud/blog/four-layer-contact-enrichment).
-- **Financial summaries** — revenue, operating profit, equity, ratios — last 5 reported years
+## Tools (29 total)
+
+### Procurement
+- `search_tenders` — Nordic procurement notices by country, keyword, CPV, date. Filter by coverage tier (EU-tier across all 5 Nordic countries, or Norway-tier including below-threshold municipal awards). Filter by `buyer_orgnr` to find all tenders from a specific Norwegian buyer.
+- `get_tender` — Full details by ID. Accepts both EU-tier format (`317565-2026`) and Norway-tier format (`2026-108414`).
+- `search_awards` — Search contract awards (who won what)
+- `get_tender_leaderboard` — Top public-sector buyers in a Nordic country
+- `get_company_contract_wins` — Public-sector contracts won by a Norwegian company
+
+### Company data
+- `search_companies` — Search by name, industry, location (Norway: full-text; Denmark + Finland: identity-only; Sweden + Iceland: not yet supported for full-text — use `get_company` for orgnr lookup)
+- `get_company` — Full registry record. `country=NOR` (richest), `SWE` (identity), `DNK` (identity + phone + employees), `FIN` (identity + name history)
+- `get_company_contact` — Norway: public email + phone (with MX-verified email candidates) + named executives
+- **`get_company_se_contact` — Sweden: identity + AI-enriched contacts (MX-verified emails, direct phones, named executives where publicly documented)**
+- `get_company_narrative` — AI-generated executive summary
+- `get_company_peers` — Peer-cohort benchmarks
+- `get_company_snapshot` — One-call snapshot across every data layer
+- `get_company_changes` — Registry change history
+- `get_company_subsidiaries` — Subsidiaries registered under this orgnr
+- `bulk_get_companies` — Enrich a list of up to 100 companies in one call
+
+### Financials & ownership (Norway)
+- `get_company_accounts` — Annual accounts (revenue, profit, equity)
+- `get_company_shareholders` — Full shareholder list — 3M+ positions across 396K companies
+- `get_shareholder_portfolio` — All companies a person/entity owns shares in
+
+### Officer & network graph (Norway)
+- `search_persons` — Search persons in the Norwegian officer network
+- `get_person` — Full role history across Norwegian companies
+- `find_company_path` — Shortest path between two companies through shared officers
+- `get_person_network` — Find who is connected to a person via shared boards
+
+### News
+- `get_company_news` — Recent Norwegian-language news mentioning a company
+- `search_news` — Search Norwegian news headlines
+
+### R&D
+- `search_eu_grants` — Search EU research-grant history
+- `get_company_eu_grants` — Norwegian company's R&D grant participations
+
+### Tech intelligence
+- `find_companies_using_tech` — Norwegian companies using a specific technology
+
+### Compliance
+- `screen_for_sanctions` — Screen any name against international sanctions lists
+- `check_company_sanctions` — Sanctions screening for a Norwegian company + its officers
+
+## Example prompts
+
+- *"Which Norwegian municipalities tendered snow-clearing contracts under 5M NOK with deadlines in the next 30 days?"* (uses below-threshold municipal coverage)
+- *"Pull the latest accounts and shareholders for orgnr 923609016."*
+- *"Get the verified contact emails and CFO for Klarna AB (Swedish orgnr 5566370985)."*
+- *"Find Norwegian companies using Snowflake."*
+- *"Who sits on the boards of all three of these companies?"*
+- *"Screen this list of suppliers against sanctions lists."*
+- *"Show me R&D grants won by Norwegian SMBs in clean energy."*
 
 ## Pricing
 
-Free tier: 5,000 requests / month. Paid tiers from €29/mo (25,000 req) to €499/mo (500,000 req). [Full pricing](https://nordicdata.cloud/#pricing).
-
-## Comparison vs other vendors
-
-We publish an honest benchmark page comparing Nordic Data against OpenCorporates, BvD/Orbis, Bisnode, Proff, Strise, and Sumsub: [https://nordicdata.cloud/coverage](https://nordicdata.cloud/coverage).
-
-## License
+- **Free** — 500 requests/month, no card required
+- **Paid plans** from €49/mo
 
-MIT — see LICENSE.
+See [nordicdata.cloud](https://nordicdata.cloud).
 
-## Links
+## Support
 
-- Web: https://nordicdata.cloud
-- Docs: https://nordicdata.cloud/docs
-- Blog: https://nordicdata.cloud/blog
-- Smithery (MCP): https://smithery.ai/servers/sofia-jameson-20/Nordic-Data
-- Issues: support@nordicdata.cloud
+- Email: [hello@nordicdata.cloud](mailto:hello@nordicdata.cloud)
+- Docs: [nordicdata.cloud/docs](https://nordicdata.cloud/docs)
+- LLM-friendly site index: [nordicdata.cloud/llms.txt](https://nordicdata.cloud/llms.txt)
+- OpenAPI spec: [api.nordicdata.cloud/openapi.json](https://api.nordicdata.cloud/openapi.json)

package/bin/cli.js

@@ -35,10 +35,11 @@ ${c('bold', 'COMMANDS')}
   contacts <orgnr>           Emails, phones, and named executives
   board <orgnr>              Board + leadership
   finances <orgnr>           Latest financial summary
-  procurement <orgnr>        Public-sector contract aggregates (Doffin)
-  grants <orgnr>             EU R&D grants (Horizon, EIC)
+  procurement <orgnr>        Public-sector contract aggregates (NO + EU)
+  grants <orgnr>             EU R&D grant participations
   sanctions <orgnr>          Sanctions screening (EU/UN/OFAC) hits
-  shareholders <orgnr>       Aksjonærregisteret aggregates
+  shareholders <orgnr>       Shareholder graph aggregates (Norway)
+  contacts-se <orgnr>        Sweden: identity + AI-enriched contacts (10-digit orgnr)
   mcp                        Show MCP setup snippet for Claude Desktop / Cursor
   signup                     Open the free-tier signup page in your browser
   --help, -h                 Show this help
@@ -55,6 +56,9 @@ ${c('bold', 'EXAMPLES')}
   nordic-data lookup 923609016
   nordic-data contacts 923609016
 
+  ${c('dim', '# Sweden: lookup + AI-enriched contacts (10-digit orgnr)')}
+  nordic-data contacts-se 5566370985
+
   ${c('dim', '# Use your API key for higher limits')}
   export NORDIC_DATA_KEY=nrd_live_...
   nordic-data lookup 923609016 --json | jq
@@ -63,7 +67,7 @@ ${c('bold', 'EXAMPLES')}
   nordic-data mcp
 
 ${c('bold', 'FREE TIER')}
-  ${c('orange', '5,000 requests per month, no card.')} Get a key at
+  ${c('orange', '500 requests per month, no card.')} Get a key at
   ${c('cyan', 'https://nordicdata.cloud/?signup=free')}
   ${c('dim', 'Without a key, this CLI uses the public widget tier (4 lookups/IP/24h).')}
 `;
@@ -258,7 +262,7 @@ async function procurement(orgnr) {
   const snap = await publicRequest(`/_/look/${orgnr}`);
   const p = snap.procurement || {};
   if (useJson) return console.log(JSON.stringify(p, null, 2));
-  header(`Doffin procurement aggregates for ${id(snap).name || orgnr}`);
+  header(`Public procurement aggregates for ${id(snap).name || orgnr}`);
   pretty('Tenders as buyer', `${p.tenders_as_buyer_24m || 0} (24m)`);
   pretty('Contracts won',    `${p.contracts_won_24m || 0} (24m)`);
   pretty('Contract value',   p.contract_wins_value_24m && `NOK ${p.contract_wins_value_24m.toLocaleString('nb-NO')} (24m)`);
@@ -311,13 +315,40 @@ async function shareholders(orgnr) {
   const snap = await publicRequest(`/_/look/${orgnr}`);
   const sh = snap.shareholders || {};
   if (useJson) return console.log(JSON.stringify(sh, null, 2));
-  header(`Aksjonærregisteret summary for ${id(snap).name || orgnr}`);
+  header(`Shareholder summary for ${id(snap).name || orgnr}`);
   pretty('Fiscal year',  sh.fiscal_year);
   pretty('Shareholders', sh.count);
   pretty('Total shares', sh.total_shares && sh.total_shares.toLocaleString('nb-NO'));
   console.log(c('dim', '\n  Full UBO chain available via authenticated /companies/:orgnr/ownership.'));
 }
 
+
+async function contactsSe(orgnr) {
+  if (!orgnr) die('Usage: nordic-data contacts-se <orgnr>  (Swedish 10-digit organisation number)');
+  const cleaned = String(orgnr).replace(/[-\s]/g, '');
+  if (!/^\d{10}$/.test(cleaned)) die('Swedish orgnr must be 10 digits (with or without dash).');
+  const data = await publicRequest(`/companies/se/${cleaned}/contact`);
+  if (useJson) return console.log(JSON.stringify(data, null, 2));
+  header(`${data.name || 'Swedish company'} ${c('dim', `(${data.orgnr_formatted || cleaned})`)}`);
+  pretty('VAT number', data.vat_number);
+  pretty('Address', data.address);
+  const emails = data.emails || [];
+  const phones = data.phones || [];
+  if (phones.length) pretty('Phone', phones[0]);
+  if (emails.length) pretty('Email', emails[0]);
+  const nc = data.named_contacts || [];
+  if (nc.length) {
+    header('Named contacts');
+    for (const p of nc.slice(0, 10)) {
+      const extras = [p.email, p.phone].filter(Boolean).join('  ·  ');
+      console.log(`  ${c('orange', (p.role || '').slice(0, 32).padEnd(32))} ${c('bold', p.name)}${extras ? c('dim', `  · ${extras}`) : ''}`);
+    }
+  }
+  if (data.cached) console.log(c('dim', `\n  (cached, fetched ${data.fetched_at || ''})`));
+  console.log('');
+  console.log(c('dim', 'Sweden contact data uses your monthly contact-enrichment credits.'));
+}
+
 function mcp() {
   console.log(`${c('bold', 'MCP setup for Claude Desktop / Cursor')}\n`);
   console.log(c('dim', '# Add to your MCP client config (e.g. claude_desktop_config.json):'));
@@ -331,7 +362,7 @@ function mcp() {
   };
   console.log(JSON.stringify(snippet, null, 2));
   console.log('');
-  console.log(c('dim', 'Get a free key (5,000 req/mo) at ') + c('cyan', 'https://nordicdata.cloud/?signup=free'));
+  console.log(c('dim', 'Get a free key (500 req/mo) at ') + c('cyan', 'https://nordicdata.cloud/?signup=free'));
   console.log(c('dim', 'Listed on Smithery: ') + c('cyan', 'https://smithery.ai/servers/sofia-jameson-20/Nordic-Data'));
   console.log(c('dim', 'Listed on mcp.so: ') + c('cyan', 'https://mcp.so/server/nordic-data'));
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "nordic-data",
-  "version": "0.1.0",
-  "description": "CLI for Nordic Data — every Norwegian company as one API. Look up companies, board members, owners, sanctions, procurement, EU grants, and financial summaries from your terminal.",
+  "version": "0.2.0",
+  "description": "CLI for Nordic Data \u2014 every Norwegian and Swedish company as one API. Look up companies, board members, owners, sanctions, public procurement, R&D grants, AI-enriched contacts (NO + SE), and financial summaries from your terminal.",
   "bin": {
     "nordic-data": "./bin/cli.js"
   },
@@ -13,16 +13,16 @@
   "keywords": [
     "norway",
     "norwegian",
+    "sweden",
+    "swedish",
+    "nordic",
     "company",
     "data",
-    "brreg",
-    "bronnoysund",
-    "aksjonaerregisteret",
-    "doffin",
+    "cli",
     "kyb",
     "aml",
     "sanctions",
-    "cli",
+    "procurement",
     "mcp",
     "nordic-data"
   ],