io.github.lilo-property/mcp-server

Get complete details for a vacation rental property including name, location, address, property type, bedrooms, bathrooms, nightly rate, amenities, house rules, photos, protection status, and host reputation score. Use the property_id (UUID) or lilo_code (e.g. PROP-2343) to identify the property.

Search for vacation rentals, short-term rentals, and accommodation properties by location, guest count, and property type. Use this when a traveler wants to find a place to stay. Returns matching properties with names, locations, nightly rates, photos, and protection status.

Search lilo's market discovery for vacation rental properties in any US location. Filter by price range, bedrooms, superhost status, and World Cup 2026 host cities. Returns property listings including non-activated properties for market research.

Search for vacation rentals using a natural language description. Examples: 'romantic beachfront getaway with hot tub', 'family-friendly house with pool near Disney', 'quiet cabin in the mountains for a writers retreat'. Finds matching properties by semantic meaning, not just keywords. Pass the description as 'query'. Optional: threshold (how strict result matching should be) and limit (max results, default 10).

Find vacation rentals similar to a given property. Useful for recommending alternatives when a property is unavailable or when the traveler wants to compare similar options. Pass a property_id (UUID or lilo_code) and optional limit (default 5).

Get the reputation score and performance data for a specific vacation rental property. Returns dispute win rate, protection statistics, host response times, overall reputation score, and a narrative summary. Use this to evaluate a property's track record before recommending it.

Get the machine-readable property identity manifest with structured evidence data, visibility metadata, and verification references. Use this for programmatic property data consumption.

Get the AI-optimized property manifest in schema.org format with lilo extensions. Available in YAML, JSON, or JSON-LD format. Use this for structured data integration and AI agent consumption.

Get the reputation score and verified evidence summary for a vacation rental host. Returns protection stats, evidence count, dispute resolution rate, and verification status. Use this to verify a host's trustworthiness.

Verify the authenticity and integrity of a specific evidence record. Confirms the evidence has not been tampered with, existed at the claimed timestamp, and is independently verifiable. Pass the evidence_id (UUID).

Check whether a vacation rental property is actively protected by lilo. Returns protection status (active/inactive/expired), protection tier, active features, and last activity timestamp.

Get the house rules for a vacation rental in structured, machine-readable format. Returns maximum guests, quiet hours, pet policy, smoking policy, check-in/check-out times, parking, and special restrictions.

Get all frequently asked questions and answers for a vacation rental property. Covers WiFi password, check-in instructions, parking, appliances, emergency contacts, and local info. Filter by category: check_in, check_out, wifi_internet, parking, appliances, emergency, local_info.

Get local recommendations near a vacation rental property. Returns nearby restaurants, coffee shops, grocery stores, activities, and attractions. Filter by type: restaurants, coffee, grocery, activities, attractions.

Ask a natural language question about a vacation rental property and get an answer grounded in verified data. Examples: 'What is the WiFi password?', 'Where do I park?', 'Is there a dishwasher?', 'What time is check-out?'. Requires property_id and the question text.

Create a secure guest verification and check-in link for a confirmed vacation rental booking. Verifies guest identity via phone, presents house rules for acknowledgment, records consent with verified evidence, and provides access codes upon agreement. Returns a unique handshake link.

Book a vacation rental property directly through AI. Host receives 100% of nightly rate; 3% guest service fee added at checkout. Creates booking record, calculates pricing, and notifies the host. Returns booking_id, confirmation_code, pricing breakdown, and check-in link. Always call check_vacation_rental_availability_and_pricing first.

Check real-time availability and pricing for a vacation rental property on specific dates. Returns whether the property is available, calculated total price, capacity check, and any conflicting bookings. Host receives 100% of nightly rate; 3% guest service fee at checkout. Always call this BEFORE book_vacation_rental_direct.

Generate a Google Vacation Rentals XML feed for a host's properties. Enables direct booking via Google Search results with a 3% guest service fee. Pass host_id (UUID) and optional format (xml or json, default xml).

Search for vacation rentals by amenity description using natural language. Examples: 'pool and hot tub', 'pet-friendly with fenced yard', 'EV charger and garage'. Pass the amenity query and optional location filter.

Compare up to 5 vacation rental properties side-by-side on key metrics including price, bedrooms, bathrooms, amenities, reputation score, and protection status. Pass an array of property_ids.

