Voor ontwikkelaars

{
  "mcpServers": {
    "afvalbakkie": { "url": "https://www.afval-bakkie.nl/mcp" }
  }
}

claude mcp add --transport http afvalbakkie https://www.afval-bakkie.nl/mcp

curl -X POST https://www.afval-bakkie.nl/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
       "params":{"name":"afval_scheiden","arguments":{"voorwerp":"pizzadoos"}}}'

event: message
data: {"result":{"content":[{"type":"text","text":"{\n  \"gevonden\": true,\n  \"resultaten\": [ { \"voorwerp\": \"Pizzadoos\", \"hoort_bij\": \"Papier & karton\", \"waar\": \"Blauwe container\", \"tip\": \"Vetvlekken zijn geen probleem. Etensresten eruit (GFT).\" } ] }"}],"isError":false},"jsonrpc":"2.0","id":1}

{
  "adres": "Kerkstraat 12, 1234AB Voorbeelddorp",
  "vandaag": "maandag 28 september",
  "ophaaldagen": [
    { "datum": "2026-09-28", "dag": "vandaag (maandag 28 september)", "afval": "Papier & karton", "container": "Blauwe container" },
    { "datum": "2026-10-01", "dag": "donderdag 1 oktober", "afval": "GFT", "container": "Groene container" }
  ]
}

import { Client } from '@modelcontextprotocol/sdk/client/index.js';
import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';

const client = new Client({ name: 'mijn-app', version: '1.0.0' });
await client.connect(new StreamableHTTPClientTransport(new URL('https://www.afval-bakkie.nl/mcp')));

const res = await client.callTool({
  name: 'ophaaldagen',
  arguments: { postcode: '1234AB', huisnummer: 12 },
});
const data = JSON.parse(res.content[0].text);
console.log(data.ophaaldagen[0]); // { datum, dag, afval, container }
await client.close();

import asyncio, json
from mcp import ClientSession
from mcp.client.streamable_http import streamable_http_client

async def main():
    async with streamable_http_client("https://www.afval-bakkie.nl/mcp") as (read, write):
        async with ClientSession(read, write) as session:
            await session.initialize()
            result = await session.call_tool("afval_scheiden", {"voorwerp": "pizzadoos"})
            print(json.loads(result.content[0].text)["resultaten"][0]["hoort_bij"])

asyncio.run(main())

GET https://www.afval-bakkie.nl/api/ics/{postcode}/{huisnummer}.ics

BEGIN:VCALENDAR
VERSION:2.0
PRODID:-//AfvalBakkie//NL
X-WR-CALNAME:Afvalkalender Kerkstraat 12
REFRESH-INTERVAL;VALUE=DURATION:P1D
BEGIN:VEVENT
UID:1234AB-12-gft-2026-10-01@afvalbakkie
DTSTART;VALUE=DATE:20261001
DTEND;VALUE=DATE:20261002
SUMMARY:GFT ophalen
DESCRIPTION:Groene container. Los in de container\, zonder plastic zakje.
BEGIN:VALARM
ACTION:DISPLAY
DESCRIPTION:Morgen GFT: zet de container vanavond buiten
TRIGGER:-PT5H
END:VALARM
END:VEVENT
END:VCALENDAR

<a href="webcal://www.afval-bakkie.nl/api/ics/1234AB/12.ics">Zet je ophaaldagen in je agenda</a>

Inwoner          Jouw app         Jouw server           AfvalBakkie
   |  tikt "Seintjes  |                  |                     |
   |  in WhatsApp"  ->|                  |                     |
   |                  |-- adres -------->|                     |
   |                  |                  |-- POST /koppelcode ->|
   |                  |                  |<- code + link -------|
   |                  |<- link ----------|                     |
   |<- WhatsApp opent met "KOPPEL ABC123"                      |
   |-- verstuurt het bericht ---------------------------------->|
   |<- "Top, je bent aangemeld voor Kerkstraat 12!" ------------|

curl -X POST https://www.afval-bakkie.nl/api/v1/koppelcode \
  -H 'Authorization: Bearer abk_…' \
  -H 'Content-Type: application/json' \
  -d '{"postcode":"1234AB","huisnummer":12,"toevoeging":"A"}'

HTTP/1.1 201 Created
Content-Type: application/json

{
  "code": "ABC123",
  "tekst": "KOPPEL ABC123",
  "whatsapp": "https://wa.me/3197006533338?text=KOPPEL%20ABC123",
  "adres": "Kerkstraat 12A, 1234AB Voorbeelddorp",
  "verloopt": "2026-10-01T08:42:00.000Z"
}

