Saltar al contenido

Servidor MCP de MDRealty

El Model Context Protocol (MCP) permite a los asistentes de IA llamar a herramientas externas. Nuestro servidor MCP les da acceso directo al catálogo de inmuebles en Montenegro de MDRealty, de modo que un asistente puede responder preguntas sobre inmuebles con anuncios actuales en lugar de suponer.

El servidor ofrece 13 herramientas de solo lectura: búsqueda de inmuebles con filtros y consultas en lenguaje natural, detalles completos de anuncios, anuncios similares, ciudades, tipos de inmueble y de operación, selecciones temáticas y nuestros artículos sobre la compra de inmuebles en Montenegro. Cada respuesta enlaza a la página del anuncio en mdrealty.me.

Cómo conectarse

URL del servidor

https://mdrealty.me/api/mcp/mcp

Transporte: Streamable HTTP. Se admiten versiones del protocolo hasta la 2025-11-25.

Autorización

OAuth 2.1 con registro dinámico de clientes y PKCE. Su cliente se registra por sí mismo, abre nuestra página de consentimiento y usted pulsa Permitir: no se necesita cuenta ni contraseña. Después, el cliente recibe su propia clave.

Clientes

  • Claude (web y escritorio): abra Configuración → Conectores, añada un conector personalizado y pegue la URL del servidor.
  • ChatGPT: active el modo desarrollador en los ajustes de conectores, cree un conector con la URL del servidor y elija OAuth.
  • Claude Code: ejecute el siguiente comando en un terminal.
    claude mcp add --transport http mdrealty https://mdrealty.me/api/mcp/mcp
  • Cursor y otros clientes: añada el servidor al archivo de configuración de MCP.
    {
      "mcpServers": {
        "mdrealty": {
          "url": "https://mdrealty.me/api/mcp/mcp"
        }
      }
    }

Herramientas

Esta lista se genera a partir del propio servidor, por lo que siempre coincide con lo que ve su cliente.

Search properties

search_propertiesSolo lectura

Search real estate properties in Montenegro. Supports natural language queries like "apartment in Budva near the sea under 200k" or structured filters. Returns up to 20 properties with key details. Prices in EUR.

Parámetros

querystring
Natural language search, e.g. "villa with pool in Tivat"
citySlugstring
City name or slug, e.g. "budva", "tivat", "kotor", "herceg-novi". Supports partial matching.
listingType"sale" | "rent" | "daily-rent"
Listing type: sale, rent (long-term), daily-rent (short-term). Default: sale
propertyTypestring
Type slug: apartments, houses, villas, land, business, offices, hotels, residential-complexes, luxury-complexes, exclusive
minPricenumber
Min price in EUR
maxPricenumber
Max price in EUR
bedroomsinteger
Minimum bedrooms
bathroomsinteger
Minimum bathrooms
minAreanumber
Min area in m²
maxAreanumber
Max area in m²
maxDistanceToSeanumber
Max distance to sea in meters
limitinteger
Results per page (max 20). Default: 10
offsetinteger
Skip N results for pagination. Default: 0
sort"relevance" | "price_asc" | "price_desc" | "area_asc" | "area_desc" | "newest" | "sea_distance"
Sort order. Default: relevance
locale"ru" | "en" | "sr" | "de" | "fr" | "tr" | "pl" | "es"
Response language. Default: en

Devuelve: totalCount, properties, hasMore, searchTip

Get property details

get_propertySolo lectura

Get full details of a specific property by internal ID or slug. "propertyId" is the internal database ID, NOT the property number shown in titles (e.g. "Apartment in Budva No. 2584" has propertyId=2473, propertyNumber="2584"). Use slug for reliable lookups.

Parámetros

propertyIdinteger
Internal database ID (the "id" field in search results), not the number shown in the title
slugstring
Property URL slug
locale"ru" | "en" | "sr" | "de" | "fr" | "tr" | "pl" | "es"
Response language. Default: en
includeImageboolean
Also return the main photo inline as an image block. Default: false (photo URLs are always included)

Devuelve: id, propertyNumber, slug, title, url, canonicalUrl, price, currency, priceFormatted, propertyType, listingType, city, district, area, bedrooms, bathrooms, distanceToSea, imageUrl, isVerified, excerpt, contactUrl, description, address, latitude, longitude, landArea, rooms, floor, totalFloors, yearBuilt, furnished, parking, features, galleryUrls, totalPhotos, virtualTourUrl, videoUrl, agent, pricePerSqm, isSuperPrice, isUrgent, isNew

Find similar properties

find_similar_propertiesSolo lectura

Find properties similar to a given one. Uses AI embeddings to find visually and semantically similar listings. Great for "show me more like this" scenarios.

Parámetros

propertyIdintegerobligatorio
Reference property ID
limitinteger
Number of similar properties (max 12). Default: 6
locale"ru" | "en" | "sr" | "de" | "fr" | "tr" | "pl" | "es"
Response language. Default: en

