{"_id":"@ansvar/finnish-standards-mcp","_rev":"2-799f368e1af38781f556921ae0e3b77a","name":"@ansvar/finnish-standards-mcp","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@ansvar/finnish-standards-mcp","version":"0.1.0","keywords":["mcp","finnish","finland","julkri","katakri","ncsc-fi","cybersecurity","compliance","standards"],"author":{"name":"Ansvar Systems","email":"hello@ansvar.eu"},"license":"Apache-2.0","_id":"@ansvar/finnish-standards-mcp@0.1.0","maintainers":[{"name":"ansvar","email":"jeffrey.von.rotz@ansvar.eu"}],"homepage":"https://github.com/Ansvar-Systems/finnish-standards-mcp#readme","bugs":{"url":"https://github.com/Ansvar-Systems/finnish-standards-mcp/issues"},"bin":{"finnish-standards-mcp":"dist/index.js"},"dist":{"shasum":"700b3e36cc68784afbed2f925e294a4f6724a168","tarball":"https://registry.npmjs.org/@ansvar/finnish-standards-mcp/-/finnish-standards-mcp-0.1.0.tgz","fileCount":83,"integrity":"sha512-jisAxKU13v7YWnmruA3zy/L2AuHyy6s2/RqrHXqnhu0GqR5/V3Z54c0MlONgu9S1TMH57k3JKeJssl1aDnf9sg==","signatures":[{"sig":"MEYCIQDrqi1L5r1It4eGhqpXh/HZIR0LzDRuCzsFDRla6n4wdgIhAOlzoHVTwcjqPkDvzuWRKpFMQHrOliuA2nW1gVjbpws9","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@ansvar%2ffinnish-standards-mcp@0.1.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":388509},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=20"},"gitHead":"45a7ea7e7289fa1aa6e8d1d8b3a103cb491d592f","scripts":{"dev":"tsx src/index.ts","lint":"tsc --noEmit","test":"vitest run","build":"tsc","clean":"rm -rf dist && find . -name '*.tsbuildinfo' -delete","start":"node dist/index.js","prepare":"test -f dist/index.js || npm run build","build:db":"node --import tsx scripts/build-db.ts","dev:http":"tsx src/http-server.ts","start:http":"node dist/http-server.js","test:watch":"vitest","ingest:full":"node --import tsx scripts/ingest-julkri.ts && node --import tsx scripts/ingest-ncsc-fi.ts && node --import tsx scripts/ingest-tietosuoja.ts && node --import tsx scripts/ingest-katakri.ts && node --import tsx scripts/ingest-vahti.ts && node --import tsx scripts/ingest-kanta.ts && node --import tsx scripts/ingest-traficom.ts && node --import tsx scripts/ingest-dvv.ts && node --import tsx scripts/ingest-kyberturvallisuuslaki.ts && node --import tsx scripts/ingest-finanssivalvonta.ts && node --import tsx scripts/ingest-terveydenhuolto.ts && node --import tsx scripts/ingest-energia-liikenne.ts && node --import tsx scripts/ingest-kansalliset-standardit.ts && npm run build:db && npm run coverage:update","test:contract":"vitest run __tests__/contract/","coverage:update":"node --import tsx scripts/update-coverage.ts","coverage:verify":"node --import tsx scripts/verify-coverage.ts","freshness:check":"node --import tsx scripts/check-freshness.ts"},"_npmUser":{"name":"ansvar","email":"jeffrey.von.rotz@ansvar.eu"},"repository":{"url":"git+https://github.com/Ansvar-Systems/finnish-standards-mcp.git","type":"git"},"_npmVersion":"10.8.2","description":"Finnish government cybersecurity standards MCP -- Julkri, Katakri, NCSC-FI guidelines, Tietosuojavaltuutetun ohjeet, VAHTI, Kanta health services security. Part of the Ansvar MCP Network (ansvar.ai/mcp)","directories":{},"_nodeVersion":"20.20.1","dependencies":{"zod":"^3.24.0","@ansvar/mcp-sqlite":"^1.0.3","@modelcontextprotocol/sdk":"^1.25.3"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.21.0","vitest":"^3.0.0","typescript":"^5.9.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/finnish-standards-mcp_0.1.0_1773313005326_0.2559721209215957","host":"s3://npm-registry-packages-npm-production"},"deprecated":"Ansvar MCP servers are now distributed as source from github.com/Ansvar-Systems/finnish-standards-mcp under Apache 2.0. Self-hosting instructions: see the repo README. Hosted gateway: ansvar.eu"}},"time":{"created":"2026-03-12T10:56:45.164Z","modified":"2026-05-02T05:46:58.544Z","0.1.0":"2026-03-12T10:56:45.478Z"},"bugs":{"url":"https://github.com/Ansvar-Systems/finnish-standards-mcp/issues"},"author":{"name":"Ansvar Systems","email":"hello@ansvar.eu"},"license":"Apache-2.0","homepage":"https://github.com/Ansvar-Systems/finnish-standards-mcp#readme","keywords":["mcp","finnish","finland","julkri","katakri","ncsc-fi","cybersecurity","compliance","standards"],"repository":{"url":"git+https://github.com/Ansvar-Systems/finnish-standards-mcp.git","type":"git"},"description":"Finnish government cybersecurity standards MCP -- Julkri, Katakri, NCSC-FI guidelines, Tietosuojavaltuutetun ohjeet, VAHTI, Kanta health services security. Part of the Ansvar MCP Network (ansvar.ai/mcp)","maintainers":[{"name":"ansvar","email":"jeffrey.von.rotz@ansvar.eu"}],"readme":"# Finnish Standards MCP\n\n[![npm version](https://img.shields.io/npm/v/@ansvar/finnish-standards-mcp)](https://www.npmjs.com/package/@ansvar/finnish-standards-mcp)\n[![CI](https://github.com/Ansvar-Systems/finnish-standards-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/Ansvar-Systems/finnish-standards-mcp/actions/workflows/ci.yml)\n[![License](https://img.shields.io/badge/license-Apache--2.0-blue)](LICENSE)\n[![MCP Registry](https://img.shields.io/badge/MCP%20Registry-ansvar.ai%2Fmcp-blue)](https://ansvar.ai/mcp)\n\nStructured access to Finnish government cybersecurity and information security standards: Julkri (DVV), Katakri (Puolustusministerio), NCSC-FI guidelines (Traficom), Tietosuojavaltuutetun ohjeet, VAHTI (VM), and Kanta health services security requirements. Bilingual Finnish/English with FTS search, ISO 27002:2022 cross-references, and sector-based filtering.\n\nPart of the [Ansvar MCP Network](https://ansvar.ai/mcp) -- specialist MCP servers for compliance and security intelligence.\n\n---\n\n## Quick Start\n\n### Remote endpoint (no installation)\n\nAdd to your MCP client config:\n\n```json\n{\n  \"mcpServers\": {\n    \"finnish-standards\": {\n      \"url\": \"https://finnish-standards-mcp.vercel.app/mcp\"\n    }\n  }\n}\n```\n\n### Local (stdio via npx)\n\n**Claude Desktop** -- edit `~/Library/Application Support/Claude/claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"finnish-standards\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@ansvar/finnish-standards-mcp\"]\n    }\n  }\n}\n```\n\n**Cursor** -- edit `.cursor/mcp.json` in your project:\n\n```json\n{\n  \"mcpServers\": {\n    \"finnish-standards\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@ansvar/finnish-standards-mcp\"]\n    }\n  }\n}\n```\n\n**VS Code / GitHub Copilot** -- add to `.vscode/mcp.json`:\n\n```json\n{\n  \"servers\": {\n    \"finnish-standards\": {\n      \"type\": \"stdio\",\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@ansvar/finnish-standards-mcp\"]\n    }\n  }\n}\n```\n\n---\n\n## What's Included\n\n| Source | Authority | Items | Language | Refresh |\n|--------|-----------|-------|----------|---------|\n| Julkri (Julkisen hallinnon tietoturvakriteeri) | DVV | 79 controls | FI+EN | Annual |\n| NCSC-FI Kyberturvallisuusohjeet | Traficom / NCSC-FI | 49 controls | FI+EN | Annual |\n| Tietosuojavaltuutetun ohjeet | Tietosuojavaltuutetun toimisto | 32 controls | FI+EN | Annual |\n| Katakri (Kansallinen turvallisuusauditointikriteeristo) | Puolustusministerio | 35 controls | FI+EN | Annual |\n| VAHTI-ohjeet | Valtiovarainministerio (VM) | 32 controls | FI+EN | Annual |\n| Kanta-palvelujen tietoturvavaatimukset | Kela / THL | 26 controls | FI+EN | Annual |\n\n**Total:** 253 controls across 6 frameworks.\n\nFor full coverage details, see [COVERAGE.md](COVERAGE.md).\n\n---\n\n## What's NOT Included\n\n| Gap | Status |\n|-----|--------|\n| Kyberturvallisuuslaki (NIS2 implementation) | Planned -- Finnish NIS2 transposition under preparation |\n| Suomi.fi requirements | Planned for v0.2 |\n| FICORA legacy directives | Not planned -- superseded by NCSC-FI guidelines |\n| ISO/IEC 27001:2022 full text | Excluded -- commercial ISO license; ISO cross-references available via `get_iso_mapping` |\n\nFor the complete gap list, see [COVERAGE.md -- What's NOT Included](COVERAGE.md#whats-not-included).\n\n---\n\n## Available Tools\n\n| Tool | Category | Description |\n|------|----------|-------------|\n| `search_controls` | Search | Full-text search across all 6 frameworks. Returns controls ranked by FTS5 relevance. |\n| `search_by_sector` | Search | Returns frameworks for a sector (`government`, `healthcare`, `finance`, etc.), optionally filtered by keyword. |\n| `get_control` | Lookup | Full record for a single control: bilingual description, implementation guidance, ISO mapping. |\n| `get_framework` | Lookup | Metadata for a framework: issuing body, version, control count, category breakdown. |\n| `list_controls` | Lookup | All controls in a framework, filterable by category and level. Paginated. |\n| `compare_controls` | Comparison | Side-by-side comparison of the same topic across 2-4 frameworks. |\n| `get_iso_mapping` | Comparison | All Finnish controls mapped to a given ISO 27002:2022 control reference. |\n| `list_frameworks` | Meta | Lists all frameworks in the database with summary stats. |\n| `about` | Meta | Server version, build date, and coverage statistics. |\n| `list_sources` | Meta | Data provenance: authority, standard name, retrieval method, license for each source. |\n| `check_data_freshness` | Meta | Per-source freshness status against the expected refresh schedule. |\n\nFor full parameter documentation, return formats, and examples, see [TOOLS.md](TOOLS.md).\n\n---\n\n## Data Sources & Freshness\n\n| Source | Last Refresh | Refresh Schedule |\n|--------|-------------|-----------------|\n| Julkri | 2026-03-12 | Annual |\n| NCSC-FI Ohjeet | 2026-03-12 | Annual |\n| Tietosuoja Ohjeet | 2026-03-12 | Annual |\n| Katakri | 2026-03-12 | Annual |\n| VAHTI | 2026-03-12 | Annual |\n| Kanta | 2026-03-12 | Annual |\n\nThe `ingest.yml` workflow runs automatically on the most frequent source schedule. The `check-updates.yml` workflow runs daily and creates a GitHub issue if any source is overdue.\n\nTo check freshness at runtime, call `check_data_freshness`. Full source provenance and licenses: [sources.yml](sources.yml).\n\n---\n\n## Security\n\nThis repository runs 6-layer automated security scanning on every push and weekly:\n\n| Layer | Tool | What it checks |\n|-------|------|----------------|\n| Static analysis | CodeQL | Code vulnerabilities |\n| SAST | Semgrep | Security anti-patterns |\n| Container / dependency scan | Trivy | Known CVEs in dependencies |\n| Secret detection | Gitleaks | Leaked credentials |\n| Supply chain | OSSF Scorecard | Repository security posture |\n| Dependency updates | Dependabot | Automated dependency PRs |\n\n---\n\n## Disclaimer\n\n**THIS TOOL IS NOT PROFESSIONAL ADVICE.**\n\nThis MCP provides structured access to Finnish cybersecurity standards sourced from authoritative publications. It is provided for informational and research purposes only.\n\n- Verify critical compliance decisions against the original standards\n- Data is a snapshot -- sources update, and there may be a delay between upstream changes and database refresh\n- See [DISCLAIMER.md](DISCLAIMER.md) for the full disclaimer and no-warranty statement\n\n---\n\n## Ansvar MCP Network\n\nThis server is part of the [Ansvar MCP Network](https://ansvar.ai/mcp) -- 149 specialist MCP servers covering legislation, compliance frameworks, and cybersecurity standards.\n\n| Category | Servers | Coverage |\n|----------|---------|----------|\n| Law MCPs | 108 | 119 countries, 668K+ laws |\n| EU Regulations | 1 | 61 regulations, 4,054 articles |\n| Security frameworks | 1 | 262 frameworks, 1,451 SCF controls |\n| Domain-specific | ~48 | CVE, STRIDE, sanctions, OWASP, healthcare, financial, and more |\n\nBrowse the full directory at [ansvar.ai/mcp](https://ansvar.ai/mcp).\n\n---\n\n## Development\n\n### Branch strategy\n\n`feature-branch -> PR to dev -> verify on dev -> PR to main -> deploy`\n\nNever push directly to `main`. `main` triggers npm publish and Vercel deployment.\n\n### Setup\n\n```bash\ngit clone https://github.com/Ansvar-Systems/finnish-standards-mcp.git\ncd finnish-standards-mcp\nnpm install\nnpm run build\nnpm test\n```\n\n### Ingestion\n\n```bash\n# Full pipeline: ingest all 6 frameworks -> build DB -> update coverage\nnpm run ingest:full\n\n# Individual steps\nnpm run build:db         # Rebuild SQLite database\nnpm run coverage:update  # Regenerate coverage.json and COVERAGE.md\n\n# Check freshness\nnpm run freshness:check\n```\n\n### Pre-deploy verification\n\n```bash\nnpm run build            # Gate 1: build\nnpm run lint             # Gate 2: TypeScript strict\nnpm test                 # Gate 3: unit tests\nnpm run test:contract    # Gate 4: golden contract tests\nnpm run coverage:verify  # Gate 6: coverage consistency\n```\n\n---\n\n## License & Data Licenses\n\n**Code:** [Apache-2.0](LICENSE)\n\n**Data licenses by source:**\n\n| Source | License |\n|--------|---------|\n| Julkri (DVV) | Public sector publication |\n| NCSC-FI (Traficom) | Public sector publication |\n| Tietosuojavaltuutetun ohjeet | Public sector publication |\n| Katakri (Puolustusministerio) | Public sector publication |\n| VAHTI (VM) | Public sector publication |\n| Kanta (Kela / THL) | Public sector publication |\n\nAll data is extracted from publicly available authoritative Finnish government publications. Zero AI-generated content in the database. See [sources.yml](sources.yml) for complete provenance.\n","readmeFilename":"README.md"}