@ansvar/ch-farm-grants-mcp 0.1.0

package/.github/workflows/check-freshness.yml

@@ -0,0 +1,18 @@
+name: Check Data Freshness
+
+on:
+  schedule:
+    - cron: "0 8 * * *"  # Daily at 08:00 UTC
+  workflow_dispatch:
+
+jobs:
+  freshness:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+          cache: npm
+      - run: npm ci
+      - run: npm run freshness:check

package/.github/workflows/ci.yml

@@ -0,0 +1,21 @@
+name: CI
+
+on:
+  push:
+    branches: [main, dev]
+  pull_request:
+    branches: [main]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+          cache: npm
+      - run: npm ci
+      - run: npm run typecheck
+      - run: npm run lint
+      - run: npm test

package/.github/workflows/codeql.yml

@@ -0,0 +1,25 @@
+name: CodeQL
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+  schedule:
+    - cron: "0 6 * * 1"
+
+permissions:
+  actions: read
+  contents: read
+  security-events: write
+
+jobs:
+  analyze:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: github/codeql-action/init@v3
+        with:
+          languages: javascript-typescript
+      - uses: github/codeql-action/autobuild@v3
+      - uses: github/codeql-action/analyze@v3

package/.github/workflows/ghcr-build.yml

@@ -0,0 +1,45 @@
+name: Build and Push to GHCR
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+concurrency:
+  group: build-${{ github.ref }}
+  cancel-in-progress: true
+
+env:
+  REGISTRY: ghcr.io
+  IMAGE_NAME: ch-farm-grants-mcp
+
+permissions:
+  contents: read
+  packages: write
+
+jobs:
+  build-and-push:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: docker/setup-buildx-action@v3
+      - uses: docker/login-action@v3
+        with:
+          registry: ghcr.io
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+      - uses: docker/metadata-action@v5
+        id: meta
+        with:
+          images: ${{ env.REGISTRY }}/ansvar-systems/${{ env.IMAGE_NAME }}
+          tags: |
+            type=raw,value=latest,enable=${{ github.ref == format('refs/heads/{0}', 'main') }}
+            type=sha,prefix=sha-,format=short
+      - uses: docker/build-push-action@v5
+        with:
+          context: .
+          push: true
+          tags: ${{ steps.meta.outputs.tags }}
+          platforms: linux/amd64
+          cache-from: type=gha
+          cache-to: type=gha,mode=max

package/.github/workflows/gitleaks.yml

@@ -0,0 +1,18 @@
+name: Gitleaks
+
+on:
+  push:
+    branches: [main, dev]
+  pull_request:
+    branches: [main]
+
+jobs:
+  scan:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - uses: gitleaks/gitleaks-action@v2
+        env:
+          GITLEAKS_LICENSE: ${{ secrets.GITLEAKS_LICENSE }}

package/.github/workflows/ingest.yml

@@ -0,0 +1,28 @@
+name: Re-ingest Data
+
+on:
+  schedule:
+    - cron: "0 4 1 * *"  # Monthly, 1st at 04:00 UTC
+  workflow_dispatch:
+
+permissions:
+  contents: write
+
+jobs:
+  ingest:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+          cache: npm
+      - run: npm ci
+      - run: npm run ingest
+      - name: Commit updated database
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git add data/database.db data/coverage.json data/sources.yml
+          git diff --staged --quiet || git commit -m "chore: re-ingest data $(date +%Y-%m-%d)"
+          git push

package/.github/workflows/publish.yml

@@ -0,0 +1,24 @@
+name: Publish to npm
+
+on:
+  release:
+    types: [published]
+
+permissions:
+  contents: read
+  id-token: write
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+          registry-url: "https://registry.npmjs.org"
+      - run: npm ci
+      - run: npm run build
+      - run: npm publish --provenance --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

package/CHANGELOG.md

@@ -0,0 +1,22 @@
+# Changelog
+
+All notable changes to the Switzerland Farm Grants MCP will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+---
+
+## [0.1.0] - 2026-04-05 - Initial Release
+
+### Added
+- 10 tools: `about`, `list_sources`, `check_data_freshness`, `search_grants`, `get_grant_details`, `get_payment_rates`, `check_eligibility`, `list_grant_options`, `get_application_deadlines`, `search_application_guidance`
+- 25 grant programmes covering Investitionskredite, Beitraege, Meliorationen, PRE, Ressourcenprogramme, Gewaesserschutz, Starthilfe
+- 29 eligibility rules by farm type, investment type, and altitude zone
+- 23 grant sub-options (Massnahmen)
+- 20 application deadlines (federal and cantonal)
+- FTS5 full-text search with 6-tier fallback (phrase, AND, prefix, stemmed, OR, LIKE)
+- Dual transport: stdio (npx) and Streamable HTTP (Docker)
+- Golden standard documentation: README, TOOLS.md, COVERAGE.md, DISCLAIMER.md, SECURITY.md, PRIVACY.md
+- CI/CD: CodeQL, Gitleaks, ingest workflow, freshness check, GHCR build, npm publish
+- Test suite: db, jurisdiction, and tool-level tests with seeded test database

