Une façon plus simple de chercher

Cherchez des logements au Luxembourg depuis ChatGPT ou Claude

Retrouvez les annonces, données de marché et sources dans l’assistant que vous utilisez déjà.

ChatGPT

Les apps MCP personnalisées exigent le mode développeur ; leur disponibilité dépend de l’offre ChatGPT et des droits de l’espace de travail.

Claude

Ajoutez le connecteur distant dans Personnaliser → Connecteurs ; le propriétaire de l’organisation devra parfois l’ajouter d’abord.

MCP

Ajoutez le connecteur ChatHome depuis les intégrations de votre assistant. La disponibilité et les menus varient selon le client et l’offre.

https://chathome.lu/api/mcp

MCP Server · Streamable HTTP · 2025-11-25

chathome MCP

Connect Claude, Cursor, or ChatGPT to live listings across the Grande Région and Luxembourg-specific market intelligence. Search rentals, browse listings for sale, and pull commune data straight from your AI assistant.

MCP Server URL

https://chathome.lu/api/mcp

Authentication

Two methods supported — OAuth 2.1 is recommended for personal use.

AOAuth 2.1 with PKCERecommended

Your MCP client handles the OAuth flow automatically — no Client ID or secret to enter. This server uses public clients + PKCE with dynamic client registration (RFC 7591): your client registers itself the first time it connects.

Claude Code CLI — paste into ~/.claude/claude_code_config.json

json

{
  "mcpServers": {
    "chathome": {
      "type": "http",
      "url": "https://chathome.lu/api/mcp"
    }
  }
}

How the flow works

1Paste the MCP URL into your AI client — no Client ID or secret needed.
2The client opens a browser to chathome.lu where you log in and approve access.
3Tokens are issued automatically — the client stores them and refreshes as needed.

BAPI KeyFor automation / scripts

Generate a key at Dashboard → Agent Access, then pass it as an X-API-Key header. Keys are prefixed cht_.

json

{
  "mcpServers": {
    "chathome": {
      "type": "http",
      "url": "https://chathome.lu/api/mcp",
      "headers": {
        "X-API-Key": "cht_YOUR_KEY_HERE"
      }
    }
  }
}

Rate limits

·200 tool calls / hour per user
·300 calls / hour per IP
·Tokens expire after 1 hour (OAuth auto-refreshes)

Available Tools

14 tools covering rental search, for-sale search, listing detail, market data, price estimation, commute times, and listing inquiries.

Response Shapes

Each tool returns a typed JSON object. Search tools wrap listings in an array; inquiry tools return their own shapes.

search_rentals · search_for_sale

typescript

{ listings: AgentListing[]; total: number; truncated?: true }

get_listing

typescript

{ listing: AgentListing }

AgentListing type

typescript

type AgentListing = {
  id: string;
  url: string;
  title: string;
  price: number | null;
  currency: "EUR";
  listingType: "rent" | "sale";
  propertyType: string | null;
  city: string | null;
  district: string | null;
  beds: number | null;
  baths: number | null;
  areaSqm: number | null;
  energyClass: string | null;
  imageUrl: string | null;
  agencyName: string | null;
  latitude: number | null;
  longitude: number | null;
  // True when at least one factual field has source evidence.
  hasSourceCheckedFacts?: boolean;
};

get_market_context · get_price_estimate · get_commute_times

typescript

// Each returns a tool-specific JSON object, e.g.:
// get_price_estimate → { estimatedPrice, low, high, confidence, comparables, … }
// get_commute_times  → { commune, destination, mode, durationMinutes, … }
// get_market_context → { commune, medianRentEur, walkabilityScore, … }

submit_inquiry

typescript

type McpInquiryResult =
  | { kind: "conversation_created"; conversationId: string; listingId: string }
  | { kind: "external_agency"; agencyName: string | null; phone: string | null;
      email: string | null; website: string | null };

get_inquiry_status

typescript

{
  conversationId: string;
  status: "awaiting_reply" | "replied";
  messages: { from: "you" | "agent"; text: string }[];
}

Resources & Prompts

The server also exposes one resource template and two built-in prompts.

Resource

chathome://listing/{id}

Read a single listing by ID — same data as get_listing, exposed as an MCP resource URI.

Prompt · find-family-home

Guided search for family-friendly rental properties. Arguments: commune?, budget?, beds?.

Prompt · compare-communes

Side-by-side comparison of two Luxembourg communes. Arguments: commune_a, commune_b, locale?.

Try It

Once connected, ask your AI assistant:

“Find me 2-bedroom apartments in Luxembourg-Ville under €2,000/month”
“What are houses for sale in Strassen with a garden?”
“Compare liveability scores for Esch-sur-Alzette and Differdange”
“Show me the full details for listing ID abc-123”

Claude Agent Skill

A packaged skill that teaches Claude how to use chathome well — tool selection, Grande Région search workflows, and Luxembourg market context.

claude.ai & Claude Desktop

Download the zip, then upload it under Settings → Capabilities → Skills. Pair it with this MCP server added as a custom connector.

Download skill (.zip)

Claude Code — one-step plugin (skill + MCP server)

bash

/plugin marketplace add chathome-lu/chathome-claude-plugin
/plugin install chathome@chathome

Agents & other runtimes

The skill follows the open Agent Skills standard. Fetch it raw at /skills/chathome/SKILL.md.

Roadmap

What's live now and what's coming next.

Live

MCP v1 — 14 tools, 1 resource, 3 prompts over Streamable HTTP with OAuth 2.1 + PKCE and API-key auth.

Live

A2A Agent Card — /.well-known/agent-card.json for Google A2A protocol discovery (task endpoint /api/a2a).

Live

Agent Skill — downloadable Claude skill bundling chathome workflows, paired with this MCP server.

llms.txt OAuth discovery Generate API key chathome.lu

type AgentListing = { id: string; url: string; title: string; price: number | null; currency: "EUR"; listingType: "rent" | "sale"; propertyType: string | null; city: string | null; district: string | null; beds: number | null; baths: number | null; areaSqm: number | null; energyClass: string | null; imageUrl: string | null; agencyName: string | null; latitude: number | null; longitude: number | null; // True when at least one factual field has source evidence. hasSourceCheckedFacts?: boolean; };

// Each returns a tool-specific JSON object, e.g.: // get_price_estimate → { estimatedPrice, low, high, confidence, comparables, … } // get_commute_times → { commune, destination, mode, durationMinutes, … } // get_market_context → { commune, medianRentEur, walkabilityScore, … }

type McpInquiryResult = | { kind: "conversation_created"; conversationId: string; listingId: string } | { kind: "external_agency"; agencyName: string | null; phone: string | null; email: string | null; website: string | null };