{ "fout": "Dit adres staat niet in de BAG. Controleer postcode, huisnummer en toevoeging." }

// Route op jouw server: de app vraagt hier een link op, de sleutel blijft op de server.
app.post('/whatsapp-link', async (req, res) => {
  const { postcode, huisnummer, toevoeging } = req.user.adres; // het adres dat al in je app staat
  const r = await fetch('https://www.afval-bakkie.nl/api/v1/koppelcode', {
    method: 'POST',
    headers: { Authorization: `Bearer ${process.env.AFVALBAKKIE_KEY}`, 'Content-Type': 'application/json' },
    body: JSON.stringify({ postcode, huisnummer, toevoeging }),
  });
  if (!r.ok) return res.status(r.status).json(await r.json());
  const { whatsapp } = await r.json();
  res.json({ link: whatsapp }); // de app opent deze link
});

From: AfvalBakkie <meldingen@afval-bakkie.nl>
To: meldingen@gemeente.nl
Subject: Melding M-2026-000042 · Container niet geleegd · Kerkstraat 12, 1234AB Voorbeelddorp
X-AfvalBakkie-Referentie: M-2026-000042
X-AfvalBakkie-Soort: niet_geleegd
Content-Type: multipart/mixed

  tekst en HTML: dezelfde gegevens, leesbaar
  bijlage melding.json       (application/json, zie hieronder)
  bijlage melding-foto.jpg   (alleen als de inwoner een foto stuurde)

{
  "schema": "afvalbakkie.melding.v1",
  "referentie": "M-2026-000042",
  "soort": "niet_geleegd",
  "soortLabel": "Container niet geleegd",
  "afvalstroom": "gft",
  "omschrijving": "GFT-container staat sinds vanochtend vol aan de straat.",
  "locatie": {
    "tekst": "Kerkstraat 12, 1234AB Voorbeelddorp",
    "lat": 52.2812,
    "lon": 5.159
  },
  "gemeente": {
    "code": "1942",
    "naam": "Voorbeeldgemeente"
  },
  "kanaal": "whatsapp",
  "ontvangen": "2026-10-01T08:12:00.000Z",
  "foto": "melding-foto.jpg",
  "statusBijwerken": "https://www.afval-bakkie.nl/beheer?gemeente=1942"
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://www.afval-bakkie.nl/schemas/afvalbakkie.melding.v1.json",
  "title": "Melding uit AfvalBakkie (v1)",
  "type": "object",
  "required": [
    "schema",
    "referentie",
    "soort",
    "soortLabel",
    "omschrijving",
    "locatie",
    "kanaal",
    "ontvangen"
  ],
  "properties": {
    "schema": {
      "const": "afvalbakkie.melding.v1"
    },
    "referentie": {
      "type": "string",
      "pattern": "^M-\\d{4}-\\d{6}$",
      "description": "Uniek per melding, ook in het onderwerp en de kopregel X-AfvalBakkie-Referentie"
    },
    "soort": {
      "enum": [
        "niet_geleegd",
        "container_kapot",
        "container_weg",
        "zwerfafval",
        "dumping",
        "ondergrondse_vol",
        "overig"
      ]
    },
    "soortLabel": {
      "type": "string",
      "description": "De soort in gewone taal"
    },
    "afvalstroom": {
      "type": [
        "string",
        "null"
      ],
      "description": "Bijvoorbeeld gft, pmd, papier, rest, textiel of glas"
    },
    "omschrijving": {
      "type": "string",
      "maxLength": 1000
    },
    "locatie": {
      "type": "object",
      "required": [
        "tekst"
      ],
      "properties": {
        "tekst": {
          "type": "string"
        },
        "lat": {
          "type": [
            "number",
            "null"
          ]
        },
        "lon": {
          "type": [
            "number",
            "null"
          ]
        }
      }
    },
    "gemeente": {
      "type": "object",
      "properties": {
        "code": {
          "type": [
            "string",
            "null"
          ],
          "description": "CBS-gemeentecode"
        },
        "naam": {
          "type": [
            "string",
            "null"
          ]
        }
      }
    },
    "kanaal": {
      "enum": [
        "whatsapp",
        "app"
      ]
    },
    "ontvangen": {
      "type": "string",
      "format": "date-time"
    },
    "foto": {
      "type": [
        "string",
        "null"
      ],
      "description": "Bestandsnaam van de foto in de bijlagen, of null"
    },
    "statusBijwerken": {
      "type": "string",
      "format": "uri",
      "description": "Link naar de melding in Beheer"
    }
  }
}