Get neighborhood information for a vacation rental location including safety scores, walkability, public transit access, nearby amenities, and local character. Helps travelers understand the area around a property.

Query the evidence chain for a vacation rental property or specific booking. Returns independently verified evidence records filtered by property_id, booking_id, or event_type. Use this to audit the complete evidence trail.

Verify the integrity and authenticity of a specific evidence anchor record. Confirms the evidence is tamper-proof and independently verifiable. Pass evidence_id (UUID) or evidence_hash.

Generate a complete evidence bundle for dispute resolution on a vacation rental booking. Includes all verified interactions, consent records, and documentation. Pass booking_id (UUID) and dispute_type (chargeback, damage, review, or general).

Generate a chargeback defense packet for a payment dispute on a vacation rental booking. Includes verified evidence of guest consent, check-in documentation, and interaction history. Pass booking_id (UUID), optional dispute_id, and disputed amount in cents.

Record a guest interaction to the vacation rental's evidence chain. Creates a verified evidence record of the interaction. Pass property_id, interaction_type (inquiry, complaint, request, confirmation), content text, and channel (mcp, voice, sms, email). Optional: booking_id.

Get a chronological timeline of all evidence records for a vacation rental property or specific booking. Filter by date range. Returns events in order with timestamps, types, and verification status.

Analyze a vacation rental booking or guest interaction for potential threats and risks. Returns risk assessment level, identified concerns, and recommended actions for the host. Pass booking_id, message_content, and/or guest_profile for analysis.

Pre-booking guest risk assessment for vacation rental hosts. Evaluates guest profile, booking details, and communication patterns to provide a risk level (low/medium/high/critical) with specific recommendations. Helps hosts decide whether to accept a booking request. Pass guest_email, guest_phone, guest_name, message_text, and/or booking_details.

Analyze a guest message or conversation for concerning patterns that may indicate risks to the vacation rental host. Pass the message text and optional conversation_history for context. Returns threat assessment and recommended response.

Analyze guest messages for risk patterns in vacation rental communications. Returns risk assessment, evidence documentation, and response guidance for hosts. More comprehensive than detect_guest_message_threat_pattern — includes documentation and guest/property cross-referencing.

Assess the risk of a guest establishing tenancy rights during an extended vacation rental stay. Evaluates stay duration against jurisdiction-specific tenant protection laws. Returns risk level, relevant state laws, and preventive recommendations. Pass check_in_date, check_out_date, and state code.

Flag a vacation rental booking for enhanced monitoring by lilo's protection system. Creates an alert with the specified reason and risk indicators. Use this when a host identifies concerning behavior. Requires booking_id and reason. Optional: array of risk_indicators.

Predict the probability of a chargeback (payment dispute) for a vacation rental booking. Returns risk score, key risk factors, and specific prevention recommendations. Pass booking_id (UUID), optional amount in cents, and optional guest_profile.

Get competitive pricing analysis for a vacation rental market. Returns comparable property rates, market average, pricing optimization suggestions, and seasonal adjustments. Pass location (required), optional property_id for direct comparison, and optional bedrooms count.

Forecast booking demand for vacation rentals in a specific location over a date range. Returns seasonal trends, event-driven demand spikes (World Cup, holidays, concerts), occupancy predictions, and pricing recommendations. Pass location (required), date_range_start, and date_range_end.

Get local short-term rental (STR) regulations for a specific city and state. Returns permit requirements, occupancy taxes, maximum guest limits, zoning restrictions, and operational requirements. Essential for hosts to understand compliance. Pass state code (required), optional city and property_type.

Check what permits and licenses are required to operate a short-term rental at a specific location. Returns required permits, application processes, fees, and renewal schedules. Pass state code (required), optional city and property_id.

Generate tax documentation for short-term rental income. Includes occupancy tax calculations, income summaries, and reporting data for tax filing. Pass host_id (UUID) and year (required). Optional: quarter (1-4) for quarterly reports.

Check World Cup 2026 specific short-term rental compliance requirements for the 16 US host cities. Returns special regulations, surge pricing rules, enhanced permit requirements, and safety standards that apply during the tournament. Pass the city name (required), optional property_id.

Get insurance requirements and recommendations for short-term rental hosts by state. Returns liability minimums, STR-specific coverage options, and recommended policy limits based on property type and estimated revenue.

Get the inventory list for a vacation rental property. Returns all tracked items with quantities, locations, condition, and recent check history. Filter by category: furniture, appliance, electronics, linen, kitchenware, bathroom, decor, outdoor, safety, amenity, supply.

