How to Connect ImmobilienScout24 to Claude for AI-Powered Property Search

Connect ImmobilienScout24 to Claude

ImmobilienScout24 is Germany's largest real estate portal. With AnythingMCP, Claude searches its listings through the official ImmobilienScout24 REST API: you describe what you are looking for, Claude 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 Claude

• "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." Claude 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 Claude

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.

On claude.ai (the connector then also appears in Claude Desktop):

1. Open claude.ai/customize/connectors.
2. Click +, then Add custom connector.
3. Name it AnythingMCP and enter the URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.
4. Click Add, then Connect. Sign in to AnythingMCP and choose which of your MCP servers Claude may use.

In Claude Code, run the command below, then type /mcp in a session and choose Authenticate:

claude mcp add --transport http anythingmcp https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID

Self-hosting? Use your own AnythingMCP URL instead of cloud.anythingmcp.com. For claude.ai it has to be reachable from the internet, because Claude connects from Anthropic's servers, not from your computer.

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 Claude 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 Claude 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.

Does it work in Claude Desktop and Claude Code? Yes. A custom connector you add on claude.ai is also available in Claude Desktop, and Claude Code adds the same URL with claude mcp add --transport http. Custom connectors are available on every Claude plan; the Free plan allows one, which is enough because a single AnythingMCP connector carries all your connectors.

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 Claude. When Claude uses a tool, AnythingMCP calls ImmobilienScout24 and passes the result to Claude, and the call is recorded in your workspace's audit log. AnythingMCP Cloud is hosted in Frankfurt, Germany.

Next steps

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