Swedish intelligence API
for AI agents.

21 tools covering insolvency risk and early-warning signals, municipal procurement, and BRF renovation intelligence — exposed as a single MCP server. Connect in 60 seconds via Claude Code, Cursor, or Windsurf.

Quick start

Get access to 21 Swedish intelligence tools in under 60 seconds.

Step 1 — Get an API key

Request free sandbox access at norric.io/api-keys. Sandbox keys are issued immediately and include 100 free calls.

Step 2 — Claude Code (recommended)

claude mcp add norric https://norric-mcp-production.up.railway.app/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

Then use any tool directly in Claude Code:

# Score a Swedish company for insolvency risk
mcp__norric__kreditvakt_score_company_v1(orgnr="556012-3456")

# Get this week's procurement call list
mcp__norric__signal_weekly_call_list_v1(vertikal="aldreomsorg", limit=10)

# Check pipeline freshness before acting
mcp__norric__norric_data_freshness_v1()

Step 3 — Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "norric": {
      "url": "https://norric-mcp-production.up.railway.app/mcp",
      "transport": "streamable-http",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Step 4 — Cursor or Windsurf

Edit .cursor/mcp.json:

{
  "mcpServers": {
    "norric": {
      "url": "https://norric-mcp-production.up.railway.app/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Authentication

All requests require a Bearer token passed via the Authorization header.

Authorization: Bearer nrk_your_key_here

Get a key: norric.io/api-keys

Key tiers

Missing or invalid key returns:

{
  "error": "Invalid API key. Get yours at norric.io/api-keys"
}

Connect your agent

Claude Code and Claude Desktop handle the MCP handshake automatically. For direct HTTP calls, a two-step session initialization is required.

Direct curl — two-step handshake

# Step 1 — Initialize and capture session ID
SESSION=$(curl -si https://norric-mcp-production.up.railway.app/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{
    "protocolVersion":"2024-11-05",
    "capabilities":{},
    "clientInfo":{"name":"curl","version":"1.0"}
  }}' \
  | grep -i "mcp-session-id" | awk '{print $2}' | tr -d '\r')

# Step 2 — Call a tool
curl -s https://norric-mcp-production.up.railway.app/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "mcp-session-id: $SESSION" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{
    "name":"kreditvakt_score_company_v1",
    "arguments":{"orgnr":"556012-3456"}
  }}'

Health check

curl https://norric-mcp-production.up.railway.app/health
# → {"status":"ok","tools":21,"version":"2.0.0"}

Tools reference

21 tools across 4 products. All tools accept Swedish organisation numbers (orgnr) in format XXXXXX-XXXX.

Kreditvakt — Insolvency scoring live

9–10 month warning lead time. 6× lift vs naïve base rate. Covers all Swedish aktiebolag from four independent signal sources: Skatteverket restanslängd, Kronofogden betalningsförelägganden, Bolagsverket ärenden (pre-registration leading indicator), and Bolagsverket konkursregister. Early-warning tier includes F-skatt registration, building permits, and Bolagsverket ownership velocity sensors.

Example response — kreditvakt_score_company_v1:

{
  "insolvency_score": 74,
  "company_name": "Byggfirman Svensson AB",
  "verdict": "Förhöjd riskprofil — aktiva signaler från tre oberoende källor.",
  "f_skatt_active": false,
  "skuld_sek": 340000,
  "betalning_count": 6,
  "kronofogden_escalated": true,
  "arende_ankommet_datum": "2026-04-08",
  "arende_kanal": "Papperspost",
  "konkurs_filed": false,
  "onset_days": 180,
  "median_days_to_konkurs": 285,
  "signal_count": 4,
  "confidence": "hög"
}

SIGNAL — Municipal procurement live

4–8 week lead time before RFP publication. 13 signal sources across all 290 Swedish municipalities.

Verticals: aldreomsorg · skola · it_digital · fastighet · hr · bygg · annat

Municipalities: 4-digit kommunkod, e.g. 1280 (Malmö), 0180 (Stockholm), 1480 (Göteborg).

Sigvik — BRF renovation intelligence live

Renovation intent scoring for Swedish housing cooperatives (BRFs). National coverage: 33,710 BRFs across 289 of 290 Swedish municipalities. EU 2033 energy class deadline flag included.

Infrastructure tools

NorricResponse envelope

Every tool returns a standard envelope. Agents parse structure, not narrative.

{
  "success": true,
  "tool": "kreditvakt_score_company_v1",
  "source": ["skatteverket", "kronofogden", "bolagsverket"],
  "confidence": 0.87,
  "data": { /* tool-specific payload */ },
  "error": null,
  "cached": false,
  "ts": "2026-04-26T18:00:00Z",
  "provenance": [
    {
      "source_agency": "skatteverket",
      "source_document_ref": "orgnr:556012-3456/restanslangd/2026-04",
      "ingested_at": "2026-04-26T06:00:00Z",
      "confidence": 1.0,
      "schema_version": "1.0"
    }
  ]
}

Field reference

Error codes

All errors use the NorricResponse envelope:

{
  "success": false,
  "error": "Invalid API key. Get yours at norric.io/api-keys",
  "data": null
}

Pricing

All plans include access to all 21 tools. Rate limits are per API key per month.

→ Get your free sandbox key

Changelog

v2.0.0 — April 2026

• Added NORRIC_API_KEYS authentication — all 401 errors point to norric.io/api-keys
• Added /health endpoint returning status, tool count, and version
• Added Bolagsverket ärenden leading-indicator signal (arende_ankommet_datum, arende_kanal)
• Kreditvakt warning horizon extended to 9–10 months (median 285 days)
• Fixed all norric.se references → norric.io
• Kreditvakt signal engine: deterministic 4-source scoring, 1000-company consistency validation
• Batch scoring (kreditvakt_batch_score_v1) now returns full portfolio risk summary
• norric_company_profile_v1 wired to Kreditvakt engine

v1.1.0 — April 2026

• Added norric_explain_score_v1 — EU AI Act Article 9 provenance chain
• Added norric_data_freshness_v1 — per-registry ingestion freshness
• Added provenance layer to NorricResponse (21 tools total)
• Supabase provenance table wired to provenance_records

v1.0.0 — April 2026

• Initial release: 19 tools across SIGNAL, Kreditvakt, and Sigvik
• FastMCP 3.2.3 Streamable HTTP transport
• Railway deployment with nixpacks builder
• NorricResponse envelope with confidence, TTL, and source tracing