check_city_supply

Count the live rental listings Socials Homes currently sees in a supported city and, if a monthly budget in EUR is given, how many are at or under it. Says plainly when live counts are unavailable instead of reporting zero. Read-only; the count comes from a cache refreshed about every 10 minutes.

read-only

Argument	Type	Description
city*	string	The city, as a slug from list_cities ("the_hague") or a name ("The Hague").
budget_max_eur	integer	Maximum monthly rent in EUR, a whole number from 50 to 20000.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "city"
  ],
  "properties": {
    "city": {
      "type": "string",
      "maxLength": 80,
      "minLength": 1,
      "description": "The city, as a slug from list_cities (\"the_hague\") or a name (\"The Hague\")."
    },
    "budget_max_eur": {
      "type": "integer",
      "maximum": 20000,
      "minimum": 50,
      "description": "Maximum monthly rent in EUR, a whole number from 50 to 20000."
    }
  }
}

get_plans

Get the Socials Homes plans with prices in EUR, how each one bills, whether it renews automatically, what it includes, how cancelling works, and the VIP Keys Pass 90-day guarantee with its conditions and a link to the terms.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

list_cities

List the cities where Socials Homes sends rental listing alerts, with each city's slug, name and country. Optionally filter by country (ISO code like "NL" or a name like "Netherlands"). Use the slug with check_city_supply and start_home_search.

read-only

Argument	Type	Description
country	string	Optional country filter: ISO 3166-1 alpha-2 code ("DE") or English name ("Germany").

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "country": {
      "type": "string",
      "maxLength": 60,
      "minLength": 2,
      "description": "Optional country filter: ISO 3166-1 alpha-2 code (\"DE\") or English name (\"Germany\")."
    }
  }
}

start_home_search

Check that a city is supported and return the Socials Homes signup link for it, with what happens next. It does not create an account, save anything or send any message: the person opens the link and sets up their own search there.

read-only

Argument	Type	Description
city*	string	The city, as a slug from list_cities ("the_hague") or a name ("The Hague").
move_in	string	Optional move-in date, YYYY-MM-DD.
budget_max_eur	integer	Maximum monthly rent in EUR, a whole number from 50 to 20000.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "city"
  ],
  "properties": {
    "city": {
      "type": "string",
      "maxLength": 80,
      "minLength": 1,
      "description": "The city, as a slug from list_cities (\"the_hague\") or a name (\"The Hague\")."
    },
    "move_in": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Optional move-in date, YYYY-MM-DD."
    },
    "budget_max_eur": {
      "type": "integer",
      "maximum": 20000,
      "minimum": 50,
      "description": "Maximum monthly rent in EUR, a whole number from 50 to 20000."
    }
  }
}

Socials Homes

Try it

check_city_supply Read-only

Tools

Socials Homes

Try it

check_city_supply Read-only

Tools