io.github.CSOAI-ORG/muckaway-ai-mcp

Estimate waste volume from dimensions and recommend skip size. Calculates cubic metres from length x width x depth, applies a compaction factor, and recommends the most cost-effective skip size. Includes estimated weight based on waste type density. Args: length_m: Length in metres. width_m: Width in metres. depth_m: Depth/height in metres. waste_type: Type of waste (general, heavy_inert, hazardous, recyclable, green). Affects weight estimate. compaction_factor: Multiplier for loose/bulky waste (1.0 = as measured, 1.3 = loose rubble, 0.7 = compacted). Default 1.0. Returns: Volume in cubic metres, estimated weight, recommended skip size, and pricing. Behavior: This tool is read-only and stateless — it produces analysis output without modifying any external systems, databases, or files. Safe to call repeatedly with identical inputs (idempotent). Free tier: 10/day rate limit. Pro tier: unlimited. No authentication required for basic usage. When to use: Use this tool when you need structured analysis or classification of inputs against established frameworks or standards. When NOT to use: Not suitable for real-time production decision-making without human review of results. Behavioral Transparency: - Side Effects: This tool is read-only and produces no side effects. It does not modify any external state, databases, or files. All output is computed in-memory and returned directly to the caller. - Authentication: No authentication required for basic usage. Pro/Enterprise tiers require a valid MEOK API key passed via the MEOK_API_KEY environment variable. - Rate Limits: Free tier: 10 calls/day. Pro tier: unlimited. Rate limit headers are included in responses (X-RateLimit-Remaining, X-RateLimit-Reset). - Error Handling: Returns structured error objects with 'error' key on failure. Never raises unhandled exceptions. Invalid inputs return descriptive validation errors. - Idempotency: Fully idempotent — calling with the same inputs always produces the same output. Safe to retry on timeout or transient failure. - Data Privacy: No input data is stored, logged, or transmitted to external services. All processing happens locally within the MCP server process.

Return skip hire pricing by size with permit costs. Covers all standard UK skip sizes from 4yd mini to 40yd roll-on. Includes council permit costs for road/pavement placement and regional price variations. Args: skip_size: Skip size code (4yd, 6yd, 8yd, 12yd, 16yd, 20yd, 40yd). on_road: Whether the skip will be placed on a public road/pavement (requires council permit). Default False (placed on private land). hire_days: Number of hire days. Standard is 14. Extended hire incurs daily surcharge. region: Pricing region (london, south_east, midlands, north, scotland, wales). Returns: Detailed pricing breakdown including hire, permit, and VAT. Behavior: This tool is read-only and stateless — it produces analysis output without modifying any external systems, databases, or files. Safe to call repeatedly with identical inputs (idempotent). Free tier: 10/day rate limit. Pro tier: unlimited. No authentication required for basic usage. When to use: Use this tool when you need structured analysis or classification of inputs against established frameworks or standards. When NOT to use: Not suitable for real-time production decision-making without human review of results. Behavioral Transparency: - Side Effects: This tool is read-only and produces no side effects. It does not modify any external state, databases, or files. All output is computed in-memory and returned directly to the caller. - Authentication: No authentication required for basic usage. Pro/Enterprise tiers require a valid MEOK API key passed via the MEOK_API_KEY environment variable. - Rate Limits: Free tier: 10 calls/day. Pro tier: unlimited. Rate limit headers are included in responses (X-RateLimit-Remaining, X-RateLimit-Reset). - Error Handling: Returns structured error objects with 'error' key on failure. Never raises unhandled exceptions. Invalid inputs return descriptive validation errors. - Idempotency: Fully idempotent — calling with the same inputs always produces the same output. Safe to retry on timeout or transient failure. - Data Privacy: No input data is stored, logged, or transmitted to external services. All processing happens locally within the MCP server process.

Classify waste type and return disposal requirements. Classifies waste as general, heavy/inert, hazardous, recyclable, or green waste based on description and materials. Returns applicable UK regulations, disposal methods, and landfill tax implications. Args: description: Description of the waste (e.g. "rubble from demolished wall", "old bathroom suite", "garden hedge trimmings"). materials: Optional list of specific materials present (e.g. ["concrete", "bricks", "timber", "plasterboard"]). Returns: Waste classification, disposal requirements, regulations, and costs. Behavior: This tool is read-only and stateless — it produces analysis output without modifying any external systems, databases, or files. Safe to call repeatedly with identical inputs (idempotent). Free tier: 10/day rate limit. Pro tier: unlimited. No authentication required for basic usage. When to use: Use this tool when you need structured analysis or classification of inputs against established frameworks or standards. When NOT to use: Not suitable for real-time production decision-making without human review of results.

