MCP MeasureMCP Measure

index observed

Socials Homes

Find a rental home in a new city: supported cities, plans, live listing counts and a signup link.

Should I use this

Quality & Safety

A
Description quality
100%
Schema completeness
80%
Naming quality
100%
Poisoning risk
100%
Permission match
100%
Protocol compliance
100%

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~1,864Tokens (tool definitions)
~4.2 KBTypical response size
Moderate attention impact (1.46% of 128k context)

This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.

Install

One-Click Install

Add this to your `claude_desktop_config.json` file:

{
  "mcpServers": {
    "socials-homes": {
      "url": "https://www.socials.homes/mcp"
    }
  }
}

Remote endpoints

https://www.socials.homes/mcpstreamable-http

What it can do

Tool inventory

Tools (4)

🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢list_cities(country)

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.

Input Schema

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

Output Schema

{
  "type": "object",
  "properties": {
    "count": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "countries": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "cities": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "slug": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "country": {
            "type": "string"
          },
          "country_name": {
            "type": "string"
          }
        },
        "required": [
          "slug",
          "name",
          "country",
          "country_name"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "count",
    "countries",
    "cities"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}
🟢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.

Input Schema

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

Output Schema

{
  "type": "object",
  "properties": {
    "currency": {
      "type": "string",
      "const": "EUR"
    },
    "prices_note": {
      "type": "string"
    },
    "plans": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "path": {
            "type": "string",
            "enum": [
              "on_your_own",
              "with_an_expert"
            ]
          },
          "currency": {
            "type": "string",
            "const": "EUR"
          },
          "price_eur": {
            "type": "number"
          },
          "billing": {
            "type": "string"
          },
          "billing_interval": {
            "type": "string"
          },
          "auto_renews": {
            "type": "boolean"
          },
          "renewal_price_eur": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "renews_every": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ]
          },
          "per_month_eur": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ]
          },
          "includes": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "guarantee": {
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "summary": {
                    "type": "string"
                  },
                  "url": {
                    "type": "string"
                  }
                },
                "required": [
                  "summary",
                  "url"
                ],
                "additionalProperties": false
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "id",
          "name",
          "path",
          "currency",
          "price_eur",
          "billing",
          "billing_interval",
          "auto_renews",
          "renewal_price_eur",
          "renews_every",
          "per_month_eur",
          "includes",
          "guarantee"
        ],
        "additionalProperties": false
      }
    },
    "cancellation": {
      "type": "string"
    },
    "refunds": {
      "type": "string"
    },
    "vip_guarantee": {
      "type": "object",
      "properties": {
        "summary": {
          "type": "string"
        },
        "conditions": {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "how_to_claim": {
          "type": "string"
        },
        "url": {
          "type": "string"
        }
      },
      "required": [
        "summary",
        "conditions",
        "how_to_claim",
        "url"
      ],
      "additionalProperties": false
    },
    "pricing_url": {
      "type": "string"
    },
    "terms_url": {
      "type": "string"
    }
  },
  "required": [
    "currency",
    "prices_note",
    "plans",
    "cancellation",
    "refunds",
    "vip_guarantee",
    "pricing_url",
    "terms_url"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}
🟢check_city_supply(city, budget_max_eur)

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.

Input Schema

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

Output Schema

{
  "type": "object",
  "properties": {
    "city": {
      "type": "object",
      "properties": {
        "slug": {
          "type": "string"
        },
        "name": {
          "type": "string"
        },
        "country": {
          "type": "string"
        },
        "country_name": {
          "type": "string"
        }
      },
      "required": [
        "slug",
        "name",
        "country",
        "country_name"
      ],
      "additionalProperties": false
    },
    "supply": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "available": {
              "type": "boolean",
              "const": true
            },
            "live_listings": {
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991
            },
            "budget_max_eur": {
              "anyOf": [
                {
                  "type": "integer",
                  "minimum": -9007199254740991,
                  "maximum": 9007199254740991
                },
                {
                  "type": "null"
                }
              ]
            },
            "listings_within_budget": {
              "anyOf": [
                {
                  "type": "integer",
                  "minimum": -9007199254740991,
                  "maximum": 9007199254740991
                },
                {
                  "type": "null"
                }
              ]
            },
            "level": {
              "anyOf": [
                {
                  "type": "string",
                  "enum": [
                    "critical",
                    "low",
                    "ok"
                  ]
                },
                {
                  "type": "null"
                }
              ]
            },
            "suggested_budget_eur": {
              "anyOf": [
                {
                  "type": "integer",
                  "minimum": -9007199254740991,
                  "maximum": 9007199254740991
                },
                {
                  "type": "null"
                }
              ]
            }
          },
          "required": [
            "available",
            "live_listings",
            "budget_max_eur",
            "listings_within_budget",
            "level",
            "suggested_budget_eur"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "available": {
              "type": "boolean",
              "const": false
            },
            "reason": {
              "type": "string"
            }
          },
          "required": [
            "available",
            "reason"
          ],
          "additionalProperties": false
        }
      ]
    },
    "signup_url": {
      "type": "string"
    }
  },
  "required": [
    "city",
    "supply",
    "signup_url"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}
🟢start_home_search(city, budget_max_eur, move_in)

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.

Input Schema

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

Output Schema

{
  "type": "object",
  "properties": {
    "city": {
      "type": "object",
      "properties": {
        "slug": {
          "type": "string"
        },
        "name": {
          "type": "string"
        },
        "country": {
          "type": "string"
        },
        "country_name": {
          "type": "string"
        }
      },
      "required": [
        "slug",
        "name",
        "country",
        "country_name"
      ],
      "additionalProperties": false
    },
    "signup_url": {
      "type": "string"
    },
    "budget_max_eur": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        {
          "type": "null"
        }
      ]
    },
    "move_in": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "supply": {
      "type": "null"
    },
    "next_steps": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "writes_nothing": {
      "type": "boolean",
      "const": true
    }
  },
  "required": [
    "city",
    "signup_url",
    "budget_max_eur",
    "move_in",
    "supply",
    "next_steps",
    "writes_nothing"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

Community

Rate this Server

Evidence

Recent observations

verifiedversion not recorded4 tools