Skip to main content
Glama
Planthire AI MCP

Planthire AI MCP

MCP Scorecard: 86/100

Planthire Ai MCP

MEOK AI Labs GSPC License PyPI

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_equipment

Search the construction equipment catalog by type, capacity, or keyword. Returns matching plant with specs and daily/weekly rates.

get_rental_quote

Calculate rental pricing for a piece of equipment over a given hire period, including delivery and collection costs.

check_availability

Check whether specific equipment is available for a requested date range across depots.

create_booking

Create an equipment rental booking with delivery address, hire dates, and contact details.

get_safety_checklist

Get an HSE-compliant pre-use safety inspection checklist tailored to the equipment type (e.g. excavator, telehandler).

calculate_transport

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

councilof.ai

EU AI Act compliance marketplace

safetyof.ai

AI safety & monitoring

meok.ai

Sovereign AI platform

cobolbridge.ai

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_equipment to …"

  • "Use get_rental_quote to …"

  • "Use check_availability to …"

Available Tools

7 tools
calculate_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

    A3.5/5.0

    Scored across 7 tools

    Disambiguation4/5

    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.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern in snake_case (e.g., calculate_transport, check_availability, create_booking). No mixing of conventions.

    Tool Count5/5

    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.

    Completeness3/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers