@gera-services/mcp-gera-home

@gera-services/mcp-gera-home

MCP (Model Context Protocol) server for GeraHome -- the home services marketplace by Gera Services.

Enables AI assistants (Claude, ChatGPT, etc.) to search service providers, get price estimates, and book home services like cleaning, plumbing, electrical, beauty, and moving across 50+ countries.

Tools

Tool	Description	Auth Required
list_service_categories	List all available service categories (cleaning, plumbing, etc.)	No
search_providers	Search providers by category, location, availability, and rating	No
get_provider_profile	Get detailed provider profile (services, pricing, reviews)	No
get_featured_providers	Get top-rated, verified providers	No
get_price_estimate	Get estimated price range for a service job	No
get_provider_slots	Get available time slots for a provider on a given date	No
book_service	Book a home service with a provider	Yes

Installation

npm install @gera-services/mcp-gera-home

Usage

With Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "gera-home": {
      "command": "npx",
      "args": ["@gera-services/mcp-gera-home"]
    }
  }
}

With a custom API endpoint

{
  "mcpServers": {
    "gera-home": {
      "command": "npx",
      "args": ["@gera-services/mcp-gera-home"],
      "env": {
        "GERAHOME_API_URL": "https://your-api-url.example.com"
      }
    }
  }
}

Standalone

npx @gera-services/mcp-gera-home

Configuration

Environment Variable	Description	Default
GERAHOME_API_URL	Base URL for the GeraHome API	https://api.gerahome.com

Multi-Country Support

GeraHome operates across 50+ countries. Pass a country code (ISO 3166-1 alpha-2) to any tool to scope results to that country. Supports proximity search via latitude/longitude and city-based filtering.

Authentication

Browse and search tools work without authentication. Booking requires a user bearer token passed via the auth_token parameter.

License

MIT