aria-mcp-affald-horsens
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@aria-mcp-affald-horsens næste tømning på Vestergade 5"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
aria-mcp-affald-horsens
A Model Context Protocol (MCP) server for household waste collection schedules in Horsens Kommune. Built for ARIA and shareable with the community.
Example output ARIA might give Kim:
i aften: rest/madaffald ud (tømmes mandag den 15. juni) næste papir/pap: tirsdag den 23. juni (om 10 dage)
Data Source
Data is fetched from PerfectWaste (https://europe-west3-perfect-waste.cloudfunctions.net), the backend powering Horsens Kommune's waste portal. The API is unofficial and undocumented — it was reverse-engineered from the portal and community Home Assistant integrations. There is no guarantee of stability; Horsens might migrate providers without notice.
The legacy horsens.renoweb.dk ASMX endpoint (GetAffaldsplanMateriel_mitAffald) is MitID-gated and cannot be used headlessly. Only address search on that endpoint is unauthenticated, but it is useless without schedule access. PerfectWaste is fully headless with no auth.
Best-effort only. Always verify collection dates at horsens.dk/affald.
Related MCP server: smhi-mcp
Install & Run
npx aria-mcp-affald-horsensOr install globally:
npm install -g aria-mcp-affald-horsens
aria-mcp-affald-horsensRequires Node.js 20 or later.
Tools
find_address
Search for a Horsens address and return PerfectWaste address candidates (id + display name).
Parameters:
Name | Type | Required | Description |
| string | Yes | Address string to search (e.g. |
Returns:
{
"query": "Vestergade 5",
"candidates": [
{ "addressID": "39429", "displayName": "Vestergade 5, 8732 Hovedgård" },
{ "addressID": "47864", "displayName": "Vestergade 5, 8700 Horsens" }
]
}next_collection
Return the next upcoming collection date for each waste fraction at an address.
Parameters:
Name | Type | Required | Description |
| string | Yes | Free-text address or raw PerfectWaste addressID (digits only) |
Returns:
{
"addressID": "47864",
"addressDisplay": "Vestergade 5, 8700 Horsens",
"asOf": "2026-06-13T08:00",
"nextByFraction": [
{
"fractionName": "Rest - Mad",
"date": "2026-06-15T00:00:00.000Z",
"dateLocal": "2026-06-15",
"dateLabel": "mandag den 15. juni 2026",
"daysUntil": 2,
"putOutTonight": false
},
{
"fractionName": "Papir, pap og tekstilaffald",
"date": "2026-06-23T00:00:00.000Z",
"dateLocal": "2026-06-23",
"dateLabel": "tirsdag den 23. juni 2026",
"daysUntil": 10,
"putOutTonight": false
},
{
"fractionName": "Plast og drikkekarton - Glas og metal",
"date": "2026-06-26T00:00:00.000Z",
"dateLocal": "2026-06-26",
"dateLabel": "fredag den 26. juni 2026",
"daysUntil": 13,
"putOutTonight": false
}
],
"notice": "Data source: PerfectWaste (unofficial API, Horsens Kommune). ..."
}putOutTonight is true when the collection is tomorrow — use it for reminders like "i aften: rest/madaffald ud".
collection_calendar
Return all upcoming collection events for the next N weeks.
Parameters:
Name | Type | Required | Description |
| string | Yes | Free-text address or raw PerfectWaste addressID |
| number | No | Look-ahead in weeks (default 4, max 52) |
Returns: Same fields as next_collection events but as a flat chronological list covering the full window.
Environment Variables
Variable | Default | Description |
|
| Override the PerfectWaste base URL. Useful if another kommune uses the same backend at a different endpoint. |
|
| Municipality code. |
The RENOWEB_* names are intentional — they keep the interface familiar and forward-compatible if a true RenoWeb headless path is discovered later.
ARIA MCP Config
Add to your ARIA MCP config (mcpServers in ARIA credentials):
{
"command": "npx",
"args": ["-y", "aria-mcp-affald-horsens"],
"env": {}
}ARIA can then answer questions like:
"hvornår tømmes papir næste gang?"
"hvad skal ud i aften?"
"vis affaldskalender for de næste 4 uger på Vestergade 5"
Fragility Notes
API is undocumented. PerfectWaste has no published SLA for this endpoint. It has been stable since at least early 2026, but could break without notice.
Municipality codes. The
615code for Horsens was discovered empirically. Other kommuner using PerfectWaste will have different codes.Address coverage. Some commercial/institutional addresses (e.g. Rådhustorvet 4) return empty collection data — the portal apparently only covers residential collection routes.
Calendar depth. PerfectWaste typically returns ~3 months of data. The
weeksparameter is capped client-side.
Development
git clone https://github.com/kimhjort/aria-mcp-affald-horsens
cd aria-mcp-affald-horsens
npm install
npm run build
npm testLicense
MIT — see LICENSE.
Available Tools
3 toolscollection_calendarA
Return all upcoming waste collection events for a Horsens address over the next N weeks. Each event includes the date (ISO 8601), a human-readable Danish date label (e.g. "mandag den 15. juni 2026"), daysUntil, and the fractions to be collected. Use this when ARIA needs to plan ahead or answer "hvornår tømmes X de næste uger?". The 'address' parameter accepts a free-text address string or a raw PerfectWaste addressID. The 'weeks' parameter controls the look-ahead window (default 4, max 52).
Inputs: address (required), weeks.
find_addressA
Search for a Horsens Kommune address and return PerfectWaste address candidates (each with an addressID and a displayName). Use this to resolve a free-text address string before calling next_collection or collection_calendar, or to disambiguate when multiple addresses match (e.g. Søndergade 1 in both 8700 and 8740). Returns up to 30 candidates ordered by relevance.
Inputs: query (required).
next_collectionA
Return the next upcoming waste collection date for each fraction at a given Horsens address. Fractions include Rest - Mad (general/food waste), Papir, pap og tekstilaffald (paper/cardboard/textiles), and Plast og drikkekarton - Glas og metal (plastic/cartons/glass/metal). The 'putOutTonight' flag is true when that fraction is collected tomorrow — use it to remind Kim "i aften: [fraktion] ud". The 'address' parameter accepts a free-text address string or a raw PerfectWaste addressID (digits only). When the address is ambiguous, prefers 8700 Horsens results.
Inputs: address (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool has a clear, distinct purpose: address resolution, next collection, and calendar of upcoming collections. No overlap.
All tool names use consistent snake_case verb_noun pattern: find_address, next_collection, collection_calendar.
Three tools are well-scoped for the domain of waste collection lookup in a single municipality—sufficient without being excessive.
The set covers address disambiguation, immediate next collection, and future planning via calendar. No obvious gaps.
Related MCP Connectors
Danish address & property lookup: BBR, Matriklen, DAR, CVR. A DAWA/Datafordeler-compatible source.
Statistics Denmark (Danmarks Statistik / Statbank) MCP. Keyless REST API: https://api.statbank.dk/v1
Energi Data Service (Energinet) MCP — Denmark's official open energy data. Keyless. Electricity…
MCP server for Statistics Sweden (SCB) - 1200+ tables with population, economy, environment data
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceMCP server for the Danish Address Web API (DAWA), enabling free-text address search, house number search, and detailed address lookup by ID.-
- FlicenseNot gradedqualityCmaintenanceMCP server that provides real-time weather data, forecasts, and historical weather information from SMHI (Swedish Meteorological and Hydrological Institute) for any location in Sweden.2-
- AlicenseAqualityCmaintenanceMCP server for Danish electricity prices, providing current spot price, cheapest hours, and 7-day forecast for DK1 and DK2 areas.553 npmMIT
- AlicenseAqualityDmaintenanceMCP server that provides tools to search Norwegian addresses, reverse geocode, find place names, and get elevation data from Kartverket's open geographic datasets.411 npm1MIT