@ansvar/ch-environmental-compliance-mcp 0.1.0

package/src/tools/get-nutrient-loss-limits.ts

@@ -0,0 +1,44 @@
+import { buildMeta } from '../metadata.js';
+import { validateJurisdiction } from '../jurisdiction.js';
+import type { Database } from '../db.js';
+
+interface NutrientLossArgs {
+  nutrient?: string;
+  jurisdiction?: string;
+}
+
+export function handleGetNutrientLossLimits(db: Database, args: NutrientLossArgs) {
+  const jv = validateJurisdiction(args.jurisdiction);
+  if (!jv.valid) return jv.error;
+
+  let sql = 'SELECT * FROM nutrient_loss_limits WHERE jurisdiction = ?';
+  const params: unknown[] = [jv.jurisdiction];
+
+  if (args.nutrient) {
+    sql += ' AND LOWER(nutrient) = LOWER(?)';
+    params.push(args.nutrient);
+  }
+
+  sql += ' ORDER BY nutrient, year';
+
+  const limits = db.all<{
+    nutrient: string; year: number; limit_pct: number;
+    target: string; legal_basis: string; notes: string;
+  }>(sql, params);
+
+  return {
+    jurisdiction: jv.jurisdiction,
+    limits_count: limits.length,
+    limits: limits.map(l => ({
+      nutrient: l.nutrient,
+      year: l.year,
+      reduction_target_pct: l.limit_pct,
+      target: l.target,
+      legal_basis: l.legal_basis,
+      notes: l.notes,
+    })),
+    _meta: buildMeta({
+      source_url: 'https://www.blw.admin.ch/blw/de/home/nachhaltige-produktion/umwelt/naehrstoffe.html',
+    }),
+  };
+}

package/src/tools/get-water-protection-zones.ts

@@ -0,0 +1,50 @@
+import { buildMeta } from '../metadata.js';
+import { validateJurisdiction } from '../jurisdiction.js';
+import type { Database } from '../db.js';
+
+interface WaterProtectionArgs {
+  zone_type?: string;
+  jurisdiction?: string;
+}
+
+export function handleGetWaterProtectionZones(db: Database, args: WaterProtectionArgs) {
+  const jv = validateJurisdiction(args.jurisdiction);
+  if (!jv.valid) return jv.error;
+
+  let sql = 'SELECT * FROM water_protection_zones WHERE jurisdiction = ?';
+  const params: unknown[] = [jv.jurisdiction];
+
+  if (args.zone_type) {
+    sql += ' AND LOWER(zone_type) = LOWER(?)';
+    params.push(args.zone_type);
+  }
+
+  sql += ' ORDER BY zone_type';
+
+  const zones = db.all<{
+    zone_type: string; name: string; restrictions: string;
+    description: string; legal_basis: string;
+  }>(sql, params);
+
+  if (zones.length === 0 && args.zone_type) {
+    return {
+      error: 'not_found',
+      message: `No water protection zone of type '${args.zone_type}' found. Valid types: S1, S2, S3, Sm, Zu.`,
+    };
+  }
+
+  return {
+    jurisdiction: jv.jurisdiction,
+    zones_count: zones.length,
+    zones: zones.map(z => ({
+      zone_type: z.zone_type,
+      name: z.name,
+      restrictions: z.restrictions,
+      description: z.description,
+      legal_basis: z.legal_basis,
+    })),
+    _meta: buildMeta({
+      source_url: 'https://www.bafu.admin.ch/bafu/de/home/themen/wasser/fachinformationen/gewaesserschutz.html',
+    }),
+  };
+}

package/src/tools/list-sources.ts

