How to Connect Immobilienscout24 to Gemini — via MCP

Connect ImmobilienScout24 to Gemini

ImmobilienScout24 is Germany's largest real estate portal. With AnythingMCP, Gemini searches its listings through the official ImmobilienScout24 REST API: you describe what you are looking for, Gemini finds the area code, runs the search and reads the exposés for you.

The connector has three read-only tools for public listing search. It does not manage your own listings or leads (see the FAQ below).

What you can ask Gemini

• "Find 2-room apartments to rent in Berlin Mitte for at most €1,200 a month." Uses is24_search_locations to get the GeoCode for Berlin Mitte, then is24_search_properties with type apartmentrent, price_max 1200 and numberofrooms_min 2.
• "Look up the GeoCode for Hamburg Altona." Uses is24_search_locations.
• "Houses for sale in Freiburg with at least 120 m² of living space, up to €750,000." Uses is24_search_locations, then is24_search_properties with type housebuy, livingspace_min and price_max.
• "Show me exposé 123456789 in full: description, features, energy certificate, contact." Uses is24_get_property.
• "Office space to rent in München Schwabing, show me the second page of results." Uses is24_search_properties with type office and pagenumber 2.
• "From those results, rank the five cheapest per square metre." Gemini works this out from the search results it already has.

What you need

• An ImmobilienScout24 business account. ImmobilienScout24 grants API access only to business accounts; private accounts cannot get it.
• An API key set from the IS24 self-service portal. The key goes into IS24_CONSUMER_KEY, the secret into IS24_CONSUMER_SECRET.
• The right environment. You can generate keys for the sandbox (free, for testing, with anonymised test data) and for production (live listings). The connector calls the production API by default.
• For production: you accept the API Terms of Use, usage is charged according to ImmobilienScout24's price list, and some use cases need partner approval first, which is not instant.

ImmobilienScout24 still uses OAuth 1.0a, where every request has to be signed. AnythingMCP signs each call with your key pair (two-legged, app-only), so there is no token to exchange or refresh.

Step 1 — Get your IS24 credentials

1. Go to the IS24 self-service portal.
2. Log in with, or create, an ImmobilienScout24 business account.
3. Generate an API key set: sandbox for testing and/or production for live data.
4. Copy the API key and the secret.

Step 2 — Install the connector

On AnythingMCP Cloud, open Connectors, pick ImmobilienScout24 API and paste the key into IS24_CONSUMER_KEY and the secret into IS24_CONSUMER_SECRET.

To self-host instead, start AnythingMCP with Docker, then install the connector from http://localhost:3000/connectors/store:

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Step 3 — Add it to Gemini

Your server URL: in AnythingMCP, open MCP Servers → the server this connector is on, and copy its URL (https://cloud.anythingmcp.com/mcp/…). Use it wherever this guide shows YOUR_SERVER_ID.

Gemini CLI reads MCP servers from ~/.gemini/settings.json (on Windows %USERPROFILE%\.gemini\settings.json). Add:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Create an MCP API key in AnythingMCP under MCP Servers → your server → API keys, and paste it in place of YOUR_MCP_API_KEY.
2. Save the file and restart gemini.
3. Run /mcp inside Gemini CLI (or gemini mcp list in your shell) — anythingmcp should show as connected.
4. Start prompting — Gemini CLI can now call the ImmobilienScout24 tools.

Available Tools

Troubleshooting

• Every call is rejected straight away. Sandbox keys only work against the sandbox, and the connector calls the production API. Use production keys, or change the connector's base URL to https://rest.sandbox-immobilienscout24.de/restapi/api while you test. Also check that key and secret are not swapped: the signature is built from both.
• Production keys exist, but calls are still refused. Some use cases need partner approval before ImmobilienScout24 opens production access. Check the status of your key set in the self-service portal.
• The search finds nothing, or the wrong town. is24_search_properties needs a GeoCode, not a place name. Ask Gemini to resolve the place with is24_search_locations first, and pick the right entry if several places share a name.
• Too many requests at once. ImmobilienScout24 limits how often each key may call the API (see Rate Limiting in its developer portal). Ask for fewer result pages in one go.

FAQ

Can Gemini manage my own listings or leads on ImmobilienScout24? No. The connector signs requests app-only (two-legged), which covers public listing search and exposé lookup. Acting on your own objects or leads needs user-context access, which this connector does not expose.

Is it free? AnythingMCP is open source under AGPL-3.0, so self-hosting is free, including commercial use inside your own company. AnythingMCP Cloud comes with a 7-day free trial. On the ImmobilienScout24 side, sandbox keys are free, and production use is charged according to ImmobilienScout24's price list.

Is my data stored by AnythingMCP? Your IS24 key and secret are stored encrypted (AES-256-GCM) in your workspace and are never shown to Gemini. When Gemini uses a tool, AnythingMCP calls ImmobilienScout24 and passes the result to Gemini, and the call is recorded in your workspace's audit log. AnythingMCP Cloud is hosted in Frankfurt, Germany.

Where does Gemini CLI look for MCP servers? In ~/.gemini/settings.json for your user, or in .gemini/settings.json inside a project. gemini mcp list shows each server and whether it connects.

Next steps

• ImmobilienScout24 MCP server for other AI clients
• Connect ImmobilienScout24 to Claude
• Connect ImmobilienScout24 to ChatGPT
• Connect ImmobilienScout24 to Cursor
• Connect ImmobilienScout24 to Meta Muse