package/CODEOWNERS

@@ -0,0 +1 @@
+* @ansvar-systems/engineering

package/COVERAGE.md

@@ -0,0 +1,45 @@
+# Coverage -- Switzerland Farm Grants MCP
+
+## Data Summary
+
+| Table | Records | Description |
+|-------|---------|-------------|
+| `grants` | 25 | Grant programmes (Investitionskredite, Beitraege, Meliorationen, PRE, Ressourcenprogramme, Gewaesserschutz, Starthilfe) |
+| `grant_options` | 23 | Sub-options / Massnahmen within grant programmes |
+| `eligibility_rules` | 29 | Eligibility criteria by farm type, investment type, and altitude zone |
+| `application_deadlines` | 20 | Federal and cantonal application deadlines |
+
+**Jurisdiction:** Switzerland (CH)
+**Language:** German (primary), English (search supported)
+**Currency:** CHF
+**Last ingestion:** 2026-04-05
+
+## Grant Types Covered
+
+| Grant Type | Description |
+|------------|-------------|
+| `investitionskredit` | Interest-free federal loans for agricultural buildings and infrastructure (SVV Art. 44 ff.) |
+| `beitrag` | Capital grants (non-repayable) for structural improvements (SVV Art. 18 ff.) |
+| `meliorationsbeitrag` | Land improvement grants: drainage, irrigation, access roads (SVV Art. 14 ff.) |
+| `pre` | Projekte zur regionalen Entwicklung -- regional development projects (SVV Art. 93 ff.) |
+| `ressourcenprogramm` | Resource efficiency programmes under LwG Art. 77a/77b |
+| `gewaesserschutz` | Water protection projects under GSchG Art. 62a |
+| `starthilfe` | Start-up assistance for young farmers (SVV Art. 86 ff.) |
+
+## Data Sources
+
+| Source | Authority | Update Frequency |
+|--------|-----------|-----------------|
+| Strukturverbesserungsverordnung (SVV, SR 913.1) | BLW | Annual (with ordinance updates) |
+| BLW Weisungen Investitionskredite und Beitraege | BLW | Annual |
+| Kantonale Landwirtschaftsaemter | 26 cantonal offices | Variable per canton |
+| AGRIDEA Beratungsunterlagen | AGRIDEA | Periodic |
+
+## Limitations
+
+- **Cantonal programmes:** Only major cantons covered. Some smaller cantons have additional programmes not yet ingested.
+- **Historical rates:** Only current rates. Historical contribution rates are not tracked.
+- **Cantonal deadlines:** Not all cantons have published fixed deadlines. Some cantons accept applications year-round.
+- **French/Italian:** Data is primarily in German. French- and Italian-speaking canton specifics may be incomplete.
+- **PRE projects:** Regional development project data covers federal-level rules. Specific approved PRE regions are not individually listed.
+- **Private co-funding:** Schweizer Berghilfe and other private funding sources are referenced in guidance but not tracked as separate grant programmes.

package/DISCLAIMER.md

