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 (web or 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

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.

Read-only and revocable

Every tool only reads data — the server never creates, changes, or deletes anything. To revoke access, remove the connector in your client or rotate your API key in the dashboard.

The MCP server requires OAuth sign-in. For CI or other environments without a browser, call the REST API directly with your key in the x-realtyapi-key header.

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:

ToolWhat it doesUses credits
list_apisList every provider — slug, name, category, and endpoint count.No
search_endpointsKeyword-search across all endpoints. The main discovery tool.No
get_endpoint_schemaFull parameter schema for one endpoint — types, required flags, enums, examples.No
call_endpointRun an endpoint (always a read-only GET) and return the live JSON response. Optional max_chars caps the response size.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:

All four tools need you to be signed in. Discovery tools are free to call; call_endpoint consumes credits like any API request — see API Credits. No account yet? Sign up free from the dashboard — 250 requests/month, no card required.

Questions or problems? Email [email protected]. See our Privacy Policy for how we handle data.