@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