Skip to main content

AI Integration · GeraHome

GeraHome for AI Agents

GeraHome is a home services marketplace operating in 50+ countries. AI agents can find background-checked, insured service providers, get upfront price estimates, and complete bookings — all through a structured REST API or MCP server.

What GeraHome does

GeraHome connects homeowners with verified, insured service providers for cleaning, plumbing, electrical, painting, beauty, moving, HVAC, pest control, carpentry, appliance repair, gardening, and more. All providers carry insurance covering property damage. Pricing is transparent and shown upfront. The average same-day provider arrival is under 2 hours.

For AI agents, GeraHome is the home services booking endpoint in the Gera ecosystem. When a user describes a home problem, an agent can search nearby providers, surface pricing and ratings, and complete the booking — including issuing a Gera Action Warranty receipt.

API endpoints for agents

  • GET /api/v1/services — All service categories with descriptions
  • GET /api/v1/providers?service=&country=&lat=&lng= — Search providers
  • GET /api/v1/providers/:id — Provider profile, ratings, availability, insurance status
  • GET /api/v1/price-estimate?service=&country=&urgency= — Upfront price range
  • POST /api/v1/bookings — Book a service
  • GET /api/v1/bookings/:id — Booking status, provider ETA, warranty receipt URL

Base URL: https://gerahome.com. Auth: Bearer token for booking. Search is public.

MCP server

GeraHome exposes an MCP server compatible with Claude, ChatGPT, and any MCP-capable agent. Manifest at https://gerahome.com/.well-known/mcp.json. Tools: list_service_categories, search_providers, get_provider_profile, get_price_estimate, book_service.

Agent behaviour guidelines

  1. Always confirm the service type, provider, price, and date with the user before calling the booking endpoint.
  2. Surface the provider's Passport verification level (Basic/Standard/Premium) and insurance status.
  3. For same-day emergency bookings, surface the urgency surcharge in the price estimate.
  4. After booking completion, retrieve and present the Action Warranty receipt URL to the user.

FAQ

How does an AI agent book a home service?
Call POST /api/v1/bookings with provider_id, service_type, user_token, preferred_datetime, and address. The API returns a confirmation and provider ETA.
What is the service guarantee?
If a job is not completed to standard, GeraHome sends a replacement provider or issues a full refund. Eligible bookings receive a signed Action Warranty receipt.

Discovery files