@@ -0,0 +1,75 @@
+import { buildMeta } from '../metadata.js';
+import type { Database } from '../db.js';
+
+interface Source {
+  name: string;
+  authority: string;
+  official_url: string;
+  retrieval_method: string;
+  update_frequency: string;
+  license: string;
+  coverage: string;
+  last_retrieved?: string;
+}
+
+export function handleListSources(db: Database): { sources: Source[]; _meta: ReturnType<typeof buildMeta> } {
+  const lastIngest = db.get<{ value: string }>('SELECT value FROM db_metadata WHERE key = ?', ['last_ingest']);
+
+  const sources: Source[] = [
+    {
+      name: 'Gewaesserschutzgesetz (GSchG) / Gewaesserschutzverordnung (GSchV)',
+      authority: 'BAFU (Bundesamt fuer Umwelt)',
+      official_url: 'https://www.bafu.admin.ch/bafu/de/home/themen/wasser/fachinformationen/gewaesserschutz.html',
+      retrieval_method: 'PDF_EXTRACT',
+      update_frequency: 'periodic (amendments as enacted)',
+      license: 'Swiss Federal Administration — free reuse',
+      coverage: 'Grundwasserschutzzonen S1-S3/Sm/Zu, Pufferstreifen, Gewaesserraum',
+      last_retrieved: lastIngest?.value,
+    },
+    {
+      name: 'Luftreinhalte-Verordnung (LRV) / Ammoniak-Emissionsfaktoren',
+      authority: 'BAFU / Agroscope',
+      official_url: 'https://www.bafu.admin.ch/bafu/de/home/themen/luft/fachinformationen/luftschadstoffquellen/emissionen-der-landwirtschaft.html',
+      retrieval_method: 'PDF_EXTRACT',
+      update_frequency: 'periodic (Agrammon model updates)',
+      license: 'Swiss Federal Administration — free reuse',
+      coverage: 'Ammoniakemissionen nach Ausbringtechnik, Lagerung, Tierkategorie',
+      last_retrieved: lastIngest?.value,
+    },
+    {
+      name: 'Direktzahlungsverordnung (DZV) — BFF-Typen und OELN',
+      authority: 'BLW (Bundesamt fuer Landwirtschaft)',
+      official_url: 'https://www.blw.admin.ch/blw/de/home/instrumente/direktzahlungen/biodiversitaetsbeitraege.html',
+      retrieval_method: 'PDF_EXTRACT',
+      update_frequency: 'annual (with DZV revisions)',
+      license: 'Swiss Federal Administration — free reuse',
+      coverage: 'BFF-Typen QI/QII, Beitraege, Mindestanteil, botanische Kriterien',
+      last_retrieved: lastIngest?.value,
+    },
+    {
+      name: 'Pa.Iv. 19.475 — Absenkpfad Naehrstoffverluste',
+      authority: 'Parlament / BLW',
+      official_url: 'https://www.blw.admin.ch/blw/de/home/nachhaltige-produktion/umwelt/naehrstoffe.html',
+      retrieval_method: 'PDF_EXTRACT',
+      update_frequency: 'annual targets through 2030',
+      license: 'Swiss Federal Administration — free reuse',
+      coverage: 'N- und P-Verlust-Reduktionsziele, jaehrliche Absenkpfade',
+      last_retrieved: lastIngest?.value,
+    },
+    {
+      name: 'VBBo — Verordnung ueber Belastungen des Bodens',
+      authority: 'BAFU',
+      official_url: 'https://www.bafu.admin.ch/bafu/de/home/themen/boden/fachinformationen/bodenschutz.html',
+      retrieval_method: 'PDF_EXTRACT',
+      update_frequency: 'periodic',
+      license: 'Swiss Federal Administration — free reuse',
+      coverage: 'Schwermetall-Richtwerte (Cd, Cu, Zn, Pb), Massnahmen bei Ueberschreitung',
+      last_retrieved: lastIngest?.value,
+    },
+  ];
+
+  return {
+    sources,
+    _meta: buildMeta(),
+  };
+}

package/src/tools/search-environmental-rules.ts

