MCP Server

Hot

The Model Context Protocol (MCP) lets AI assistants call external tools directly. Our remote MCP server gives Claude, Cursor, Windsurf, and any MCP-compatible client live access to all RealtyAPI providers and endpoints — search Redfin listings, pull Airbnb rentals, or compare Zoopla prices from a chat prompt. Nothing to install or host.

Server URL

https://mcp.realtyapi.io/mcp

Streamable HTTP transport. Works with every client that supports remote MCP servers.

Claude Code

Add the server with one command:

Terminal

claude mcp add --transport http realtyapi https://mcp.realtyapi.io/mcp

Then ask anything — Claude discovers the right endpoint on its own: "Find 3-bedroom homes under $600k in Austin using RealtyAPI."

Claude Desktop, Cursor & Windsurf

Add this to your client's MCP configuration — for Cursor that's ~/.cursor/mcp.json, for Windsurf ~/.codeium/windsurf/mcp_config.json. In Claude Desktop you can also use Settings → Connectors → Add custom connector and paste the server URL.

mcp.json

{
  "mcpServers": {
    "realtyapi": {
      "url": "https://mcp.realtyapi.io/mcp"
    }
  }
}

VS Code (Copilot)

Add the server to your settings.json:

settings.json

{
  "mcp": {
    "servers": {
      "realtyapi": {
        "type": "http",
        "url": "https://mcp.realtyapi.io/mcp"
      }
    }
  }
}

Authentication

OAuth sign-in (default)

No key in your config. On first use, your client opens a browser window — sign in to your RealtyAPI account, click Connect, and your API key is bound to the session automatically.

API key header (headless)

For CI or environments without a browser, pass your key as the x-realtyapi-key header instead.

Header auth (optional)

claude mcp add --transport http realtyapi https://mcp.realtyapi.io/mcp \
  --header "x-realtyapi-key: YOUR_API_KEY"

Available tools

RealtyAPI has 400+ endpoints — far too many to expose as individual MCP tools. Instead the server exposes four tools and lets the agent discover endpoints at runtime, so new APIs we publish are available to your agent immediately:

Tool	What it does	Key required
`list_apis`	List every provider — slug, name, category, and endpoint count.	No
`search_endpoints`	Keyword-search across all endpoints. The main discovery tool.	No
`get_endpoint_schema`	Full parameter schema for one endpoint — types, required flags, enums, examples.	No
`call_endpoint`	Execute an endpoint and return the live JSON response. Uses your account credits.	Yes

Example prompts

Find 3-bedroom houses for sale in Austin under $600k using Redfin.

Pull the 10 most recent Airbnb listings in Lisbon and summarize nightly prices.

Compare average asking prices for 2-bed flats in Manchester across Zoopla and Rightmove.

Look up the rental estimate for 123 Main St, Seattle and draft an investment summary.

Official client guides

Each client documents its own MCP install flow — handy if yours isn't covered above:

Cursor Claude Code OpenAI Codex

Discovery tools are free to call. call_endpoint consumes credits like any API request — see API Credits. Need a key for header auth? Grab one free from the dashboard — 250 requests/month, no card required.