@ansvar/ch-organic-regen-mcp 0.1.0

package/server.json

@@ -0,0 +1,16 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "io.github.Ansvar-Systems/ch-organic-regen",
+  "description": "Swiss organic and regenerative farming -- Bio Suisse Knospe, FiBL Betriebsmittelliste, Demeter, conversion, subsidies, soil health",
+  "repository": {
+    "url": "https://github.com/Ansvar-Systems/ch-organic-regen-mcp",
+    "source": "github"
+  },
+  "version": "0.1.0",
+  "remotes": [
+    {
+      "type": "streamable-http",
+      "url": "https://mcp.ansvar.eu/ch-organic-regen/mcp"
+    }
+  ]
+}

package/src/db.ts

@@ -0,0 +1,225 @@
+import BetterSqlite3 from 'better-sqlite3';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+
+export interface Database {
+  get<T>(sql: string, params?: unknown[]): T | undefined;
+  all<T>(sql: string, params?: unknown[]): T[];
+  run(sql: string, params?: unknown[]): void;
+  close(): void;
+  readonly instance: BetterSqlite3.Database;
+}
+
+export function createDatabase(dbPath?: string): Database {
+  const resolvedPath =
+    dbPath ??
+    join(dirname(fileURLToPath(import.meta.url)), '..', 'data', 'database.db');
+  const db = new BetterSqlite3(resolvedPath);
+
+  db.pragma('journal_mode = DELETE');
+  db.pragma('foreign_keys = ON');
+
+  initSchema(db);
+
+  return {
+    get<T>(sql: string, params: unknown[] = []): T | undefined {
+      return db.prepare(sql).get(...params) as T | undefined;
+    },
+    all<T>(sql: string, params: unknown[] = []): T[] {
+      return db.prepare(sql).all(...params) as T[];
+    },
+    run(sql: string, params: unknown[] = []): void {
+      db.prepare(sql).run(...params);
+    },
+    close(): void {
+      db.close();
+    },
+    get instance() {
+      return db;
+    },
+  };
+}
+
+function initSchema(db: BetterSqlite3.Database): void {
+  db.exec(`
+    CREATE TABLE IF NOT EXISTS organic_standards (
+      id INTEGER PRIMARY KEY,
+      production_type TEXT NOT NULL,
+      standard TEXT NOT NULL,
+      rule TEXT NOT NULL,
+      description TEXT NOT NULL,
+      jurisdiction TEXT NOT NULL DEFAULT 'CH'
+    );
+
+    CREATE TABLE IF NOT EXISTS conversion_requirements (
+      id INTEGER PRIMARY KEY,
+      farm_type TEXT NOT NULL,
+      current_system TEXT NOT NULL,
+      timeline_years INTEGER NOT NULL,
+      requirements TEXT NOT NULL,
+      support_measures TEXT,
+      jurisdiction TEXT NOT NULL DEFAULT 'CH'
+    );
+
+    CREATE TABLE IF NOT EXISTS approved_inputs (
+      id INTEGER PRIMARY KEY,
+      input_type TEXT NOT NULL,
+      product_name TEXT NOT NULL,
+      description TEXT NOT NULL,
+      restrictions TEXT,
+      source TEXT NOT NULL,
+      jurisdiction TEXT NOT NULL DEFAULT 'CH'
+    );
+
+    CREATE TABLE IF NOT EXISTS organic_subsidies (
+      id INTEGER PRIMARY KEY,
+      subsidy_type TEXT NOT NULL,
+      zone TEXT,
+      rate_chf_ha REAL NOT NULL,
+      conditions TEXT NOT NULL,
+      stacking_rules TEXT,
+      jurisdiction TEXT NOT NULL DEFAULT 'CH'
+    );
+
+    CREATE TABLE IF NOT EXISTS soil_health (
+      id INTEGER PRIMARY KEY,
+      topic TEXT NOT NULL,
+      guidance TEXT NOT NULL,
+      technique TEXT NOT NULL,
+      benefits TEXT NOT NULL,
+      jurisdiction TEXT NOT NULL DEFAULT 'CH'
+    );
+
+    CREATE TABLE IF NOT EXISTS certification_guidance (
+      id INTEGER PRIMARY KEY,
+      step TEXT NOT NULL,
+      description TEXT NOT NULL,
+      inspector TEXT,
+      frequency TEXT,
+      cost_notes TEXT,
+      jurisdiction TEXT NOT NULL DEFAULT 'CH'
+    );
+
+    CREATE VIRTUAL TABLE IF NOT EXISTS search_index USING fts5(
+      title, body, topic, jurisdiction
+    );
+
+    CREATE TABLE IF NOT EXISTS db_metadata (
+      key TEXT PRIMARY KEY,
+      value TEXT
+    );
+
+    INSERT OR IGNORE INTO db_metadata (key, value) VALUES ('schema_version', '1.0');
+    INSERT OR IGNORE INTO db_metadata (key, value) VALUES ('mcp_name', 'Switzerland Organic & Regenerative Farming MCP');
+    INSERT OR IGNORE INTO db_metadata (key, value) VALUES ('jurisdiction', 'CH');
+  `);
+}
+
+const FTS_COLUMNS = ['title', 'body', 'topic', 'jurisdiction'];
+
+export function ftsSearch(
+  db: Database,
+  query: string,
+  limit: number = 20
+): { title: string; body: string; topic: string; jurisdiction: string; rank: number }[] {
+  const { results } = tieredFtsSearch(db, 'search_index', FTS_COLUMNS, query, limit);
+  return results as { title: string; body: string; topic: string; jurisdiction: string; rank: number }[];
+}
+
+/**
+ * Tiered FTS5 search with automatic fallback.
+ * Tiers: exact phrase -> AND -> prefix -> stemmed prefix -> OR -> LIKE
+ */
+export function tieredFtsSearch(
+  db: Database,
+  table: string,
+  columns: string[],
+  query: string,
+  limit: number = 20
+): { tier: string; results: Record<string, unknown>[] } {
+  const sanitized = sanitizeFtsInput(query);
+  if (!sanitized.trim()) return { tier: 'empty', results: [] };
+
+  const columnList = columns.join(', ');
+  const select = `SELECT ${columnList}, rank FROM ${table}`;
+  const order = `ORDER BY rank LIMIT ?`;
+
+  // Tier 1: Exact phrase
+  const phrase = `"${sanitized}"`;
+  let results = tryFts(db, select, table, order, phrase, limit);
+  if (results.length > 0) return { tier: 'phrase', results };
+
+  // Tier 2: AND
+  const words = sanitized.split(/\s+/).filter(w => w.length > 1);
+  if (words.length > 1) {
+    const andQuery = words.join(' AND ');
+    results = tryFts(db, select, table, order, andQuery, limit);
+    if (results.length > 0) return { tier: 'and', results };
+  }
+
+  // Tier 3: Prefix
+  const prefixQuery = words.map(w => `${w}*`).join(' AND ');
+  results = tryFts(db, select, table, order, prefixQuery, limit);
+  if (results.length > 0) return { tier: 'prefix', results };
+
+  // Tier 4: Stemmed prefix
+  const stemmed = words.map(w => stemWord(w) + '*');
+  const stemmedQuery = stemmed.join(' AND ');
+  if (stemmedQuery !== prefixQuery) {
+    results = tryFts(db, select, table, order, stemmedQuery, limit);
+    if (results.length > 0) return { tier: 'stemmed', results };
+  }
+
+  // Tier 5: OR
+  if (words.length > 1) {
+    const orQuery = words.join(' OR ');
+    results = tryFts(db, select, table, order, orQuery, limit);
+    if (results.length > 0) return { tier: 'or', results };
+  }
+
+  // Tier 6: LIKE fallback across organic_standards
+  const likeConditions = words.map(() =>
+    `(rule LIKE ? OR description LIKE ? OR production_type LIKE ?)`
+  ).join(' AND ');
+  const likeParams = words.flatMap(w =>
+    [`%${w}%`, `%${w}%`, `%${w}%`]
+  );
+  try {
+    const likeResults = db.all<Record<string, unknown>>(
+      `SELECT rule as title, description as body, production_type as topic, jurisdiction FROM organic_standards WHERE ${likeConditions} LIMIT ?`,
+      [...likeParams, limit]
+    );
+    if (likeResults.length > 0) return { tier: 'like', results: likeResults };
+  } catch {
+    // LIKE fallback failed
+  }
+
+  return { tier: 'none', results: [] };
+}
+
+function tryFts(
+  db: Database, select: string, table: string,
+  order: string, matchExpr: string, limit: number
+): Record<string, unknown>[] {
+  try {
+    return db.all(
+      `${select} WHERE ${table} MATCH ? ${order}`,
+      [matchExpr, limit]
+    );
+  } catch {
+    return [];
+  }
+}
+
+function sanitizeFtsInput(query: string): string {
+  return query
+    .replace(/["""'',,,,]/g, '"')
+    .replace(/[^a-zA-Z0-9\s*"_\u00C0-\u024F-]/g, ' ')
+    .replace(/\s+/g, ' ')
+    .trim();
+}
+
+function stemWord(word: string): string {
+  return word
+    .replace(/(ung|heit|keit|lich|isch|ieren|tion|ment|ness|able|ible|ous|ive|ing|ers|ed|es|er|en|ly|s)$/i, '');
+}

package/src/http-server.ts

@@ -0,0 +1,302 @@
+import { createServer, type IncomingMessage, type ServerResponse } from 'http';
+import { randomUUID } from 'crypto';
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
+import {
+  ListToolsRequestSchema,
+  CallToolRequestSchema,
+} from '@modelcontextprotocol/sdk/types.js';
+import { z } from 'zod';
+import { createDatabase, type Database } from './db.js';
+import { handleAbout } from './tools/about.js';
+import { handleListSources } from './tools/list-sources.js';
+import { handleCheckFreshness } from './tools/check-freshness.js';
+import { handleSearchOrganicRules } from './tools/search-organic-rules.js';
+import { handleGetConversionRequirements } from './tools/get-conversion-requirements.js';
+import { handleGetOrganicStandards } from './tools/get-organic-standards.js';
+import { handleGetApprovedInputs } from './tools/get-approved-inputs.js';
+import { handleGetOrganicSubsidies } from './tools/get-organic-subsidies.js';
+import { handleGetSoilHealthGuidance } from './tools/get-soil-health-guidance.js';
+import { handleSearchCertificationGuidance } from './tools/search-certification-guidance.js';
+
+const SERVER_NAME = 'ch-organic-regen-mcp';
+const SERVER_VERSION = '0.1.0';
+const PORT = parseInt(process.env.PORT ?? '3000', 10);
+
+const SearchOrganicRulesSchema = z.object({
+  query: z.string(),
+  topic: z.string().optional(),
+  jurisdiction: z.string().optional(),
+  limit: z.number().optional(),
+});
+
+const ConversionArgsSchema = z.object({
+  farm_type: z.string().optional(),
+  current_system: z.string().optional(),
+  jurisdiction: z.string().optional(),
+});
+
+const StandardsArgsSchema = z.object({
+  production_type: z.string().optional(),
+  standard: z.string().optional(),
+  jurisdiction: z.string().optional(),
+});
+
+const InputsArgsSchema = z.object({
+  input_type: z.string().optional(),
+  jurisdiction: z.string().optional(),
+});
+
+const SubsidiesArgsSchema = z.object({
+  subsidy_type: z.string().optional(),
+  zone: z.string().optional(),
+  jurisdiction: z.string().optional(),
+});
+
+const SoilHealthArgsSchema = z.object({
+  topic: z.string().optional(),
+  jurisdiction: z.string().optional(),
+});
+
+const CertArgsSchema = z.object({
+  query: z.string(),
+  jurisdiction: z.string().optional(),
+});
+
+const TOOLS = [
+  {
+    name: 'about',
+    description: 'Get server metadata: name, version, coverage, data sources, and links.',
+    inputSchema: { type: 'object' as const, properties: {} },
+  },
+  {
+    name: 'list_sources',
+    description: 'List all data sources with authority, URL, license, and freshness info.',
+    inputSchema: { type: 'object' as const, properties: {} },
+  },
+  {
+    name: 'check_data_freshness',
+    description: 'Check when data was last ingested, staleness status, and how to trigger a refresh.',
+    inputSchema: { type: 'object' as const, properties: {} },
+  },
+  {
+    name: 'search_organic_rules',
+    description:
+      'Volltextsuche ueber Bio-Richtlinien, Umstellung, Bodenfruchtbarkeit und regenerative Landwirtschaft. ' +
+      'Search organic farming rules, conversion guidance, soil health, and regenerative agriculture topics.',
+    inputSchema: {
+      type: 'object' as const,
+      properties: {
+        query: { type: 'string', description: 'Suchbegriff / free-text search query (German or English)' },
+        topic: { type: 'string', description: 'Filter by topic (e.g. knospe, demeter, umstellung, bodenfruchtbarkeit)' },
+        jurisdiction: { type: 'string', description: 'ISO 3166-1 alpha-2 code (default: CH)' },
+        limit: { type: 'number', description: 'Max results (default: 20, max: 50)' },
+      },
+      required: ['query'],
+    },
+  },
+  {
+    name: 'get_conversion_requirements',
+    description:
+      'Umstellungsanforderungen fuer den Biobetrieb: Zeitrahmen, Voraussetzungen, Unterstuetzungsmassnahmen. ' +
+      'Get organic conversion timeline, requirements, and support measures by farm type.',
+    inputSchema: {
+      type: 'object' as const,
+      properties: {
+        farm_type: { type: 'string', description: 'Betriebstyp (e.g. ackerbau, milchwirtschaft, obstbau, rebbau, gemuese)' },
+        current_system: { type: 'string', description: 'Aktuelles System (e.g. oeln, konventionell, ip)' },
+        jurisdiction: { type: 'string', description: 'ISO 3166-1 alpha-2 code (default: CH)' },
+      },
+    },
+  },
+  {
+    name: 'get_organic_standards',
+    description:
+      'Bio-Richtlinien nach Standard (Knospe, Bio-Verordnung, Demeter) und Produktionsbereich. ' +
+      'Get organic production rules comparing Bio Suisse Knospe, federal Bio-Verordnung, and Demeter standards.',
+    inputSchema: {
+      type: 'object' as const,
+      properties: {
+        production_type: { type: 'string', description: 'Produktionsbereich (e.g. tierhaltung, pflanzenbau, verarbeitung, futtermittel)' },
+        standard: { type: 'string', description: 'Standard: bio_verordnung, knospe, demeter' },
+        jurisdiction: { type: 'string', description: 'ISO 3166-1 alpha-2 code (default: CH)' },
+      },
+    },
+  },
+  {
+    name: 'get_approved_inputs',
+    description:
+      'Zugelassene Betriebsmittel fuer Biolandbau (FiBL-Liste): Duenger, Pflanzenschutz, Futtermittel. ' +
+      'Get approved inputs for organic farming from the FiBL Betriebsmittelliste.',
+    inputSchema: {
+      type: 'object' as const,
+      properties: {
+        input_type: { type: 'string', description: 'Betriebsmitteltyp: duenger, pflanzenschutz, futtermittel' },
+        jurisdiction: { type: 'string', description: 'ISO 3166-1 alpha-2 code (default: CH)' },
+      },
+    },
+  },
+  {
+    name: 'get_organic_subsidies',
+    description:
+      'Bio-Beitrag und weitere Direktzahlungen fuer Biobetriebe: Beitragshoehe, Bedingungen, Kumulierung. ' +
+      'Get organic farming subsidies (Bio-Beitrag) rates, conditions, and stacking rules.',
+    inputSchema: {
+      type: 'object' as const,
+      properties: {
+        subsidy_type: { type: 'string', description: 'Beitragstyp (e.g. bio_beitrag, extenso, bff, tierwohl)' },
+        zone: { type: 'string', description: 'Zone: talzone, huegelzone, bergzone_i, bergzone_ii, bergzone_iii, bergzone_iv' },
+        jurisdiction: { type: 'string', description: 'ISO 3166-1 alpha-2 code (default: CH)' },
+      },
+    },
+  },
+  {
+    name: 'get_soil_health_guidance',
+    description:
+      'Bodenfruchtbarkeit und regenerative Methoden: Kompost, Gruenduengung, Fruchtfolge, Conservation Agriculture. ' +
+      'Get soil health and regenerative agriculture guidance: composting, cover crops, rotation, agroforestry.',
+    inputSchema: {
+      type: 'object' as const,
+      properties: {
+        topic: { type: 'string', description: 'Thema (e.g. kompost, gruenduengung, fruchtfolge, agroforstwirtschaft, untersaat, direktsaat)' },
+        jurisdiction: { type: 'string', description: 'ISO 3166-1 alpha-2 code (default: CH)' },
+      },
+    },
+  },
+  {
+    name: 'search_certification_guidance',
+    description:
+      'Zertifizierungsprozess Bio Suisse Knospe: Schritte, Inspektionsstellen, Kosten, Haeufigkeit. ' +
+      'Search organic certification guidance: bio.inspecta, Bio Test Agro process, Knospe application steps.',
+    inputSchema: {
+      type: 'object' as const,
+      properties: {
+        query: { type: 'string', description: 'Suchbegriff (e.g. anmeldung, kontrolle, kosten, inspektion)' },
+        jurisdiction: { type: 'string', description: 'ISO 3166-1 alpha-2 code (default: CH)' },
+      },
+      required: ['query'],
+    },
+  },
+];
+
+function textResult(data: unknown) {
+  return { content: [{ type: 'text' as const, text: JSON.stringify(data, null, 2) }] };
+}
+
+function errorResult(message: string) {
+  return { content: [{ type: 'text' as const, text: JSON.stringify({ error: message }) }], isError: true };
+}
+
+function registerTools(server: Server, db: Database): void {
+  server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: TOOLS }));
+
+  server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args = {} } = request.params;
+
+    try {
+      switch (name) {
+        case 'about':
+          return textResult(handleAbout());
+        case 'list_sources':
+          return textResult(handleListSources(db));
+        case 'check_data_freshness':
+          return textResult(handleCheckFreshness(db));
+        case 'search_organic_rules':
+          return textResult(handleSearchOrganicRules(db, SearchOrganicRulesSchema.parse(args)));
+        case 'get_conversion_requirements':
+          return textResult(handleGetConversionRequirements(db, ConversionArgsSchema.parse(args)));
+        case 'get_organic_standards':
+          return textResult(handleGetOrganicStandards(db, StandardsArgsSchema.parse(args)));
+        case 'get_approved_inputs':
+          return textResult(handleGetApprovedInputs(db, InputsArgsSchema.parse(args)));
+        case 'get_organic_subsidies':
+          return textResult(handleGetOrganicSubsidies(db, SubsidiesArgsSchema.parse(args)));
+        case 'get_soil_health_guidance':
+          return textResult(handleGetSoilHealthGuidance(db, SoilHealthArgsSchema.parse(args)));
+        case 'search_certification_guidance':
+          return textResult(handleSearchCertificationGuidance(db, CertArgsSchema.parse(args)));
+        default:
+          return errorResult(`Unknown tool: ${name}`);
+      }
+    } catch (err) {
+      return errorResult(err instanceof Error ? err.message : String(err));
+    }
+  });
+}
+
+const db = createDatabase();
+const sessions = new Map<string, { transport: StreamableHTTPServerTransport; server: Server }>();
+
+function createMcpServer(): Server {
+  const mcpServer = new Server(
+    { name: SERVER_NAME, version: SERVER_VERSION },
+    { capabilities: { tools: {} } }
+  );
+  registerTools(mcpServer, db);
+  return mcpServer;
+}
+
+async function handleMCPRequest(req: IncomingMessage, res: ServerResponse): Promise<void> {
+  const sessionId = req.headers['mcp-session-id'] as string | undefined;
+
+  if (sessionId && sessions.has(sessionId)) {
+    const session = sessions.get(sessionId)!;
+    await session.transport.handleRequest(req, res);
+    return;
+  }
+
+  if (req.method === 'GET' || req.method === 'DELETE') {
+    res.writeHead(400, { 'Content-Type': 'application/json' });
+    res.end(JSON.stringify({ error: 'Invalid or missing session ID' }));
+    return;
+  }
+
+  const mcpServer = createMcpServer();
+  const transport = new StreamableHTTPServerTransport({
+    sessionIdGenerator: () => randomUUID(),
+  });
+
+  await mcpServer.connect(transport);
+
+  transport.onclose = () => {
+    if (transport.sessionId) {
+      sessions.delete(transport.sessionId);
+    }
+    mcpServer.close().catch(() => {});
+  };
+
+  await transport.handleRequest(req, res);
+
+  if (transport.sessionId) {
+    sessions.set(transport.sessionId, { transport, server: mcpServer });
+  }
+}
+
+const httpServer = createServer(async (req, res) => {
+  const url = new URL(req.url || '/', `http://localhost:${PORT}`);
+
+  if (url.pathname === '/health' && req.method === 'GET') {
+    res.writeHead(200, { 'Content-Type': 'application/json' });
+    res.end(JSON.stringify({ status: 'healthy', server: SERVER_NAME, version: SERVER_VERSION }));
+    return;
+  }
+
+  if (url.pathname === '/mcp' || url.pathname === '/') {
+    try {
+      await handleMCPRequest(req, res);
+    } catch (err) {
+      if (!res.headersSent) {
+        res.writeHead(500, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify({ error: err instanceof Error ? err.message : 'Internal server error' }));
+      }
+    }
+    return;
+  }
+
+  res.writeHead(404, { 'Content-Type': 'application/json' });
+  res.end(JSON.stringify({ error: 'Not found' }));
+});
+
+httpServer.listen(PORT, () => {
+  console.log(`${SERVER_NAME} v${SERVER_VERSION} listening on port ${PORT}`);
+});

package/src/jurisdiction.ts

@@ -0,0 +1,30 @@
+export const SUPPORTED_JURISDICTIONS = ['CH'] as const;
+export type Jurisdiction = (typeof SUPPORTED_JURISDICTIONS)[number];
+
+type ValidationSuccess = { valid: true; jurisdiction: Jurisdiction };
+type ValidationFailure = {
+  valid: false;
+  error: {
+    error: string;
+    supported: readonly string[];
+    message: string;
+  };
+};
+type ValidationResult = ValidationSuccess | ValidationFailure;
+
+export function validateJurisdiction(input: string | undefined): ValidationResult {
+  const normalised = (input ?? 'CH').toUpperCase();
+
+  if (SUPPORTED_JURISDICTIONS.includes(normalised as Jurisdiction)) {
+    return { valid: true, jurisdiction: normalised as Jurisdiction };
+  }
+
+  return {
+    valid: false,
+    error: {
+      error: 'jurisdiction_not_supported',
+      supported: SUPPORTED_JURISDICTIONS,
+      message: 'This server currently covers Switzerland. More jurisdictions are planned.',
+    },
+  };
+}

package/src/metadata.ts

@@ -0,0 +1,45 @@
+export interface Meta {
+  disclaimer: string;
+  data_age: string;
+  source_url: string;
+  copyright: string;
+  server: string;
+  version: string;
+}
+
+const DISCLAIMER =
+  'Diese Daten dienen ausschliesslich der Information und stellen keine professionelle landwirtschaftliche ' +
+  'Beratung dar. Vor der Umstellung auf biologische Landwirtschaft oder der Anwendung regenerativer Methoden ' +
+  'ist stets eine qualifizierte Fachberatung (FiBL, Bio Suisse, kantonale Fachstelle, AGRIDEA oder ' +
+  'akkreditierter Bio-Berater) hinzuzuziehen. Die Daten basieren auf den Bio Suisse Richtlinien (Knospe), ' +
+  'der Bio-Verordnung (SR 910.18), der FiBL-Betriebsmittelliste und den Demeter-Richtlinien. Kantonale ' +
+  'Abweichungen und betriebsspezifische Anpassungen sind eigenstaendig zu pruefen. / ' +
+  'This data is provided for informational purposes only and does not constitute professional agricultural ' +
+  'advice. Always consult a qualified organic farming advisor (FiBL, Bio Suisse, cantonal authority) before ' +
+  'making conversion or management decisions. Data sourced from Bio Suisse (Knospe), Swiss Bio-Verordnung, ' +
+  'FiBL Betriebsmittelliste, and Demeter standards.';
+
+export function buildMeta(overrides?: Partial<Meta>): Meta {
+  return {
+    disclaimer: DISCLAIMER,
+    data_age: overrides?.data_age ?? 'unknown',
+    source_url: overrides?.source_url ?? 'https://www.bio-suisse.ch/de/richtlinien',
+    copyright: 'Data: Bio Suisse, FiBL, BLW, Demeter Schweiz — used under public-sector information principles. Server: Apache-2.0 Ansvar Systems.',
+    server: 'ch-organic-regen-mcp',
+    version: '0.1.0',
+    ...overrides,
+  };
+}
+
+export function buildStalenessWarning(publishedDate: string): string | undefined {
+  const published = new Date(publishedDate);
+  const now = new Date();
+  const daysSincePublished = Math.floor(
+    (now.getTime() - published.getTime()) / (1000 * 60 * 60 * 24)
+  );
+
+  if (daysSincePublished > 14) {
+    return `Daten sind ${daysSincePublished} Tage alt (Stand ${publishedDate}). Aktuelle Angaben bei Bio Suisse / FiBL pruefen.`;
+  }
+  return undefined;
+}