@@ -0,0 +1,35 @@
+import { buildMeta } from '../metadata.js';
+import { validateJurisdiction } from '../jurisdiction.js';
+import { ftsSearch, type Database } from '../db.js';
+
+interface SearchArgs {
+  query: string;
+  topic?: string;
+  jurisdiction?: string;
+  limit?: number;
+}
+
+export function handleSearchEnvironmentalRules(db: Database, args: SearchArgs) {
+  const jv = validateJurisdiction(args.jurisdiction);
+  if (!jv.valid) return jv.error;
+
+  const limit = Math.min(args.limit ?? 20, 50);
+  let results = ftsSearch(db, args.query, limit);
+
+  if (args.topic) {
+    results = results.filter(r => r.topic.toLowerCase().includes(args.topic!.toLowerCase()));
+  }
+
+  return {
+    query: args.query,
+    jurisdiction: jv.jurisdiction,
+    results_count: results.length,
+    results: results.map(r => ({
+      title: r.title,
+      body: r.body,
+      topic: r.topic,
+      relevance_rank: r.rank,
+    })),
+    _meta: buildMeta(),
+  };
+}

package/tests/db.test.ts

@@ -0,0 +1,80 @@
+import { describe, test, expect, beforeAll, afterAll } from 'vitest';
+import { createDatabase, type Database } from '../src/db.js';
+import { existsSync, unlinkSync } from 'fs';
+
+const TEST_DB = 'tests/test-database.db';
+
+describe('database layer', () => {
+  let db: Database;
+
+  beforeAll(() => {
+    db = createDatabase(TEST_DB);
+  });
+
+  afterAll(() => {
+    db.close();
+    if (existsSync(TEST_DB)) unlinkSync(TEST_DB);
+  });
+
+  test('creates database with db_metadata table', () => {
+    const row = db.get<{ value: string }>(
+      'SELECT value FROM db_metadata WHERE key = ?',
+      ['schema_version']
+    );
+    expect(row?.value).toBe('1.0');
+  });
+
+  test('creates water_protection_zones table', () => {
+    const result = db.all<{ name: string }>(
+      "SELECT name FROM sqlite_master WHERE type='table' AND name='water_protection_zones'"
+    );
+    expect(result).toHaveLength(1);
+  });
+
+  test('creates buffer_zones table', () => {
+    const result = db.all<{ name: string }>(
+      "SELECT name FROM sqlite_master WHERE type='table' AND name='buffer_zones'"
+    );
+    expect(result).toHaveLength(1);
+  });
+
+  test('creates ammonia_rules table', () => {
+    const result = db.all<{ name: string }>(
+      "SELECT name FROM sqlite_master WHERE type='table' AND name='ammonia_rules'"
+    );
+    expect(result).toHaveLength(1);
+  });
+
+  test('creates bff_types table', () => {
+    const result = db.all<{ name: string }>(
+      "SELECT name FROM sqlite_master WHERE type='table' AND name='bff_types'"
+    );
+    expect(result).toHaveLength(1);
+  });
+
+  test('creates nutrient_loss_limits table', () => {
+    const result = db.all<{ name: string }>(
+      "SELECT name FROM sqlite_master WHERE type='table' AND name='nutrient_loss_limits'"
+    );
+    expect(result).toHaveLength(1);
+  });
+
+  test('creates environmental_rules table', () => {
+    const result = db.all<{ name: string }>(
+      "SELECT name FROM sqlite_master WHERE type='table' AND name='environmental_rules'"
+    );
+    expect(result).toHaveLength(1);
+  });
+
+  test('FTS5 search_index exists', () => {
+    const result = db.all<{ name: string }>(
+      "SELECT name FROM sqlite_master WHERE type='table' AND name='search_index'"
+    );
+    expect(result).toHaveLength(1);
+  });
+
+  test('journal mode is DELETE', () => {
+    const row = db.get<{ journal_mode: string }>('PRAGMA journal_mode');
+    expect(row?.journal_mode).toBe('delete');
+  });
+});

package/tests/helpers/seed-db.ts