Devuelve: totalCount, properties, hasMore, searchTip

List cities

list_citiesSolo lectura

Get list of all cities where MDRealty has properties. Use city slugs from this list for the citySlug filter in search_properties.

Parámetros

locale"ru" | "en" | "sr" | "de" | "fr" | "tr" | "pl" | "es"
Response language. Default: en

Devuelve: cities

List property types

list_property_typesSolo lectura

Get available property types (apartment, house, villa, land, etc.) with slugs for search filters.

Parámetros

locale"ru" | "en" | "sr" | "de" | "fr" | "tr" | "pl" | "es"
Response language. Default: en

Devuelve: propertyTypes

List listing types

list_listing_typesSolo lectura

Get available listing types (sale, rent) with slugs for search filters.

Parámetros

locale"ru" | "en" | "sr" | "de" | "fr" | "tr" | "pl" | "es"
Response language. Default: en

Devuelve: listingTypes

List thematic collections

list_collectionsSolo lectura

List available thematic property collections, e.g. "Beachfront Villas", "Investment Apartments". Curated groups of properties organized by theme.

Parámetros

locale"ru" | "en" | "sr" | "de" | "fr" | "tr" | "pl" | "es"
Response language. Default: en
limitinteger
Max results. Default: 10

Devuelve: collections

List articles

list_articlesSolo lectura

List blog articles about Montenegro real estate. Covers buying guides, investment tips, area overviews, and market analysis.

Parámetros

categorystring
Category slug to filter by
limitinteger
Max results. Default: 10
offsetinteger
Skip N results. Default: 0
locale"ru" | "en" | "sr" | "de" | "fr" | "tr" | "pl" | "es"
Response language. Default: en

Devuelve: totalCount, articles, hasMore

Get article

get_articleSolo lectura

Get a blog article by slug or ID. Articles include guides about Montenegro locations, buying process, and investment advice.

Parámetros

slugstring
Article URL slug
idinteger
Article ID
locale"ru" | "en" | "sr" | "de" | "fr" | "tr" | "pl" | "es"
Response language. Default: en

Devuelve: id, slug, title, url, canonicalUrl, excerpt, category, imageUrl, publishedAt, content, relatedProperties

Estimate purchase costs

estimate_deal_costSolo lectura

Authoritative purchase-cost calculator for Montenegro, the same as /tools/deal-cost-calculator on mdrealty.me: property transfer tax (PROGRESSIVE — 3% up to €150,000, 5% for €150,000–500,000, 6% above; a new build from a VAT-registered developer is exempt) and the notary fee by the official tariff (Sl. list CG 49/2026; +5% of the tariff per party beyond two, +€15 per court interpreter, cadastre filing, 21% VAT). Also returns the agency fee: none for a listing from the MDRealty catalog, a separate deal-support fee for a property found elsewhere. Pass a price, or propertyId/slug of a catalog listing to use its price. Always use this instead of computing taxes or fees yourself.

Parámetros

pricenumber
Property price in EUR. Not needed when propertyId or slug is given.
propertyIdinteger
Internal ID of a catalog listing (the "id" field of search results) — its price is used
slugstring
Slug of a catalog listing — its price is used
dealSupportboolean
The property was found elsewhere and MDRealty is asked to handle the purchase. Ignored for catalog listings.
newBuildFromVatPayerboolean
New build bought from a VAT-registered developer — no transfer tax. Default: the listing's own exemption for a catalog listing, otherwise false
buyersinteger
People buying (spouses = 2, a company = 1). Default: 1
sellersinteger
People selling, same rule. Default: 1
interpretersinteger
Court interpreters at the signing, one per language. Default: 0
cadastreFilingboolean
The notary files the cadastre application. Default: true
locale"ru" | "en" | "sr" | "de" | "fr" | "tr" | "pl" | "es"
Language of the links. Default: en

Devuelve: price, currency, property, transferTax, notary, extraFees, agencyFee, totalCosts, totalWithProperty, totalWithDealSupport, calculatorUrl, notes

Mortgage calculator

mortgage_calculatorSolo lectura

Monthly mortgage payment for a property price in EUR — the same annuity calculation and defaults as /tools/mortgage-calculator on mdrealty.me: down payment 30%, 20 years, and unless a rate is given, the cheapest current bank rate for the borrower segment (5% when no bank rate is on file). Indicative only: bank terms in Montenegro differ.

Parámetros

pricenumberobligatorio
Property price in EUR
downPaymentPctnumber
Down payment as % of the price. Default: 30
downPaymentnumber
Down payment in EUR — overrides downPaymentPct
termYearsinteger
Loan term in years. Default: 20
annualRatePctnumber
Annual interest rate, %. Default: the cheapest current bank rate for the segment
segment"resident" | "non_resident_permit" | "non_resident" | "young" | "diaspora"
Borrower: resident, non_resident_permit (has a residence permit), non_resident, young, diaspora. Default: resident
locale"ru" | "en" | "sr" | "de" | "fr" | "tr" | "pl" | "es"
Language of the link. Default: en

