Le serveur MCP de flatin.es pour les agents IA

flatin.es propose un serveur public du Model Context Protocol (MCP) : un assistant IA — Claude, ChatGPT, Cursor ou un autre — peut interroger directement notre catalogue de logements neufs, nos calculateurs et les données locales, au lieu de deviner ou de lire des pages périmées. C’est gratuit, sans inscription ni clé.

Chaque réponse indique la source et la date de chaque chiffre et le lien vers la page de flatin.es où tout est affiché : l’assistant peut la citer et vous pouvez vérifier.

Ce qu’il sait répondre

Programmes neufs en vente dans une commune, une province ou une zone d’achat (Costa Blanca, Costa del Sol) : nom, promoteur, prix à partir de, chambres, livraison et date de lecture du site du promoteur.
Frais d’achat d’un logement partout en Espagne : TVA et droit de timbre dans le neuf ou droits de mutation dans l’ancien selon le territoire fiscal, plus notaire et registre selon les barèmes officiels — comme notre calculateur de frais d’achat.
Impôt des non-résidents (IRNR, modelo 210) d’un propriétaire : revenu imputé et loyers, UE/EEE ou non — comme le calculateur du modelo 210.
Comparer 2 à 4 lieux sur données publiques : prix des logements, loyers, IBI, population, revenus, locations touristiques, étrangers et plus, chaque chiffre avec sa période et sa source.
Taux de l’IBI d’une commune, avec l’année et la source (ministère des Finances) — le jeu de données IBI.

Couverture : le catalogue du neuf couvre Costa Blanca et Costa del Sol ; les données locales et les comparaisons, les communes des provinces de Alicante, Málaga, Valencia et Murcia. Les frais d’achat sont calculés pour toute l’Espagne et l’IRNR ne dépend pas du lieu. Hors de cette couverture, l’outil le dit au lieu d’inventer.

Outils

newbuilds_in_place: Programmes neufs en vente dans une commune, une zone ou une province (jusqu’à 25 par appel, avec lien vers la liste complète).
ibi_rate: Taux annuel de l’IBI urbain d’une commune, avec année et source.
compare_places: Derniers chiffres de 2 à 4 lieux côte à côte, chacun avec unité, période et source.
purchase_costs: Impôts et frais d’achat d’un logement en Espagne selon le prix, le lieu et le type (neuf ou ancien).
non_resident_tax: IRNR annuel (modelo 210) d’un propriétaire non résident.

Exemples de questions

Quels programmes neufs sont en vente à Torrevieja, et à partir de quel prix ?
Combien d’impôts et de frais pour un appartement neuf de 250 000 € à Málaga ?
Compare Orihuela, Torrevieja et Santa Pola : prix des logements, loyers et IBI.
J’habite en Belgique et je possède un appartement en Espagne d’une valeur cadastrale de 80 000 €, révisée il y a moins de dix ans, non loué : combien d’IRNR par an ?
Quel est le taux de l’IBI à Benidorm ?

Comment le connecter

Adresse du serveur et transport Streamable HTTP (JSON-RPC en POST, sans session). Aucune connexion n’est nécessaire : choisissez « sans authentification » si le client le demande.

https://flatin.es/mcp

MCP 2025-06-18, 2025-11-25

Claude Code

Dans le terminal :

claude mcp add --transport http flatin https://flatin.es/mcp

Claude (claude.ai, Desktop)

Customize → Connectors → Add custom connector, avec cette URL et sans authentification. Avec les offres Team et Enterprise, c’est un administrateur de l’organisation qui l’ajoute.

https://flatin.es/mcp

ChatGPT

Activez le mode développeur (Settings → Apps & Connectors → Advanced settings) et ajoutez un serveur MCP personnalisé avec cette URL et sans authentification. Les noms des menus changent d’une version à l’autre.

https://flatin.es/mcp

Cursor

Dans ~/.cursor/mcp.json :

{
  "mcpServers": {
    "flatin": {
      "url": "https://flatin.es/mcp"
    }
  }
}

VS Code

Dans .vscode/mcp.json :

{
  "servers": {
    "flatin": {
      "type": "http",
      "url": "https://flatin.es/mcp"
    }
  }
}

Limites

Pour que le service reste gratuit et rapide : jusqu’à 20 appels par minute et 120 par heure depuis une même adresse, et 60 par minute et 360 par heure depuis un même réseau. Au-delà, la réponse est HTTP 429 avec le délai d’attente (Retry-After). Les listes de programmes donnent jusqu’à 25 résultats par appel, sans pagination, et un réseau reçoit des listes pour au plus 12 lieux différents par heure ; ensuite, le nombre et le lien vers la page. Nous ne conservons pas les adresses IP. Chaque requête compte, y compris celles de la connexion elle-même (initialize, tools/list).

Les connecteurs de Claude (claude.ai) et de ChatGPT appellent depuis les serveurs de leur plateforme : tous leurs utilisateurs partagent donc ces limites. Pour un usage intensif, connectez-vous depuis Claude Code, Cursor ou VS Code, qui appellent depuis votre propre adresse.

Conditions d’utilisation

Les réponses peuvent être affichées et citées avec un lien vers flatin.es. Les informations de chaque programme appartiennent au promoteur : attribuez-les et liez la page de flatin.es. Les données publiques portent leur source et leur période : citez-les. Les calculs d’impôts sont des estimations selon les règles générales, pas un conseil fiscal. Un champ vide signifie « inconnu » : ne le remplissez pas. Détails dans les conditions d’utilisation ; pour les agents, aussi dans llms.txt.

Pour les personnes

Si vous cherchez un logement, commencez par le catalogue de logements neufs ou le guide pour acheter un logement en Espagne.