@@ -0,0 +1,173 @@
+import { createDatabase, type Database } from '../../src/db.js';
+
+export function createSeededDatabase(dbPath: string): Database {
+  const db = createDatabase(dbPath);
+
+  // Water protection zones (S1, S2, S3)
+  db.run(
+    `INSERT INTO water_protection_zones (zone_type, name, restrictions, description, legal_basis, jurisdiction)
+     VALUES (?, ?, ?, ?, ?, ?)`,
+    ['S1', 'Fassungsbereich', 'Kein Zugang, keine Bauten, keine Duengung, keine PSM', 'Engste Schutzzone direkt um die Trinkwasserfassung', 'GSchG Art. 20, GSchV Art. 29', 'CH']
+  );
+  db.run(
+    `INSERT INTO water_protection_zones (zone_type, name, restrictions, description, legal_basis, jurisdiction)
+     VALUES (?, ?, ?, ?, ?, ?)`,
+    ['S2', 'Engere Schutzzone', 'Keine Bauten, kein Aushub, keine Guellegrube, eingeschraenkte Duengung', 'Schutzzone zum Schutz vor bakterieller Verunreinigung', 'GSchG Art. 20, GSchV Art. 29', 'CH']
+  );
+  db.run(
+    `INSERT INTO water_protection_zones (zone_type, name, restrictions, description, legal_basis, jurisdiction)
+     VALUES (?, ?, ?, ?, ?, ?)`,
+    ['S3', 'Weitere Schutzzone', 'Einschraenkungen fuer Grabungen, Lagerung von Gefahrstoffen', 'Schutzzone zum Schutz vor schwer abbaubaren Stoffen', 'GSchG Art. 20, GSchV Art. 29', 'CH']
+  );
+
+  // Buffer zones
+  db.run(
+    `INSERT INTO buffer_zones (type, distance_m, requirement, source_law, notes, jurisdiction)
+     VALUES (?, ?, ?, ?, ?, ?)`,
+    ['Gewaesser — Pflanzenschutzmittel', 6, 'Kein Einsatz von PSM innerhalb 6m entlang Oberflaechengewaessern', 'ChemRRV Anhang 2.5', 'Standardabstand, produktspezifisch erhoehbar (SPe-Auflagen)', 'CH']
+  );
+  db.run(
+    `INSERT INTO buffer_zones (type, distance_m, requirement, source_law, notes, jurisdiction)
+     VALUES (?, ?, ?, ?, ?, ?)`,
+    ['Gewaesser — Duenger', 3, 'Kein Einsatz von Duenger innerhalb 3m entlang Oberflaechengewaessern', 'OELN/DZV Art. 18', 'Gilt fuer alle Direktzahlungsempfaenger', 'CH']
+  );
+  db.run(
+    `INSERT INTO buffer_zones (type, distance_m, requirement, source_law, notes, jurisdiction)
+     VALUES (?, ?, ?, ?, ?, ?)`,
+    ['Hecke/Feldgehoelz', 3, 'Kein Einsatz von PSM und Duenger innerhalb 3m ab Stockmitte', 'OELN/DZV Art. 18', null, 'CH']
+  );
+
+  // Ammonia rules
+  db.run(
+    `INSERT INTO ammonia_rules (technique, emission_factor, requirement, legal_basis, effective_date, notes, jurisdiction)
+     VALUES (?, ?, ?, ?, ?, ?, ?)`,
+    ['Schleppschlauch', 30, 'Pflicht ab 2024 fuer Betriebe >3 ha in Talzone', 'LRV Anhang 2 Ziff. 5', '2024-01-01', 'Reduktion gegenueber Prallteller ca. 30-50%', 'CH']
+  );
+  db.run(
+    `INSERT INTO ammonia_rules (technique, emission_factor, requirement, legal_basis, effective_date, notes, jurisdiction)
+     VALUES (?, ?, ?, ?, ?, ?, ?)`,
+    ['Prallteller', 100, 'Referenztechnik — hoechster Emissionsfaktor', 'LRV Anhang 2 Ziff. 5', null, 'Basisvergleich fuer Agrammon-Modell', 'CH']
+  );
+  db.run(
+    `INSERT INTO ammonia_rules (technique, emission_factor, requirement, legal_basis, effective_date, notes, jurisdiction)
+     VALUES (?, ?, ?, ?, ?, ?, ?)`,
+    ['Injektion', 10, 'Niedrigste Emissionen, geeignet fuer Ackerbau', 'LRV Anhang 2 Ziff. 5', null, 'Nicht auf allen Boeden einsetzbar', 'CH']
+  );
+
+  // BFF types
+  db.run(
+    `INSERT INTO bff_types (id, name, quality_level, payment_chf_ha, min_area_pct, botanical_criteria, notes, jurisdiction)
+     VALUES (?, ?, ?, ?, ?, ?, ?, ?)`,
+    ['extensiv-wiese-qi', 'Extensiv genutzte Wiese', 'QI', 1500, 7, 'Keine Duengung, 1 Schnitt ab 15. Juni', 'Haeufigster BFF-Typ', 'CH']
+  );
+  db.run(
+    `INSERT INTO bff_types (id, name, quality_level, payment_chf_ha, min_area_pct, botanical_criteria, notes, jurisdiction)
+     VALUES (?, ?, ?, ?, ?, ?, ?, ?)`,
+    ['extensiv-wiese-qii', 'Extensiv genutzte Wiese', 'QII', 2800, 7, 'Mind. 6 Indikatorpflanzen pro Areal, Strukturvielfalt', 'QII erfordert botanische Kartierung', 'CH']
+  );
+  db.run(
+    `INSERT INTO bff_types (id, name, quality_level, payment_chf_ha, min_area_pct, botanical_criteria, notes, jurisdiction)
+     VALUES (?, ?, ?, ?, ?, ?, ?, ?)`,
+    ['buntbrache-qi', 'Buntbrache', 'QI', 3800, 0, 'Ansaat von mind. 30 einheimischen Wildkraeutern', 'Mindestens 1 Jahr stehenlassen', 'CH']
+  );
+  db.run(
+    `INSERT INTO bff_types (id, name, quality_level, payment_chf_ha, min_area_pct, botanical_criteria, notes, jurisdiction)
+     VALUES (?, ?, ?, ?, ?, ?, ?, ?)`,
+    ['hecke-qi', 'Hecke mit Krautsaum', 'QI', 2700, 0, 'Einheimische Strauch- und Baumarten, 3m Krautsaum', 'Pflege alle 5-8 Jahre', 'CH']
+  );
+
+  // Nutrient loss limits
+  db.run(
+    `INSERT INTO nutrient_loss_limits (nutrient, year, limit_pct, target, legal_basis, notes, jurisdiction)
+     VALUES (?, ?, ?, ?, ?, ?, ?)`,
+    ['N', 2025, 10, 'Reduktion N-Verluste um 10% gegenueber 2014-2016', 'LwG Art. 6a (Pa.Iv. 19.475)', 'Zwischenziel', 'CH']
+  );
+  db.run(
+    `INSERT INTO nutrient_loss_limits (nutrient, year, limit_pct, target, legal_basis, notes, jurisdiction)
+     VALUES (?, ?, ?, ?, ?, ?, ?)`,
+    ['N', 2030, 20, 'Reduktion N-Verluste um 20% gegenueber 2014-2016', 'LwG Art. 6a (Pa.Iv. 19.475)', 'Endziel 2030', 'CH']
+  );
+  db.run(
+    `INSERT INTO nutrient_loss_limits (nutrient, year, limit_pct, target, legal_basis, notes, jurisdiction)
+     VALUES (?, ?, ?, ?, ?, ?, ?)`,
+    ['P', 2025, 10, 'Reduktion P-Verluste um 10% gegenueber 2014-2016', 'LwG Art. 6a (Pa.Iv. 19.475)', 'Zwischenziel', 'CH']
+  );
+  db.run(
+    `INSERT INTO nutrient_loss_limits (nutrient, year, limit_pct, target, legal_basis, notes, jurisdiction)
+     VALUES (?, ?, ?, ?, ?, ?, ?)`,
+    ['P', 2030, 20, 'Reduktion P-Verluste um 20% gegenueber 2014-2016', 'LwG Art. 6a (Pa.Iv. 19.475)', 'Endziel 2030', 'CH']
+  );
+
+  // Environmental rules — UVP
+  db.run(
+    `INSERT INTO environmental_rules (topic, rule, authority, legal_basis, threshold, notes, jurisdiction)
+     VALUES (?, ?, ?, ?, ?, ?, ?)`,
+    ['UVP', 'UVP-Pflicht fuer Stallbauten ab Schwellenwert', 'BAFU / kantonale Umweltaemter', 'UVPV Anhang Nr. 80.4', 'Ab 150 GVE (kantonal abweichend)', 'Schwellenwerte variieren je nach Kanton und Tierart', 'CH']
+  );
+  db.run(
+    `INSERT INTO environmental_rules (topic, rule, authority, legal_basis, threshold, notes, jurisdiction)
+     VALUES (?, ?, ?, ?, ?, ?, ?)`,
+    ['UVP', 'UVP-Pflicht fuer Biogasanlagen', 'BAFU / kantonale Umweltaemter', 'UVPV Anhang Nr. 80.5', 'Ab 5000 t Substrat pro Jahr', null, 'CH']
+  );
+
+  // Environmental rules — VBBo
+  db.run(
+    `INSERT INTO environmental_rules (topic, rule, authority, legal_basis, threshold, notes, jurisdiction)
+     VALUES (?, ?, ?, ?, ?, ?, ?)`,
+    ['VBBo', 'Richtwert Cadmium im Boden', 'BAFU', 'VBBo Anhang 1', '0.8 mg/kg (Richtwert)', 'Bei Ueberschreitung: Ursachenabklaerung und Massnahmenplan', 'CH']
+  );
+  db.run(
+    `INSERT INTO environmental_rules (topic, rule, authority, legal_basis, threshold, notes, jurisdiction)
+     VALUES (?, ?, ?, ?, ?, ?, ?)`,
+    ['VBBo', 'Richtwert Kupfer im Boden', 'BAFU', 'VBBo Anhang 1', '40 mg/kg (Richtwert)', 'Haeufig ueberschritten in Rebbergen und Hopfengaerten', 'CH']
+  );
+
+  // db_metadata for freshness
+  db.run(
+    `INSERT OR REPLACE INTO db_metadata (key, value) VALUES (?, ?)`,
+    ['last_ingest', '2026-04-01']
+  );
+  db.run(
+    `INSERT OR REPLACE INTO db_metadata (key, value) VALUES (?, ?)`,
+    ['build_date', '2026-04-01']
+  );
+
+  // FTS5 search index entries
+  db.run(
+    `INSERT INTO search_index (title, body, topic, jurisdiction)
+     VALUES (?, ?, ?, ?)`,
+    ['Grundwasserschutzzone S1', 'Fassungsbereich. Kein Zugang, keine Bauten, keine Duengung, keine PSM.', 'Gewaesserschutz', 'CH']
+  );
+  db.run(
+    `INSERT INTO search_index (title, body, topic, jurisdiction)
+     VALUES (?, ?, ?, ?)`,
+    ['Schleppschlauch-Pflicht', 'Pflicht ab 2024 fuer Betriebe >3 ha in Talzone. Reduktion Ammoniakemissionen.', 'Ammoniak', 'CH']
+  );
+  db.run(
+    `INSERT INTO search_index (title, body, topic, jurisdiction)
+     VALUES (?, ?, ?, ?)`,
+    ['Extensiv genutzte Wiese QII', 'Mind. 6 Indikatorpflanzen pro Areal. Beitrag CHF 2800/ha. BFF-Typ.', 'BFF', 'CH']
+  );
+  db.run(
+    `INSERT INTO search_index (title, body, topic, jurisdiction)
+     VALUES (?, ?, ?, ?)`,
+    ['Pufferstreifen Gewaesser PSM', 'Kein Einsatz von Pflanzenschutzmitteln innerhalb 6m entlang Oberflaechengewaessern.', 'Pufferstreifen', 'CH']
+  );
+  db.run(
+    `INSERT INTO search_index (title, body, topic, jurisdiction)
+     VALUES (?, ?, ?, ?)`,
+    ['UVP Stallbau Schwellenwert', 'UVP-Pflicht fuer Stallbauten ab 150 GVE. Kantonal abweichend.', 'UVP', 'CH']
+  );
+  db.run(
+    `INSERT INTO search_index (title, body, topic, jurisdiction)
+     VALUES (?, ?, ?, ?)`,
+    ['Absenkpfad Stickstoff 2030', 'Reduktion N-Verluste um 20% gegenueber 2014-2016. Pa.Iv. 19.475.', 'Naehrstoffe', 'CH']
+  );
+  db.run(
+    `INSERT INTO search_index (title, body, topic, jurisdiction)
+     VALUES (?, ?, ?, ?)`,
+    ['VBBo Richtwert Cadmium', 'Richtwert Cadmium im Boden 0.8 mg/kg. Bei Ueberschreitung Massnahmenplan.', 'VBBo', 'CH']
+  );
+
+  return db;
+}