Devuelve: price, downPayment, downPaymentPct, loan, termYears, annualRatePct, rateSource, bank, monthlyPayment, totalPaid, totalInterest, calculatorUrl, note

Market price statistics

get_market_statsSolo lectura

Asking-price statistics of real estate in Montenegro from the MDRealty catalog: number of active listings, price and price-per-m² quartiles (25th percentile, median, 75th) and median area — for the whole country, a city or a region, a property type and a deal type (sale, monthly rent, nightly rent). A region (e.g. budvanskaya-rivera) covers every town in it; city.isRegion marks it. Groups with fewer than 5 listings are not shown. Refreshed daily; computedAt says when. Use it to answer "how much does an apartment in Budva cost per m²" instead of guessing from search results.

Parámetros

citySlugstring
City or region slug from list_cities ("budva" works too); omit for the whole country and every city
propertyTypestring
Property type slug from list_property_types, e.g. apartments; omit for all types
listingType"sale" | "rent" | "daily-rent"
sale, rent (monthly) or daily-rent (nightly). Default: all three
limitinteger
Groups to return, 1–200. Default: 50
locale"ru" | "en" | "sr" | "de" | "fr" | "tr" | "pl" | "es"
Language of city and type names. Default: en

Devuelve: computedAt, currency, minGroupSize, totalGroups, groups, hasMore, note, searchTip

Compare properties

compare_propertiesSolo lectura

Side-by-side comparison of 2–4 MDRealty listings: price, price per m², area, bedrooms, bathrooms, distance to the sea, city, year built and the listing page, plus how each price per m² compares with the market median for similar listings (the same figures as get_market_stats). Pass the ids from search results, or slugs.

Parámetros

propertyIdsinteger[]
Internal IDs (the "id" field of search results), not the listing number in the title
slugsstring[]
Listing slugs
locale"ru" | "en" | "sr" | "de" | "fr" | "tr" | "pl" | "es"
Language of titles, names and links. Default: en

Devuelve: properties, notFound, summary, marketComputedAt, note

Las claves de socio y de personal desbloquean herramientas adicionales, como la búsqueda por foto y la revisión de duplicados. Contacte con nosotros para obtener una clave de socio.

API JSON sin MCP

Los agentes que no pueden usar MCP (GPT Actions, herramientas de LangChain, clientes HTTP sencillos) pueden leer el mismo catálogo mediante una API JSON. No se necesita clave ni registro; las respuestas son las mismas que las de las herramientas MCP.

  • GET /api/ai/properties — buscar anuncios, con los mismos filtros que search_properties
  • GET /api/ai/properties/{slug} — un anuncio por su slug, como get_property
  • GET /api/ai/cities — ciudades con anuncios, como list_cities

Ejemplo

curl "https://mdrealty.me/api/ai/properties?citySlug=budva&query=sea%20view&limit=5"

Descripción OpenAPI 3.1/api/ai/openapi.json

Límites

  • 60 peticiones por minuto por clave. Por encima de esa cifra, el servidor responde 429 con una cabecera Retry-After.
  • Todas las claves públicas usadas desde una misma dirección IP comparten 300 peticiones por minuto.
  • La conexión de clientes está limitada por dirección IP: 20 registros y 20 peticiones de token por hora.
  • API JSON sin clave: 60 peticiones por minuto por dirección IP, hasta 20 anuncios por página (un límite mayor se recorta) y un offset máximo de 200.
  • Hasta 20 anuncios por página; use offset para paginar los resultados.
  • Los precios están en euros. Los anuncios cambian a diario: confirme la disponibilidad con el agente antes de basarse en un precio.

Condiciones de uso

  • Utilice los datos para responder a las preguntas de sus usuarios sobre inmuebles en Montenegro.
  • Atribuya los datos a MDRealty y enlace al anuncio: muestre al usuario el campo url y cite canonicalUrl.
  • No copie el catálogo de forma masiva, no revenda los datos ni cree con ellos una base de datos de la competencia.
  • El contenido no puede utilizarse para entrenar modelos de IA (robots.txt: Content-Signal ai-train=no).
  • Podemos limitar o revocar las claves que se utilicen de forma abusiva.
  • Las llamadas a herramientas se registran durante 90 días para operar y proteger el servicio: nombre de la herramienta, parámetros con las direcciones de email y los números de teléfono enmascarados, y una dirección IP acortada. Las claves que nunca se han usado se eliminan a los 30 días.

Descubrimiento legible por máquinas

Los agentes pueden encontrar y configurar el servidor sin esta página:

Contacto

Preguntas, claves de socio o alguna herramienta que eche en falta: escriba a sales@mdrealty.me.