De MCP-server van flatin.es voor AI-agents

flatin.es heeft een openbare server van het Model Context Protocol (MCP): een AI-assistent — Claude, ChatGPT, Cursor of een andere — kan onze nieuwbouwcatalogus, onze rekenhulpen en de lokale gegevens rechtstreeks raadplegen, in plaats van te gokken of verouderde pagina’s te lezen. Gratis, zonder registratie en zonder sleutel.

Elk antwoord vermeldt bron en datum van elk cijfer en de link naar de pagina van flatin.es waar alles volledig staat: de assistent kan die citeren en u kunt het controleren.

Waar hij antwoord op geeft

Nieuwbouw te koop in een gemeente, een provincie of een kopersgebied (Costa Blanca, Costa del Sol): naam, ontwikkelaar, prijs vanaf, slaapkamers, oplevering en de datum waarop de site van de ontwikkelaar is gelezen.
Aankoopkosten van een woning overal in Spanje: btw en zegelrecht bij nieuwbouw of overdrachtsbelasting bij bestaande bouw per belastinggebied, plus notaris en register volgens de officiële tarieven — zoals onze rekenhulp aankoopkosten.
Belasting voor niet-ingezetenen (IRNR, modelo 210) van een eigenaar: toegerekend inkomen en huur, EU/EER of niet — zoals de rekenhulp modelo 210.
2 tot 4 plaatsen vergelijken op openbare gegevens: woningprijzen, huur, IBI, bevolking, inkomen, vakantieverhuur, buitenlanders en meer, elk cijfer met periode en bron.
IBI-tarief van een gemeente, met jaar en bron (ministerie van Financiën) — de IBI-dataset.

Dekking: de nieuwbouwcatalogus omvat Costa Blanca en Costa del Sol; lokale gegevens en vergelijkingen de gemeenten van de provincies Alicante, Málaga, Valencia en Murcia. Aankoopkosten worden voor heel Spanje berekend en de IRNR hangt niet van de plaats af. Buiten die dekking zegt de tool dat, in plaats van iets te verzinnen.

Tools

newbuilds_in_place: Nieuwbouwprojecten te koop in een gemeente, gebied of provincie (tot 25 per aanroep, met link naar de volledige lijst).
ibi_rate: Jaarlijks IBI-tarief (urbana) van een gemeente, met jaar en bron.
compare_places: Recente cijfers van 2 tot 4 plaatsen naast elkaar, elk met eenheid, periode en bron.
purchase_costs: Belastingen en kosten bij het kopen van een woning in Spanje naar prijs, plaats en soort (nieuwbouw of bestaand).
non_resident_tax: Jaarlijkse IRNR (modelo 210) van een niet-ingezeten eigenaar.

Voorbeeldvragen

Welke nieuwbouwprojecten zijn te koop in Torrevieja, en vanaf welke prijs?
Hoeveel belastingen en kosten betaal ik voor een nieuw appartement van € 250.000 in Málaga?
Vergelijk Orihuela, Torrevieja en Santa Pola: woningprijzen, huur en IBI.
Ik woon in Nederland en heb een appartement in Spanje met een kadastrale waarde van € 80.000, minder dan tien jaar geleden herzien, niet verhuurd: hoeveel IRNR betaal ik per jaar?
Wat is het IBI-tarief in Benidorm?

Zo koppelt u hem

Serveradres en transport Streamable HTTP (JSON-RPC via POST, zonder sessie). Inloggen is niet nodig: kies „geen authenticatie” als de client erom vraagt.

https://flatin.es/mcp

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

Claude Code

In de terminal:

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

Claude (claude.ai, Desktop)

Customize → Connectors → Add custom connector, met deze URL en zonder authenticatie. Bij Team- en Enterprise-abonnementen voegt een beheerder van de organisatie hem toe.

https://flatin.es/mcp

ChatGPT

Zet de ontwikkelaarsmodus aan (Settings → Apps & Connectors → Advanced settings) en voeg een eigen MCP-server toe met deze URL en zonder authenticatie. Menunamen veranderen per versie.

https://flatin.es/mcp

Cursor

In ~/.cursor/mcp.json:

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

VS Code

In .vscode/mcp.json:

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

Limieten

Zodat de dienst gratis en snel blijft: tot 20 aanroepen per minuut en 120 per uur vanaf één adres, en 60 per minuut en 360 per uur vanaf één netwerk. Daarboven antwoordt de server met HTTP 429 en de wachttijd (Retry-After). Projectlijsten geven tot 25 per aanroep, zonder paginering, en een netwerk krijgt lijsten voor hoogstens 12 verschillende plaatsen per uur; daarna het aantal en de link naar de pagina. IP-adressen bewaren we niet. Elk verzoek telt, ook die van de verbinding zelf (initialize, tools/list).

Connectors van Claude (claude.ai) en ChatGPT bellen vanaf de servers van hun platform, dus al hun gebruikers delen deze limieten. Voor intensief gebruik koppelt u vanuit Claude Code, Cursor of VS Code: die bellen vanaf uw eigen adres.

Gebruiksvoorwaarden

Antwoorden mogen worden getoond en geciteerd met een link naar flatin.es. De gegevens van elk project zijn van de ontwikkelaar: vermeld hem en link naar de pagina van flatin.es. Openbare gegevens hebben een bron en periode: noem die. Belastingberekeningen zijn schattingen volgens de algemene regels, geen belastingadvies. Een leeg veld betekent „onbekend”: vul het niet in. Details in de gebruiksvoorwaarden; voor agents ook in llms.txt.

Voor mensen

Zoekt u een woning, begin dan met de nieuwbouwcatalogus of de gids voor het kopen van een woning in Spanje.