MDRealty MCP server

How to connect

Server URL

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

Transport: Streamable HTTP. Protocol versions up to 2025-11-25 are supported.

Authorization

OAuth 2.1 with dynamic client registration and PKCE. Your client registers itself, opens our consent page and you click Allow — no account or password is needed. The client then receives its own key.

Clients

• Claude (web and desktop): open Settings → Connectors, add a custom connector and paste the server URL.
• ChatGPT: turn on developer mode in the connector settings, create a connector with the server URL and choose OAuth.
• Claude Code: run the command below in a terminal.

  claude mcp add --transport http mdrealty https://mdrealty.me/api/mcp/mcp

• Cursor and other clients: add the server to the MCP configuration file.

  {
    "mcpServers": {
      "mdrealty": {
        "url": "https://mdrealty.me/api/mcp/mcp"
      }
    }
  }

Tools

This list is generated from the server itself, so it always matches what your client sees.

Partner and staff keys unlock additional tools, such as search by photo and duplicate review. Contact us to get a partner key.

JSON API without MCP

Agents that cannot use MCP — GPT Actions, LangChain tools, plain HTTP clients — can read the same catalog over a JSON API. No key or registration is needed; the answers are the same as from the MCP tools.

• GET /api/ai/properties — search listings, with the same filters as search_properties
• GET /api/ai/properties/{slug} — one listing by its slug, as get_property
• GET /api/ai/cities — cities with listings, as list_cities

Example

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

OpenAPI 3.1 description/api/ai/openapi.json

Limits

• 60 requests per minute per key. Above that the server answers 429 with a Retry-After header.
• All public keys used from one IP address share 300 requests per minute.
• Connecting a client is limited per IP address: 20 registrations and 20 token requests per hour.
• JSON API without a key: 60 requests per minute per IP address, up to 20 listings per page (a larger limit is capped), offset at most 200.
• Up to 20 listings per page; use offset to page through results.
• Prices are in euros. Listings change daily — check availability with the agent before relying on a price.

Terms of use

• Use the data to answer the questions of your users about property in Montenegro.
• Attribute MDRealty and link to the listing: show the url field to the user and cite canonicalUrl.
• Do not copy the catalog in bulk, resell the data or build a competing database from it.
• The content may not be used to train AI models (robots.txt: Content-Signal ai-train=no).
• We may limit or revoke keys that are used abusively.
• Tool calls are logged for 90 days to run and protect the service: tool name, parameters with email addresses and phone numbers masked, and a shortened IP address. Keys that were never used are deleted after 30 days.

Machine-readable discovery

Agents can find and configure the server without this page:

• MCP server card/.well-known/mcp/server-card.json
• OAuth protected resource metadata/.well-known/oauth-protected-resource
• Agent skills index/.well-known/agent-skills/index.json
• llms.txt/llms.txt
• OpenAPI of the JSON API/api/ai/openapi.json

Contact

Questions, partner keys or a tool you are missing — write to sales@mdrealty.me.