@@ -0,0 +1,39 @@
+# Haftungsausschluss / Disclaimer
+
+## Keine Rechtsberatung / Not Legal or Financial Advice
+
+**DE:** Dieser MCP-Server liefert Informationen zu Schweizer Strukturverbesserungsmassnahmen in der Landwirtschaft. Die Daten basieren auf der Strukturverbesserungsverordnung (SVV, SR 913.1), den Weisungen des Bundesamts fuer Landwirtschaft (BLW) zu Investitionskrediten und Beitraegen sowie kantonalen Ausfuehrungsbestimmungen. **Nichts in diesem Server stellt eine Rechts-, Finanz- oder Foerderberatung dar.** Foerderentscheide liegen ausschliesslich bei den zustaendigen kantonalen Landwirtschaftsaemtern und dem BLW.
+
+**EN:** This MCP server provides information about Swiss agricultural structural improvement grants. Data is sourced from the Structural Improvements Ordinance (SVV, SR 913.1), Federal Office for Agriculture (BLW) investment credit guidelines, and cantonal implementation rules. **Nothing in this server constitutes legal, financial, or grant application advice.** Funding decisions are made exclusively by the competent cantonal agricultural offices and the BLW.
+
+## Keine Garantie fuer Foerderberechtigung / No Guarantee of Eligibility
+
+**DE:** Die Ergebnisse der Berechtigungspruefung (`check_eligibility`) und der Beitragssaetze (`get_payment_rates`) sind informativ. Tatsaechliche Beitragssaetze, Kreditlimiten und Berechtigungskriterien koennen je nach Kanton, Projektbewertung und Verfuegbarkeit der Bundesmittel abweichen. Vor der Einreichung eines Gesuchs ist stets die kantonale Fachstelle oder AGRIDEA zu konsultieren.
+
+**EN:** Eligibility checks and payment rate information are indicative only. Actual contribution rates, credit limits, and eligibility criteria may differ by canton, project evaluation, and availability of federal funds. Always consult the cantonal agricultural office or AGRIDEA before submitting an application.
+
+## Keine Gewaehrleistung / No Warranty
+
+THE SOFTWARE AND DATA ARE PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NONINFRINGEMENT.
+
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES, OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT, OR OTHERWISE, ARISING FROM, OUT OF, OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+## Haftungsbeschraenkung / Limitation of Liability
+
+**DE:** Die Autoren, Mitwirkenden und Ansvar Systems uebernehmen keine Haftung fuer:
+
+- Fehler, Auslassungen oder Ungenauigkeiten in den Foerderdaten
+- Entscheidungen, die auf Informationen aus diesem Server beruhen
+- Finanzielle, rechtliche oder sonstige Verluste durch Nutzung dieser Software
+- Aenderungen der Gesetzgebung oder Verordnungen, die noch nicht abgebildet sind
+
+**EN:** The authors, contributors, and Ansvar Systems accept no liability for:
+
+- Errors, omissions, or inaccuracies in the grant data
+- Decisions made based on information from this server
+- Financial, legal, or other losses arising from use of this software
+- Changes in legislation or ordinances not yet reflected in the database
+
+## Open Source
+
+Apache License 2.0. See [LICENSE](LICENSE).

package/Dockerfile