Report a missing, damaged, or low-stock inventory item at a vacation rental property. Creates an issue record with optional photo evidence. Pass property_id, item_name, and issue_type (missing, damaged, low_stock, needs_replacement). Optional: description, booking_id, photo_url.

Get upcoming and overdue maintenance tasks for a vacation rental property. Includes HVAC filter changes, appliance servicing, pest control, and all recurring maintenance. Pass property_id, optional include_overdue (default true), and days_ahead (default 30).

Create a new maintenance task for a vacation rental property. Supports one-time and recurring tasks. Pass property_id, task_name, and task_type (hvac_filter, deep_clean, appliance_service, pest_control, exterior, safety_check, other). Optional: priority, description, recurring, frequency_days, due_date.

Get the cleaning schedule and cleaner assignments for a vacation rental property. Shows upcoming turnovers between bookings, assigned cleaners, and scheduling gaps. Pass property_id and optional days_ahead (default 14).

Assign a cleaner to a vacation rental property turnover between bookings. Supports primary and backup cleaner assignments. Pass property_id, cleaner_id, booking_id, optional role (primary/backup), and scheduled_date.

Record checkout verification for a vacation rental with checklist completion and photo evidence. Used by cleaners or hosts to document property condition after a guest departure. Pass property_id, booking_id, overall_condition (excellent/good/fair/poor/damaged), optional checklist_items, issues_found, photo_urls, and verified_by.

Search Philadelphia historic properties and landmarks from public records. Useful for World Cup 2026 and America's 250th Anniversary (2026) planning. Filter by type: landmark, historic_religious, african_american, or all.

Get detailed information about a specific Philadelphia landmark including full property manifest and Schema.org structured data. Pass landmark_id (e.g., phl-landmark-123) and source type (landmark, religious, aahs).

Search Philadelphia event and wedding venues. Returns venue details including capacity, type, availability, and booking information. Filter by venue_type (wedding, event, historic, all) and minimum capacity.

PREMIUM: Full Philadelphia data ingestion from public records. Ingests landmarks, historic religious properties, and African American historic sites into the lilo system. Pass source: all, landmarks, religious, or aahs.

Access the continuously maintained trust certificate for a lilo-protected vacation rental property. Includes verification data for independent validation of the property's protection status, evidence integrity, and host reputation. Pass lilo_code (e.g. PROP-6408).

Independently verify a specific evidence record in a vacation rental property's trust chain. Confirms the evidence has been independently verified and is tamper-proof. Pass lilo_code (e.g. PROP-6408) and envelope_hash of the evidence record to verify.

Analyze a guest interaction at a vacation rental for potential risks. Returns risk assessment and recommended actions. Alias for analyze_booking_threat_risk. Pass booking_id, message_content, and/or guest_profile.

Analyze guest messages at a vacation rental for concerning patterns. Returns risk assessment, evidence documentation, and response guidance for hosts. Alias for detect_guest_communication_risk.

Generate a dispute defense packet with independently verified evidence for a vacation rental payment dispute. Alias for get_chargeback_defense_for_booking.

Assess risk factors for a specific vacation rental booking with protection recommendations. Returns risk level, identified concerns, and suggested protective actions. Pass booking_id (UUID) and optional include_guest_risk (default true).

Check onboarding progress for a vacation rental property on lilo. Returns which setup steps are complete and which are still needed (property details, photos, house rules, calendar sync, payment setup, etc.). Pass lilo_code (e.g. PROP-6408) or property_id (UUID).

Search for vacation rental properties with structured filtering. Returns results optimized for AI deep research with id, title, url, snippet, pricing, and property attributes. Use this for broad property discovery. Supports filtering by city, state, bedrooms, price, and pet-friendliness.

Fetch complete details for a specific vacation rental property by its lilo code (e.g. PROP-2343). Returns full property data including title, description as markdown text, photos, reviews, amenities, trust score, and booking URL. Optimized for AI deep research consumption.

Search for vacation rentals in FIFA World Cup 2026 host cities. Returns properties with stadium proximity information, match schedules, and expected demand surge data. Use this when a traveler is looking for accommodation for World Cup 2026 matches. Supports 11 US host cities: Miami, New York, Los Angeles, Dallas, Philadelphia, Atlanta, Houston, Seattle, San Francisco, Boston, Kansas City.