MCP.so
Sign In

FlatHunt MCP ServerVerifiedFeatured

@FlatHunt

Basic information

Transport

Streamable HTTP

Authentication

OAuth

Last updated

Category

Search

Author

FlatHunt

Submitted by

Mikhail Mikhalev

About FlatHunt MCP Server

Search and compare furnished apartments, studios and rooms in Berlin across multiple housing providers. FlatHunt supports filtering by budget, location, move-in date, rental duration, property type, size, amenities and rental requirements, with listing details, comparisons, favorites and saved-search alerts.

#berlin#housing#apartments#rooms#rentals#furnished#real-estate#search

Connection details

https://mcp.flat-hunt.com/mcp

Setup

claude mcp add flathunt --transport http https://mcp.flat-hunt.com/mcp

FlatHunt MCP Server tools

12

Search current furnished apartments, studios, private rooms and shared rooms through FlatHunt in any covered European city: pass `city` from list_cities (omit it for Berlin, the default). Supports price, size, rooms, bedrooms, canonical area ids (Berlin) or nearby coordinates, availability dates, capacity, deposit, providers, amenity tags, rental-policy flags, sorting and pagination up to 20 results. Returns normalized listing summaries and pagination metadata. Availability, prices and provider terms may change.

Get detailed information about a single FlatHunt listing by its numeric id (any city). Returns its description, amenities, rental-policy flags, capacity, stay terms, utilities, nearby distances, media, provider and tracking URLs. Availability and provider terms may change.

Return normalized detail fields for 2–10 FlatHunt listings by numeric id in one read-only response. Includes prices, location, amenities, rental-policy flags, capacity, description, utilities, nearby distances, provider and tracking URLs for side-by-side comparison.

List the cities FlatHunt covers across Europe (70+: Berlin, Lisbon, Milan, Madrid, Barcelona, Paris …) with the canonical `city` id to pass to search_listings and create_alert, country, currency, how many listings are live, and whether district polygons (list_areas) exist for it. Berlin is the default city: omit `city` for Berlin. Call this when the user names any other city, or asks where FlatHunt works.

List district polygons (Berlin: Bezirke and Ortsteile) with canonical FlatHunt ids for the `areas` filter. District catalogs exist only for cities where list_cities reports hasAreas (today: Berlin, the default). For other cities search by city, post code or lat/lng/radiusKm. Returns id, name, slug, type and parent area information, with optional name and type filtering. Mitte exists both as a whole Bezirk (berlin:bezirk:mitte) and as a smaller Ortsteil (berlin:ortsteil:mitte). Charlottenburg is an Ortsteil; the parent Bezirk is Charlottenburg-Wilmersdorf.

Return UI-ready cards and an interactive MCP Apps gallery for 1–10 FlatHunt listing ids. The tool refreshes current listing data and displays images, provider, price, availability and listing actions. Optional alertCriteria adds a saved-search control for the represented filters.

List the current user's saved search alerts on FlatHunt, including each alert's numeric id, name and creation time when available. Requires alerts.read.

Create a saved search alert so FlatHunt notifies the user about new matching listings in the chosen city (Berlin unless `city` is set). Accepts housing, price, size, rooms, availability, canonical area ids, amenity and rental-policy filters. Email notifications are enabled by default; Telegram too when the user has linked Telegram on FlatHunt. Requires the alerts.write scope.

Delete one or more of the current user's saved search alerts by numeric id. This is destructive and cannot be undone. Accepts 1–10 ids per call and requires alerts.write.

List the current user's saved (favorited) FlatHunt listings. Requires the favorites.read scope.

Save (favorite) a FlatHunt listing for the current user by its numeric id. Requires the favorites.write scope. Ownership and duplicate handling are enforced by FlatHunt.

Remove a listing from the current user's saved (favorited) listings by its numeric id. Requires the favorites.write scope.

Overview

What is FlatHunt?

FlatHunt is a Berlin housing search platform that brings furnished apartments, studios, private rooms and shared rooms from multiple accommodation providers into one search.

The FlatHunt MCP server allows compatible AI assistants to search and compare current Berlin housing inventory directly in conversation.

What can it do?

  • Search furnished apartments, studios and rooms in Berlin
  • Filter by monthly budget, location, move-in date and rental duration
  • Search by district, neighbourhood or nearby location
  • Filter by size, room count, amenities and deposit
  • Check requirements such as Anmeldung, Schufa, student eligibility and pet policies
  • Retrieve detailed information about individual listings
  • Compare multiple listings side by side
  • Save listings to favorites
  • Create and manage saved-search alerts

Example prompts

  • "Find furnished studios in Berlin under €1,400 per month from November."
  • "Find private rooms in Mitte under €900."
  • "Show me apartments in Friedrichshain with Anmeldung for a couple."
  • "Compare the top three listings by price, size and availability."
  • "Save this apartment and create an alert for similar listings."

Authentication

Public housing search, listing details and comparisons can be used without a FlatHunt account.

Authentication is required for account-specific features such as favorites and saved-search alerts. FlatHunt uses OAuth for these features.

MCP endpoint

https://mcp.flat-hunt.com/mcp

Documentation

https://flat-hunt.com/mcp

About FlatHunt

FlatHunt helps people discover and compare furnished housing in Berlin across multiple housing providers.

FlatHunt does not act as a landlord or booking provider. Availability, pricing and provider terms may change, and applications, contracts and payments are completed with the relevant accommodation provider.

Website: https://flat-hunt.com

Frequently asked questions

1

What is the FlatHunt remote MCP server?

The FlatHunt remote MCP server is a hosted Model Context Protocol endpoint at https://mcp.flat-hunt.com/mcp, so AI assistants can connect to it without installing or running anything locally.

2

How do I connect to the FlatHunt MCP server?

Add the endpoint https://mcp.flat-hunt.com/mcp to any MCP-compatible client such as Claude Code, Cursor, or VS Code. The setup snippets on this page configure each client in one step.

3

Does the FlatHunt MCP server require authentication?

Yes. FlatHunt uses OAuth: the first time you connect, your MCP client opens a browser window to sign in and authorize access, then reuses the credentials for future sessions.

4

Which transport does the FlatHunt MCP server use?

FlatHunt exposes a Streamable HTTP endpoint, the transport used by remote MCP servers and supported by all major MCP clients.

Comments