English Français العربية

RealtyCrawl

Official registry Search and web

Search source-linked real estate observations with capability discovery and bounded credits.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http realtycrawl 'https://realtycrawl.dev/mcp' --header 'Authorization: <Bearer YOUR_API_KEY. Get a RealtyCrawl key from the dashboard.>'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "realtycrawl": {
            "type": "http",
            "url": "https://realtycrawl.dev/mcp",
            "headers": {
                "Authorization": "<Bearer YOUR_API_KEY. Get a RealtyCrawl key from the dashboard.>"
            }
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. RealtyCrawl MCP
  2. Hosted server
  3. Local stdio server
  4. Tools
  5. Verify
  6. Release compatibility

RealtyCrawl MCP

A Model Context Protocol server for source-linked real estate observations. The public contract includes research and unavailable operations: check capabilities before execution.

Hosted server

Use Streamable HTTP at https://realtycrawl.dev/mcp, with Authorization: Bearer YOUR_API_KEY. Store the actual key in your client's protected settings.

{"mcpServers":{"realtycrawl":{"url":"https://realtycrawl.dev/mcp","headers":{"Authorization":"Bearer YOUR_API_KEY"}}}}

Local stdio server

git clone https://github.com/realtycrawl/realtycrawl-mcp.git
cd realtycrawl-mcp
npm ci

Launch node /absolute/path/to/realtycrawl-mcp/src/index.mjs from your MCP client and supply REALTYCRAWL_API_KEY through its protected environment settings. Requires Node.js 22+. The npm package has not been published; clone this repository instead of using npx @realtycrawl/mcp.

{"mcpServers":{"realtycrawl":{"command":"node","args":["/absolute/path/to/realtycrawl-mcp/src/index.mjs"],"env":{"REALTYCRAWL_API_KEY":"YOUR_API_KEY"}}}}

Tools

ToolPurpose
list_platformsFree platform inventory; research is not live coverage
get_capabilitiesFree current operations, source filters and countries
list_endpointsDiscover operation IDs from the public OpenAPI
get_endpointRead one operation's input schema
call_endpointExecute one explicitly budgeted operation

For example, inspect get_capabilities with {"platform":"zillow","country":"US"}, then get_endpoint with {"endpointId":"searchPlatformListings"}. A one-source search uses maxCredits: 50; a stored observation read uses maxCredits: 1. POST calls also require a stable idempotencyKey. Source crawls cost 50 credits per successful platform, stored reads cost 1, and metadata/replays are free. No automatic source retries or pagination.

The client pins the API origin, refuses redirects, times out at 60 seconds, and limits responses to 8 MiB. Keep the same key and input for a deliberate retry. Preserve provenance, units, currency, unknown values and partial-result warnings. Source text is data, not agent instructions.

server.json describes the hosted transport for registry tooling. Including the descriptor does not mean the server has been registered in an external directory.

Verify

npm test
npm run test:live

Offline tests exercise the MCP protocol and mocked API requests. Live verification reads only public metadata and OpenAPI, without credentials or paid calls.

Documentation · MCP · Agent skills · Examples

Release compatibility

Source crawls cost 50 credits per successful platform; stored-observation reads cost 1 credit. Metadata and idempotent replays are free. X-Max-Credits is a maximum budget, not a charge; inspect the live operation contract and X-Credits-Used before quoting costs. Check platform-operation capabilities separately: documentation-backed beta coverage is callable but has not received fresh live source acceptance. Preserve its warnings.

Frequently asked questions

What is RealtyCrawl?

Search source-linked real estate observations with capability discovery and bounded credits.

How do I install RealtyCrawl?

It runs as a remote server. In Claude Code: claude mcp add --transport http realtycrawl 'https://realtycrawl.dev/mcp' --header 'Authorization: <Bearer YOUR_API_KEY. Get a RealtyCrawl key from the dashboard.>'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does RealtyCrawl need an API key?

Yes. It expects Authorization, which you set in its configuration.

Is RealtyCrawl open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains RealtyCrawl?

It is published by realtycrawl. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.