@@ -0,0 +1,26 @@
+FROM node:20-slim AS builder
+RUN apt-get update && apt-get install -y python3 make g++ && rm -rf /var/lib/apt/lists/*
+WORKDIR /app
+COPY package*.json ./
+RUN npm ci
+COPY tsconfig.json ./
+COPY src/ src/
+RUN npm run build
+
+FROM node:20-slim
+RUN apt-get update && apt-get install -y python3 make g++ && rm -rf /var/lib/apt/lists/*
+RUN addgroup --system --gid 1001 nodejs && \
+    adduser --system --uid 1001 nodejs
+WORKDIR /app
+COPY package*.json ./
+RUN npm ci --omit=dev && npm cache clean --force && apt-get purge -y python3 make g++ && apt-get autoremove -y
+COPY --from=builder /app/dist dist/
+COPY data/ data/
+RUN chown -R nodejs:nodejs /app/data
+USER nodejs
+ENV NODE_ENV=production
+ENV PORT=3000
+EXPOSE 3000
+HEALTHCHECK --interval=30s --timeout=5s --start-period=10s --retries=3 \
+  CMD node -e "require('http').get('http://localhost:' + process.env.PORT + '/health', (r) => { process.exit(r.statusCode === 200 ? 0 : 1) })"
+CMD ["node", "dist/http-server.js"]

package/LICENSE

@@ -0,0 +1,17 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
+
+   Copyright 2026 Ansvar Systems

package/PRIVACY.md

@@ -0,0 +1,36 @@
+# Privacy Policy
+
+## Data Collection
+
+**This MCP server collects no data.**
+
+- No user data is stored
+- No telemetry is sent
+- No tracking or analytics
+- No cookies or session data
+- No network calls at runtime
+
+## Architecture
+
+This MCP server is a **read-only knowledge base**. It serves pre-built data from a local SQLite database. No user queries, inputs, or interactions are logged or persisted by the MCP server itself.
+
+## Data Sources
+
+All data in this knowledge base is sourced from **publicly available** Swiss federal and cantonal agricultural publications: Strukturverbesserungsverordnung (SVV, SR 913.1), BLW investment credit guidelines, cantonal agricultural office publications, and AGRIDEA advisory materials.
+
+## Host Environment
+
+When this MCP server runs inside a host application (Claude Desktop, Cursor, VS Code, etc.), the **host application's** privacy policy governs how your interactions are processed. This MCP server itself has no visibility into or control over the host's data practices.
+
+## npm Package
+
+The published npm package contains only:
+- Static SQLite database (grant data)
+- Server code (TypeScript/JavaScript)
+- Configuration files
+
+No user data is included in or collected by the package.
+
+## Contact
+
+For privacy questions about this MCP server: [Ansvar Systems](https://ansvar.eu)

package/README.md

@@ -0,0 +1,80 @@
+# Switzerland Farm Grants MCP
+
+[![CI](https://github.com/ansvar-systems/ch-farm-grants-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/ansvar-systems/ch-farm-grants-mcp/actions/workflows/ci.yml)
+[![GHCR](https://github.com/ansvar-systems/ch-farm-grants-mcp/actions/workflows/ghcr-build.yml/badge.svg)](https://github.com/ansvar-systems/ch-farm-grants-mcp/actions/workflows/ghcr-build.yml)
+[![License: Apache-2.0](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
+
+Swiss agricultural structural improvement grants via the [Model Context Protocol](https://modelcontextprotocol.io). Query Investitionskredite (interest-free loans), Beitraege (capital grants), Meliorationen, PRE, Ressourcenprogramme, Gewaesserschutzprojekte, and Starthilfe Junglandwirte -- all from your AI assistant.
+
+Part of [Ansvar Open Agriculture](https://ansvar.eu/open-agriculture).
+
+## Why This Exists
+
+Swiss farmers, advisors, and cantonal agricultural offices need fast access to structural improvement grant rules when planning investments. The data is spread across federal ordinances (SVV, SR 913.1), BLW guidelines, cantonal implementation rules, and AGRIDEA advisory materials. This MCP server puts it all behind a single tool interface so AI assistants can answer grant eligibility, payment rates, and application process questions with cited Swiss data instead of guessing from training data.
+
+## Quick Start
+
+### Claude Desktop
+
+Add to your `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "ch-farm-grants": {
+      "command": "npx",
+      "args": ["-y", "@ansvar/ch-farm-grants-mcp"]
+    }
+  }
+}
+```
+
+### Claude Code
+
+```bash
+claude mcp add ch-farm-grants -- npx -y @ansvar/ch-farm-grants-mcp
+```
+
+### Streamable HTTP (remote)
+
+```
+https://mcp.ansvar.eu/ch-farm-grants/mcp
+```
+
+No authentication required.
+
+### Docker (self-hosted)
+
+```bash
+docker run -p 3000:3000 ghcr.io/ansvar-systems/ch-farm-grants-mcp:latest
+```
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `about` | Server metadata: name, version, coverage, data sources, and links. |
+| `list_sources` | All data sources with authority, URL, license, and freshness info. |
+| `check_data_freshness` | When data was last ingested, staleness status, how to trigger a refresh. |
+| `search_grants` | Search grants by free text (German or English), filter by grant type. |
+| `get_grant_details` | Full details for a grant programme: objectives, rates, conditions, eligibility, sub-options. |
+| `get_payment_rates` | Federal and cantonal contribution rates, zone-specific bonuses (Berggebiet, Huegelzone). |
+| `check_eligibility` | Check which grants a farm is eligible for by farm type, investment, and altitude zone. |
+| `list_grant_options` | List sub-options (Massnahmen) within a grant programme, or list all grants with option counts. |
+| `get_application_deadlines` | Application deadlines for grants, optionally filtered by canton. |
+| `search_application_guidance` | How to apply: required documents, cantonal contacts, AGRIDEA advisory support. |
+
+See [TOOLS.md](TOOLS.md) for full parameter documentation.
+
+## Data Sources
+
+- **Strukturverbesserungsverordnung (SVV, SR 913.1)** -- federal structural improvement rules
+- **BLW Weisungen Investitionskredite und Beitraege** -- federal investment credit guidelines
+- **Kantonale Landwirtschaftsaemter** -- cantonal contribution rates, deadlines, additional programmes
+- **AGRIDEA Beratungsunterlagen** -- project planning guidance, application procedures
+
+See [COVERAGE.md](COVERAGE.md) for data counts and limitations.
+
+## License
+
+Apache-2.0. See [LICENSE](LICENSE).

package/SECURITY.md

@@ -0,0 +1,31 @@
+# Security Policy
+
+## Supported Versions
+
+| Version | Supported          |
+| ------- | ------------------ |
+| 0.x     | :white_check_mark: |
+
+## Reporting a Vulnerability
+
+If you discover a security vulnerability in this MCP server, please report it responsibly:
+
+1. **Do NOT open a public issue**
+2. Email: security@ansvar.eu
+3. Include: description, reproduction steps, potential impact
+
+We aim to acknowledge reports within 48 hours and provide a fix within 7 days for critical issues.
+
+## Security Architecture
+
+- **Read-only**: No write operations to the database at runtime
+- **No network calls**: All data served from local SQLite
+- **No authentication**: Public reference data only
+- **No secrets**: No API keys or credentials required
+- **Input validation**: All inputs validated with Zod schemas before processing
+- **SQL injection prevention**: Parameterized queries throughout, FTS5 input sanitized
+- **FTS5 hardening**: User input is stripped of special characters before FTS5 queries
+
+## Dependencies
+
+Dependencies are monitored via GitHub Dependabot and updated regularly. Security scanning is enabled via GitHub Advanced Security (CodeQL + secret scanning).

package/TOOLS.md

@@ -0,0 +1,154 @@
+# Tools -- Switzerland Farm Grants MCP
+
+All tools return JSON with a `_meta` object containing disclaimer, data age, and source URL.
+
+---
+
+## `about`
+
+Server metadata: name, version, coverage, data sources, and links.
+
+**Parameters:** None.
+
+**Returns:** `name`, `description`, `version`, `jurisdiction`, `data_sources`, `tools_count`, `links`, `_meta`.
+
+---
+
+## `list_sources`
+
+All data sources with authority, official URL, retrieval method, update frequency, license, and coverage scope.
+
+**Parameters:** None.
+
+**Returns:** `sources[]` array with one entry per data source; `_meta`.
+
+---
+
+## `check_data_freshness`
+
+When data was last ingested, staleness status, and how to trigger a refresh.
+
+**Parameters:** None.
+
+**Returns:**
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `status` | `fresh \| stale \| unknown` | Whether data is within the 90-day threshold |
+| `last_ingest` | `string \| null` | ISO date of last ingestion |
+| `days_since_ingest` | `number \| null` | Days elapsed since last ingestion |
+| `staleness_threshold_days` | `number` | Threshold used (90) |
+| `refresh_command` | `string` | CLI command to trigger re-ingestion |
+
+---
+
+## `search_grants`
+
+Search grants via FTS5 full-text index. Supports German and English queries with tiered fallback (exact phrase, AND, prefix, stemmed, OR, LIKE).
+
+**Parameters:**
+
+| Param | Type | Required | Description |
+|-------|------|----------|-------------|
+| `query` | `string` | Yes | Free-text search query |
+| `grant_type` | `string` | No | Filter: `investitionskredit`, `beitrag`, `meliorationsbeitrag`, `pre`, `ressourcenprogramm`, `gewaesserschutz`, `starthilfe` |
+| `jurisdiction` | `string` | No | ISO 3166-1 alpha-2 (default: `CH`) |
+| `limit` | `number` | No | Max results (default: 20, max: 50) |
+
+**Returns:** `query`, `jurisdiction`, `results_count`, `results[]` with `title`, `body`, `grant_type`, `relevance_rank`; `_meta`.
+
+---
+
+## `get_grant_details`
+
+Full details for a specific grant programme.
+
+**Parameters:**
+
+| Param | Type | Required | Description |
+|-------|------|----------|-------------|
+| `grant_id` | `string` | Yes | Grant ID or name (e.g. `ik-oekonomiegebaeude`) |
+| `jurisdiction` | `string` | No | ISO 3166-1 alpha-2 (default: `CH`) |
+
+**Returns:** All grant fields (`id`, `name`, `grant_type`, `description`, `federal_rate_pct`, `max_amount`, `duration_years`, `zone_bonus`, `legal_basis`, `language`, `jurisdiction`), plus `options[]` and `eligibility_rules[]`; `_meta`.
+
+---
+
+## `get_payment_rates`
+
+Federal and cantonal contribution rates for a grant programme, with zone-specific bonuses.
+
+**Parameters:**
+
+| Param | Type | Required | Description |
+|-------|------|----------|-------------|
+| `grant_id` | `string` | Yes | Grant ID or name |
+| `zone` | `string` | No | Altitude zone: `talzone`, `huegelzone`, `bergzone_i`, `bergzone_ii`, `bergzone_iii`, `bergzone_iv`, `soemmerungsgebiet` |
+| `jurisdiction` | `string` | No | ISO 3166-1 alpha-2 (default: `CH`) |
+
+**Returns:** `grant_id`, `grant_name`, `grant_type`, `federal_rate_pct`, `max_amount_chf`, `duration_years`, `zone_requested`, `zone_bonus`, `all_zone_bonuses`, `rate_options[]`, `currency` (`CHF`); `_meta`.
+
+---
+
+## `check_eligibility`
+
+Check which grants a farm is eligible for based on farm characteristics.
+
+**Parameters:**
+
+| Param | Type | Required | Description |
+|-------|------|----------|-------------|
+| `farm_type` | `string` | Yes | `milchwirtschaft`, `ackerbau`, `mutterkuhhaltung`, `bergbetrieb`, `alpwirtschaft`, `gemischt`, `gemeinschaft`, `junglandwirt` |
+| `investment_type` | `string` | No | `stallbau`, `hofduengerlager`, `wohnhaus`, `diversifikation`, `alpgebaeude`, `wegebau`, `wasserversorgung`, `biogasanlage`, `kaeserei` |
+| `zone` | `string` | No | Altitude zone |
+| `jurisdiction` | `string` | No | ISO 3166-1 alpha-2 (default: `CH`) |
+
+**Returns:** `farm_type`, `investment_type`, `zone`, `jurisdiction`, `eligible_grants_count`, `eligible_grants[]` with grant details and `requirements[]`; `_meta`.
+
+---
+
+## `list_grant_options`
+
+List sub-options (Massnahmen) within a grant programme, or list all grants with option counts.
+
+**Parameters:**
+
+| Param | Type | Required | Description |
+|-------|------|----------|-------------|
+| `grant_id` | `string` | No | Grant ID. If omitted, lists all grants with option counts. |
+| `jurisdiction` | `string` | No | ISO 3166-1 alpha-2 (default: `CH`) |
+
+**Returns (with grant_id):** `grant_id`, `grant_name`, `options_count`, `options[]` with `option_name`, `description`, `rate`, `conditions`; `_meta`.
+
+**Returns (without grant_id):** `grants_count`, `grants[]` with `id`, `name`, `grant_type`, `option_count`; `_meta`.
+
+---
+
+## `get_application_deadlines`
+
+Application deadlines for grants, optionally filtered by canton.
+
+**Parameters:**
+
+| Param | Type | Required | Description |
+|-------|------|----------|-------------|
+| `grant_id` | `string` | No | Grant ID to check deadlines for |
+| `canton` | `string` | No | Canton 2-letter code: `ZH`, `BE`, `LU`, `SG`, `GR`, `VS`, `TI`, etc. |
+| `jurisdiction` | `string` | No | ISO 3166-1 alpha-2 (default: `CH`) |
+
+**Returns:** `grant_id`, `canton`, `jurisdiction`, `deadlines_count`, `deadlines[]` with `grant_id`, `grant_name`, `grant_type`, `canton`, `deadline_date`, `notes`; `_meta`.
+
+---
+
+## `search_application_guidance`
+
+How to apply for Swiss farm grants. Returns FTS search results plus general application guidance.
+
+**Parameters:**
+
+| Param | Type | Required | Description |
+|-------|------|----------|-------------|
+| `query` | `string` | Yes | Free-text query about the application process |
+| `jurisdiction` | `string` | No | ISO 3166-1 alpha-2 (default: `CH`) |
+
+**Returns:** `query`, `jurisdiction`, `search_results_count`, `search_results[]`, plus `application_guidance` with `general_process[]`, `required_documents[]`, and `contact_points[]`; `_meta`.

package/data/coverage.json

@@ -0,0 +1,19 @@
+{
+  "server": "ch-farm-grants-mcp",
+  "jurisdiction": "CH",
+  "version": "0.1.0",
+  "last_ingest": "2026-04-05",
+  "data": {
+    "grants": 25,
+    "grant_options": 23,
+    "eligibility_rules": 29,
+    "application_deadlines": 20
+  },
+  "tools": 10,
+  "sources": [
+    "Strukturverbesserungsverordnung (SVV, SR 913.1)",
+    "BLW Weisungen Investitionskredite und Beitraege",
+    "Kantonale Landwirtschaftsaemter",
+    "AGRIDEA Beratungsunterlagen"
+  ]
+}