package/tests/jurisdiction.test.ts

@@ -0,0 +1,35 @@
+import { describe, test, expect } from 'vitest';
+import { validateJurisdiction, SUPPORTED_JURISDICTIONS } from '../src/jurisdiction.js';
+
+describe('jurisdiction validation', () => {
+  test('accepts CH', () => {
+    const result = validateJurisdiction('CH');
+    expect(result).toEqual({ valid: true, jurisdiction: 'CH' });
+  });
+
+  test('defaults to CH when undefined', () => {
+    const result = validateJurisdiction(undefined);
+    expect(result).toEqual({ valid: true, jurisdiction: 'CH' });
+  });
+
+  test('rejects unsupported jurisdiction', () => {
+    const result = validateJurisdiction('DE');
+    expect(result).toEqual({
+      valid: false,
+      error: {
+        error: 'jurisdiction_not_supported',
+        supported: ['CH'],
+        message: 'This server currently covers Switzerland. More jurisdictions are planned.',
+      },
+    });
+  });
+
+  test('normalises lowercase input', () => {
+    const result = validateJurisdiction('ch');
+    expect(result).toEqual({ valid: true, jurisdiction: 'CH' });
+  });
+
+  test('SUPPORTED_JURISDICTIONS contains CH', () => {
+    expect(SUPPORTED_JURISDICTIONS).toContain('CH');
+  });
+});

