Planthire AI MCP
uplanthireU aiU mcp
건설 장비 대여 인텔리전스. 영국 건설 장비 대여를 위한 장비 검색, 대여 견적 확인, 가용성 확인, 예약 생성, HSE 규정 준수 안전 체크리스트 액세스 및 운송 비용 계산 기능을 제공합니다.
설치
pip install planthire-ai-mcp
# or
npm install -g @meok-ai/planthire-ai-mcpRelated MCP server: Env Manager AI MCP
빠른 시작
전체 문서 및 예제는 프로젝트 저장소를 참조하세요.
엔터프라이즈 지원
라이선스
MIT © CSOAI
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