Calculate haulage cost for waste transport. Pricing based on vehicle type, distance, waste weight, and London charges (congestion/ULEZ). Covers grab lorries, skip lorries, tippers, and roll-on roll-off vehicles. Args: distance_miles: One-way distance in miles. vehicle_type: Vehicle type (grab_lorry, skip_lorry, tipper, ro_ro_lorry). waste_weight_tonnes: Estimated weight of waste in tonnes. return_trip: Whether this is a return trip (default True). congestion_zone: Whether route enters London Congestion Charge zone. ulez: Whether route enters London ULEZ zone. Returns: Detailed haulage cost breakdown. Behavior: This tool is read-only and stateless — it produces analysis output without modifying any external systems, databases, or files. Safe to call repeatedly with identical inputs (idempotent). Free tier: 10/day rate limit. Pro tier: unlimited. No authentication required for basic usage. When to use: Use this tool when you need structured analysis or classification of inputs against established frameworks or standards. When NOT to use: Not suitable for real-time production decision-making without human review of results. Behavioral Transparency: - Side Effects: This tool is read-only and produces no side effects. It does not modify any external state, databases, or files. All output is computed in-memory and returned directly to the caller. - Authentication: No authentication required for basic usage. Pro/Enterprise tiers require a valid MEOK API key passed via the MEOK_API_KEY environment variable. - Rate Limits: Free tier: 10 calls/day. Pro tier: unlimited. Rate limit headers are included in responses (X-RateLimit-Remaining, X-RateLimit-Reset). - Error Handling: Returns structured error objects with 'error' key on failure. Never raises unhandled exceptions. Invalid inputs return descriptive validation errors. - Idempotency: Fully idempotent — calling with the same inputs always produces the same output. Safe to retry on timeout or transient failure. - Data Privacy: No input data is stored, logged, or transmitted to external services. All processing happens locally within the MCP server process.

Find nearest licensed waste disposal facilities by waste type and postcode. Searches UK licensed facilities that accept the specified waste type, matched by postcode area. Returns Environment Agency permit details. Args: postcode: UK postcode (e.g. "SE1 7PB", "M1 1AA", "BS1 4DJ"). waste_type: Waste classification (general, heavy_inert, hazardous, recyclable, green). Returns: List of matching facilities with permit details and accepted waste types. Behavior: This tool is read-only and stateless — it produces analysis output without modifying any external systems, databases, or files. Safe to call repeatedly with identical inputs (idempotent). Free tier: 10/day rate limit. Pro tier: unlimited. No authentication required for basic usage. When to use: Use this tool when you need structured analysis or classification of inputs against established frameworks or standards. When NOT to use: Not suitable for real-time production decision-making without human review of results.

Generate a Waste Transfer Note with all legally mandatory fields. A Waste Transfer Note is required by law for EVERY transfer of controlled waste in England and Wales (Environmental Protection Act 1990, Section 34; Environmental Protection (Duty of Care) Regulations 1991). Must be retained for minimum 2 years. Args: producer_name: Name of waste producer (person/business generating the waste). producer_address: Address where waste was produced. carrier_name: Name of registered waste carrier. carrier_licence_number: Carrier's waste carrier licence number (CBDU/CBDL prefix). waste_description: Written description of the waste. waste_type: Classification (general, heavy_inert, hazardous, recyclable, green). ewc_code: European Waste Catalogue code (6 digits, e.g. "170101" for concrete). Leave blank for auto-suggestion. quantity_tonnes: Quantity in tonnes (provide either tonnes or m3). quantity_m3: Quantity in cubic metres. destination_name: Name of receiving facility. destination_permit_number: Receiving facility's Environment Agency permit number. sic_code: Standard Industrial Classification code of waste producer. transfer_date: Date of transfer (YYYY-MM-DD). Defaults to today. Returns: Complete Waste Transfer Note with all mandatory fields and reference number. Behavior: This tool generates structured output without modifying external systems. Output is deterministic for identical inputs. No side effects. Free tier: 10/day rate limit. Pro tier: unlimited. No authentication required for basic usage. When to use: Use this tool when you need structured analysis or classification of inputs against established frameworks or standards. When NOT to use: Not suitable for real-time production decision-making without human review of results.

AGENT-CALLABLE END-TO-END SKIP HIRE. Books a skip in one call: estimates the right skip size → prices the job → finds the nearest disposal tip → checks availability → generates the Waste Transfer Note → returns a single agent-friendly response. Args: collection_postcode: Where the skip is delivered (UK postcode). waste_type: "soil", "rubble", "green_waste", "concrete", "wood", "mixed", "metal". volume_m3: Estimated volume in cubic meters. requested_date_iso: ISO date "YYYY-MM-DD". ewc_code: EWC waste code (default "17 09 04" = mixed construction). carrier_licence: Carrier licence (default MK/123456). Returns: { "status": "ready_to_confirm" | "needs_human_input" | "rejected", "estimate": {...}, "pricing": {...}, "disposal_facility": {...}, "wtn": {...}, "next_action": "...", "agent_metadata": {...} }