package/tests/tools/about.test.ts

@@ -0,0 +1,26 @@
+import { describe, test, expect } from 'vitest';
+import { handleAbout } from '../../src/tools/about.js';
+
+describe('about tool', () => {
+  test('returns server metadata', () => {
+    const result = handleAbout();
+    expect(result.name).toBe('Switzerland Environmental Compliance MCP');
+    expect(result.description).toContain('GSchG');
+    expect(result.jurisdiction).toEqual(['CH']);
+    expect(result.tools_count).toBe(11);
+    expect(result.links).toHaveProperty('homepage');
+    expect(result.links).toHaveProperty('repository');
+    expect(result._meta).toHaveProperty('disclaimer');
+  });
+
+  test('includes version', () => {
+    const result = handleAbout();
+    expect(result.version).toMatch(/^\d+\.\d+\.\d+$/);
+  });
+
+  test('lists data sources', () => {
+    const result = handleAbout();
+    expect(result.data_sources).toBeDefined();
+    expect(result.data_sources.length).toBeGreaterThan(0);
+  });
+});

package/tests/tools/check-freshness.test.ts

@@ -0,0 +1,50 @@
+import { describe, test, expect, beforeAll, afterAll } from 'vitest';
+import { handleCheckFreshness } from '../../src/tools/check-freshness.js';
+import { createSeededDatabase } from '../helpers/seed-db.js';
+import type { Database } from '../../src/db.js';
+import { existsSync, unlinkSync } from 'fs';
+
+const TEST_DB = 'tests/test-freshness.db';
+
+describe('check_data_freshness tool', () => {
+  let db: Database;
+
+  beforeAll(() => {
+    db = createSeededDatabase(TEST_DB);
+  });
+
+  afterAll(() => {
+    db.close();
+    if (existsSync(TEST_DB)) unlinkSync(TEST_DB);
+  });
+
+  test('returns freshness status', () => {
+    const result = handleCheckFreshness(db);
+    expect(['fresh', 'stale', 'unknown']).toContain(result.status);
+  });
+
+  test('returns last_ingest date', () => {
+    const result = handleCheckFreshness(db);
+    expect(result.last_ingest).toBe('2026-04-01');
+  });
+
+  test('returns schema_version', () => {
+    const result = handleCheckFreshness(db);
+    expect(result.schema_version).toBe('1.0');
+  });
+
+  test('includes staleness threshold', () => {
+    const result = handleCheckFreshness(db);
+    expect(result.staleness_threshold_days).toBe(90);
+  });
+
+  test('includes refresh command', () => {
+    const result = handleCheckFreshness(db);
+    expect(result.refresh_command).toContain('ingest.yml');
+  });
+
+  test('includes _meta with disclaimer', () => {
+    const result = handleCheckFreshness(db);
+    expect(result._meta).toHaveProperty('disclaimer');
+  });
+});

