Opa Haardhout MCP

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "Zoektekst op naam, plaats of omschrijving / free-text search."
    },
    "lat": {
      "type": "number",
      "maximum": 53.8,
      "minimum": 50.5,
      "description": "Breedtegraad van de zoeklocatie (alternatief voor postcode; samen met lng) / latitude."
    },
    "lng": {
      "type": "number",
      "maximum": 7.5,
      "minimum": 3,
      "description": "Lengtegraad van de zoeklocatie (samen met lat) / longitude."
    },
    "hout": {
      "type": "array",
      "items": {
        "enum": [
          "eiken",
          "beuken",
          "essen",
          "berken",
          "elzen",
          "haagbeuk",
          "fruithout",
          "naaldhout",
          "acacia",
          "esdoorn",
          "populier",
          "wilg",
          "kastanje",
          "iepen",
          "gemengd"
        ],
        "type": "string"
      },
      "description": "Houtsoort(en) / wood species. Meerdere = OR."
    },
    "type": {
      "type": "array",
      "items": {
        "enum": [
          "commercial",
          "local",
          "private",
          "byproduct"
        ],
        "type": "string"
      },
      "description": "Soort aanbieder / seller type."
    },
    "vorm": {
      "type": "array",
      "items": {
        "enum": [
          "gekloofd",
          "losgestort",
          "stamhout",
          "netzak",
          "bigbag",
          "pallet",
          "kist",
          "zak",
          "briketten",
          "pellets",
          "aanmaakhout",
          "houtsnippers",
          "bbq-chunks",
          "container"
        ],
        "type": "string"
      },
      "description": "Vorm of verpakking / form or packaging."
    },
    "limit": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "description": "Aantal resultaten (1–100, standaard 20) / number of results."
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "minimum": 0,
      "description": "Paginering / pagination offset."
    },
    "plaats": {
      "type": "string",
      "description": "Plaatsnaam, exacte match / city name, exact match."
    },
    "afstand": {
      "type": "number",
      "maximum": 300,
      "minimum": 1,
      "description": "Maximale afstand in km tot de postcode of lat+lng. Aanbieders zonder bekende locatie vallen dan weg. / radius in km."
    },
    "droging": {
      "type": "array",
      "items": {
        "enum": [
          "ovengedroogd",
          "droog",
          "halfdroog",
          "vers"
        ],
        "type": "string"
      },
      "description": "Droogtegraad / drying grade."
    },
    "bezorgen": {
      "type": "boolean",
      "description": "Alleen aanbieders die bezorgen / delivery only."
    },
    "postcode": {
      "type": "string",
      "description": "Nederlandse postcode, bijv. 7941 of 7941 AB / Dutch postcode; sorts by distance. Niet combineren met lat+lng."
    },
    "provincie": {
      "enum": [
        "drenthe",
        "flevoland",
        "friesland",
        "gelderland",
        "groningen",
        "limburg",
        "noord-brabant",
        "noord-holland",
        "overijssel",
        "utrecht",
        "zeeland",
        "zuid-holland"
      ],
      "type": "string",
      "description": "Provincie / province."
    },
    "zoekintentie": {
      "type": "string",
      "maxLength": 200,
      "description": "Optioneel: waarom zoek je, of wat vraagt je gebruiker? Verandert niets aan de resultaten — het helpt ons de index en de zoekresultaten te verbeteren (welke vraag krijgen we die we nog niet goed beantwoorden). Geen persoonsgegevens meesturen. / Optional: what is your user actually asking? Never affects the results; helps us improve the index."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "description": "Envelope met data, meta en attribution."
}

{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}

{
  "type": "object",
  "required": [
    "slug"
  ],
  "properties": {
    "slug": {
      "type": "string",
      "pattern": "^[a-z0-9-]+$",
      "description": "Slug van de aanbieder, bijv. \"123hout-nl\" / seller slug."
    },
    "context": {
      "type": "string",
      "maxLength": 200,
      "description": "Optioneel: waarvoor haal je dit profiel op? Verandert niets aan wat je terugkrijgt — het helpt ons de index en de resultaten te verbeteren. Geen persoonsgegevens meesturen. / Optional: why are you fetching this profile? Never affects the response."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "description": "Envelope met data, meta en attribution."
}

{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

{
  "type": "object",
  "description": "Envelope met data, meta en attribution."
}

{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}

{
  "type": "object",
  "properties": {
    "houtsoort": {
      "enum": [
        "eiken",
        "beuken",
        "essen",
        "berken",
        "elzen",
        "haagbeuk",
        "fruithout",
        "naaldhout",
        "acacia",
        "esdoorn",
        "populier",
        "wilg",
        "kastanje",
        "iepen",
        "gemengd"
      ],
      "type": "string",
      "description": "Optioneel: één houtsoort; weglaten voor alle soorten / optional single species."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "description": "Envelope met data, meta en attribution."
}

{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true
}

{
  "type": "object",
  "required": [
    "slugs",
    "context"
  ],
  "properties": {
    "agent": {
      "type": "string",
      "maxLength": 100,
      "description": "Optioneel: hoe heet je? Bijv. \"claude-mcp\" of de naam van je product. Puur om te zien welke assistenten de data gebruiken. / Optional self-identification."
    },
    "slugs": {
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^[a-z0-9-]+$"
      },
      "maxItems": 10,
      "minItems": 1,
      "description": "De slugs die je daadwerkelijk gebruikt hebt (1–10), uit het veld `slug` van een zoekresultaat. Niet je hele resultatenlijst — alleen wat in je antwoord terechtkwam. / The slugs you actually used."
    },
    "context": {
      "enum": [
        "getoond",
        "aanbevolen",
        "gecontacteerd"
      ],
      "type": "string",
      "description": "Hoe heb je ze gebruikt: getoond (in het antwoord laten zien), aanbevolen (expliciet aangeraden) of gecontacteerd (je gebruiker heeft contact opgenomen). / How you used them."
    },
    "resultaat": {
      "enum": [
        "geholpen",
        "niet_geholpen",
        "onbekend"
      ],
      "type": "string",
      "description": "Optioneel: hielp het je gebruiker? geholpen | niet_geholpen | onbekend. / Optional outcome."
    },
    "zoekintentie": {
      "type": "string",
      "maxLength": 500,
      "description": "Optioneel: wat vroeg je gebruiker eigenlijk? Dit is het nuttigste veld voor ons — hieraan zien we welke vraag we nog niet goed beantwoorden. Noem er ook de houtsoort in, dan krijg je de bijbehorende prijsband terug. Geen persoonsgegevens meesturen: e-mailadressen en telefoonnummers worden er automatisch uitgefilterd. / Optional: what did your user actually ask?"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "description": "Envelope met data.gemeld (per slug: naam, laatstGeverifieerd, dagenGeleden, status), data.prijsband en data.bedankt."
}

{
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}