Planthire AI MCP
This MCP server provides AI-assisted UK plant hire (construction equipment rental) workflows — searching a fleet, quoting, checking availability, booking, safety checklists and transport costs — plus a one-call end-to-end rental tool.
Search equipment: Find plant by keyword, category (excavators, dumpers, telehandlers, compaction, power, access, loaders), max weight, dig depth, daily rate or licence requirement.
Quote rentals: Get tiered GBP pricing (daily 1–6 days, weekly 7–27, monthly 28+) with optional insurance, fuel and CPCS operator costs.
Check availability: Confirm equipment is free for a date range across eight UK depots (London, Birmingham, Manchester, Bristol, Glasgow, Leeds, Cardiff, Edinburgh), with alternatives if unavailable.
Create bookings: Place a hire with dates, depot, contact details, delivery address and operator/insurance options, returning a booking reference.
Safety compliance: Retrieve HSE/CPCS/IPAF-based pre-use inspection checklists per equipment type with regulatory references (PUWER/LOLER).
Estimate transport: Calculate delivery/collection costs from depot to site based on distance, weight class and return trip.
End-to-end hire (rent_equipment): In one call, search fleet → quote → check availability → book → return safety checklist, with a status of
ready_to_confirm,needs_human_inputorrejected.
Note: tools are described as read-only/idempotent with no stored data, but create_booking and rent_equipment produce booking confirmations, so verify before relying on them as side-effect-free. Free tier is rate-limited to 10 calls/day; a MEOK API key unlocks Pro usage.
Planthire Ai MCP
planthire-ai-mcp MCP — AI-powered automation tool
planthire-ai-mcp MCP — AI-powered automation tool. MIT.
🚀 Quick Start
PlantHire AI is an MCP server for UK construction equipment rental, built by MEOK AI Labs. It provides intelligent search across a plant hire catalog, rental quote calculation, real-time availability checking, booking creation, HSE-compliant pre-use safety checklists, and transport cost estimation for equipment delivery and collection.
Use cases: excavator/dumper/roller hire quotation, site equipment availability checks, LOLER/PUWER safety compliance, transport planning for heavy plant, and multi-item rental booking workflows.
Related MCP server: Env Manager AI MCP
Tools
Tool | Description |
| Search the construction equipment catalog by type, capacity, or keyword. Returns matching plant with specs and daily/weekly rates. |
| Calculate rental pricing for a piece of equipment over a given hire period, including delivery and collection costs. |
| Check whether specific equipment is available for a requested date range across depots. |
| Create an equipment rental booking with delivery address, hire dates, and contact details. |
| Get an HSE-compliant pre-use safety inspection checklist tailored to the equipment type (e.g. excavator, telehandler). |
| Estimate transport costs for delivery and/or collection of hired equipment based on site postcode and equipment dimensions. |
Installation
# Install via pip
pip install planthire_ai_mcp
# Or install via Smithery
npx -y @smithery/cli@latest install planthire-ai-mcp --client claude✨ Features
MCP protocol compliant
Easy installation
Well-documented API
Production-ready
Active maintenance
📖 Documentation
🛡️ Compliance
This MCP server is built with EU AI Act compliance built-in:
✅ Article 9 — Risk Management System
✅ Article 13 — Transparency & Instructions for Use
✅ Article 15 — Bias Detection & Testing
✅ Article 26 — FRIA Support (where applicable)
✅ Article 50 — AI Content Watermarking (where applicable)
Need help getting compliant? Book a free 15-min diagnostic →
How MEOK charges
MEOK has no subscriptions and no tiers. You pay per job, and only when the agreed artifact has been delivered to you. There is no public price list. See https://meok.ai/pricing.
This repository's source is MIT-licensed and free to self-host.
🤝 Part of the MEOK Ecosystem
This server is part of the MEOK AI Labs ecosystem — 300+ MCP servers for sovereign AI governance.
Domain | Purpose |
EU AI Act compliance marketplace | |
AI safety & monitoring | |
Sovereign AI platform | |
Legacy modernization |
📜 License
MIT © CSOAI-ORG
Pairs with MEOK Governance Suite
Build something that touches users? You need compliance. MEOK ships 38 governance MCPs that drop in alongside this tool — EU AI Act, DORA, NIS2, CRA, GDPR, ISO 42001, FDA SaMD, MDR, Basel, MiFID II, MiCA, COPPA, and more.
# One-shot install of the governance pack
npx meok-setup --pack governance→ Full catalogue: councilof.ai → MEOK AI Labs: meok.ai
Configuration
Add to your claude_desktop_config.json (Claude Desktop) or your MCP client config:
{
"mcpServers": {
"planthire-ai-mcp": {
"command": "uvx",
"args": ["planthire-ai-mcp"]
}
}
}Or: pip install planthire-ai-mcp then run the planthire-ai-mcp command (stdio transport).
Examples
Once configured, ask your assistant, for example:
"Use
search_equipmentto …""Use
get_rental_quoteto …""Use
check_availabilityto …"
Available Tools
7 toolscalculate_transportA
Estimate transport costs for equipment delivery/collection.
Pricing based on equipment size/weight class and distance.
Args: equipment_id: Equipment ID from catalog. distance_miles: One-way distance in miles from depot to site. depot: Collection depot. return_trip: Include return collection cost (default True).
Returns: Transport cost estimate with vehicle type.
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.
Inputs: equipment_id (required), distance_miles (required), depot, api_key, +1 more.
check_availabilityA
Check equipment availability for a date range.
Args: equipment_id: Equipment ID from catalog. start_date: Start date (YYYY-MM-DD). end_date: End date (YYYY-MM-DD). depot: Depot location (london, birmingham, manchester, bristol, glasgow, leeds, cardiff, edinburgh).
Returns: Availability status and alternative suggestions if unavailable.
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.
Inputs: end_date (required), start_date (required), equipment_id (required), depot, +1 more.
create_bookingD
Create an equipment booking.
Args: equipment_id: Equipment ID from catalog. start_date: Hire start date (YYYY-MM-DD). end_date: Hire end date (YYYY-MM-DD). depot: Collection depot. customer_name: Booking contact name. customer_email: Contact email. customer_phone: Contact phone number. include_insurance: Add damage waiver insurance. operator_required: Book with CPCS operator. delivery_address: If provided, equipment will be delivered (extra cost).
Returns: Booking confirmation with 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. 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.
Inputs: end_date (required), start_date (required), equipment_id (required), depot, +7 more.
get_rental_quoteA
Calculate rental pricing for equipment.
Applies tiered pricing: daily rate for 1-6 days, weekly rate for 7-27, monthly rate for 28+. Includes optional insurance, fuel, and operator costs.
Args: equipment_id: ID from search_equipment results. duration_days: Number of hire days. include_insurance: Add damage waiver insurance (default True). include_fuel: Include estimated fuel costs. operator_required: Include CPCS-carded operator.
Returns: Detailed pricing breakdown in GBP.
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.
Inputs: equipment_id (required), duration_days (required), api_key, include_fuel, +2 more.
get_safety_checklistA
Get pre-use safety inspection checklist for equipment type.
Based on HSE, CPCS, and IPAF guidelines. Categories: excavators, dumpers, telehandlers, compaction, access, power, loaders.
Args: equipment_type: Equipment category (e.g. 'excavators', 'telehandlers').
Returns: Detailed checklist with regulatory references.
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.
Inputs: equipment_type (required), api_key.
rent_equipmentA
AGENT-CALLABLE END-TO-END PLANT HIRE.
Rents a piece of plant equipment in one call: searches the fleet → gets a rental quote → checks availability for the requested date → creates a booking → returns the relevant safety checklist (PUWER/CITB SMSTS).
Args: equipment_type: "mini_excavator", "1t_dumper", "3t_dumper", "telehandler", "roller", "scissor_lift", "boom_lift", "genset", "compactor". postcode: Delivery postcode (UK). hire_days: Number of days to hire (default 1). include_operator: If True, +£420/day for a CPCS-certified operator. requested_start_date_iso: ISO date "YYYY-MM-DD" (optional — default "tomorrow").
Returns: { "status": "ready_to_confirm" | "needs_human_input" | "rejected", "search": {"matched": N, "results": [...]}, "quote": {"equipment": "...", "daily_rate_gbp": N, "total_gbp": N, ...}, "availability": {...}, "booking": {"booking_id": "..."}, "safety": {"checklist": [...], "regulations": ["PUWER 1998", ...]}, "next_action": "...", "agent_metadata": {...} }
Inputs: postcode (required), equipment_type (required), api_key, hire_days, +2 more.
search_equipmentA
Search the construction equipment catalog.
Filter by category, weight, capabilities, and price. Categories include: excavators, dumpers, telehandlers, compaction, power, access, loaders.
Args: query: Free-text search (matches name, uses, category). category: Equipment category filter. max_weight_tonnes: Maximum operating weight in tonnes. min_dig_depth_m: Minimum dig depth (excavators only). max_daily_rate: Maximum daily hire rate in GBP. requires_licence: Filter by licence requirement.
Returns: Matching equipment with specs and rates.
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.
Inputs: query, api_key, category, max_daily_rate, +3 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Tools have distinct purposes, but rent_equipment subsumes the functionality of search, quote, availability, booking, and safety, creating potential ambiguity for agents whether to use the composite tool or the granular individual tools.
All tool names follow a consistent verb_noun pattern in snake_case (e.g., calculate_transport, check_availability, create_booking). No mixing of conventions.
7 tools is well within the optimal 3-15 range for a plant hire server. Each tool serves a distinct part of the workflow without being excessive or minimal.
Core workflows (search, quote, availability, booking, safety, transport) are covered, but there are notable missing operations such as update/cancel booking or modify transport. The end-to-end tool partially mitigates this but doesn't provide full CRUD.
Maintenance
Related MCP Connectors
Official MCP server for Agentwork — delegate tasks to AI agents with human-in-the-loop
MCP server for Flux AI image generation
MCP server for Qwen Image 3 AI image generation
Related MCP Servers
- AlicenseAqualityCmaintenanceCron AI - MCP server providing AI-powered tools and automation by MEOK AI Labs44 npm40 PyPIMIT
- AlicenseNot gradedqualityCmaintenanceEnv Manager AI - MCP server providing AI-powered tools and automation by MEOK AI Labs5 npm45 PyPIMIT
- AlicenseNot gradedqualityFmaintenanceConsciousness Engine - MCP server providing AI-powered tools and automation by MEOK AI Labs4 npm32 PyPIMIT
- AlicenseNot gradedqualityCmaintenanceEvent Planning AI - MCP server providing AI-powered tools and automation by MEOK AI Labs4 npm37 PyPIMIT