package/tests/tools/list-sources.test.ts

@@ -0,0 +1,61 @@
+import { describe, test, expect, beforeAll, afterAll } from 'vitest';
+import { handleListSources } from '../../src/tools/list-sources.js';
+import { createSeededDatabase } from '../helpers/seed-db.js';
+import type { Database } from '../../src/db.js';
+import { existsSync, unlinkSync } from 'fs';
+
+const TEST_DB = 'tests/test-list-sources.db';
+
+describe('list_sources tool', () => {
+  let db: Database;
+
+  beforeAll(() => {
+    db = createSeededDatabase(TEST_DB);
+  });
+
+  afterAll(() => {
+    db.close();
+    if (existsSync(TEST_DB)) unlinkSync(TEST_DB);
+  });
+
+  test('returns sources array', () => {
+    const result = handleListSources(db);
+    expect(result.sources).toBeDefined();
+    expect(result.sources.length).toBeGreaterThan(0);
+  });
+
+  test('each source has required fields', () => {
+    const result = handleListSources(db);
+    for (const source of result.sources) {
+      expect(source).toHaveProperty('name');
+      expect(source).toHaveProperty('authority');
+      expect(source).toHaveProperty('official_url');
+      expect(source).toHaveProperty('license');
+    }
+  });
+
+  test('includes GSchG source', () => {
+    const result = handleListSources(db);
+    const gschg = result.sources.find(s => s.name.includes('GSchG'));
+    expect(gschg).toBeDefined();
+    expect(gschg!.authority).toContain('BAFU');
+  });
+
+  test('includes LRV source', () => {
+    const result = handleListSources(db);
+    const lrv = result.sources.find(s => s.name.includes('LRV'));
+    expect(lrv).toBeDefined();
+  });
+
+  test('includes DZV source', () => {
+    const result = handleListSources(db);
+    const dzv = result.sources.find(s => s.name.includes('DZV'));
+    expect(dzv).toBeDefined();
+    expect(dzv!.authority).toContain('BLW');
+  });
+
+  test('includes _meta with disclaimer', () => {
+    const result = handleListSources(db);
+    expect(result._meta).toHaveProperty('disclaimer');
+  });
+});