repliers-io/mcp-server

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

20 stars 5 forks Качество 82 Тренд 30MIT

Open-source MCP server for the Repliers API. Lets developers build conversational and agent-based real estate applications on the Repliers platform — natural-language listing search, market...

Обзор

An MCP (Model Context Protocol) server that gives AI assistants like Claude access to real-time MLS data via the Repliers API. Use natural language to search listings, pull market statistics, and look up properties: - "Find me 3 bedroom condos in Toronto under $800k listed in the last week" - "What's the average sold price for detached homes in Boston grouped by month over the last year?" - "Get me the details for MLS number X12345678" You'll need a Repliers API key. If you don't have an account, sign up at repliers.com. You can find your API key in the Repliers dashboard. The Search_Listings tool uses Repliers' AI-powered NLP search, which translates natural language queries into listing results. This requires: 1. An linked to your Repliers account 2.

README

Показан фрагмент оригинального README. Открыть оригинал.

Repliers MCP Server

An MCP (Model Context Protocol) server that gives AI assistants like Claude access to real-time MLS data via the Repliers API.

Use natural language to search listings, pull market statistics, and look up properties:

“Find me 3 bedroom condos in Toronto under $800k listed in the last week”
“What’s the average sold price for detached homes in Boston grouped by month over the last year?”
“Get me the details for MLS number X12345678”

Tools

Tool	Description
`Search_Listings`	Natural language listing search powered by Repliers NLP — requires NLP to be enabled on your Repliers account (see below)
`get_listing`	Fetch a single listing by MLS number
`Market_Statistics`	Market stats — averages, medians, days on market, grouped by time or geography
`Lookup_Possible_Values`	Enumerate valid filter values (property types, neighborhoods, etc.) before running a statistics query

Before You Start

Repliers API Key

You’ll need a Repliers API key. If you don’t have an account, sign up at repliers.com. You can find your API key in the Repliers dashboard.

Enabling NLP for Search_Listings

The Search_Listings tool uses Repliers’ AI-powered NLP search, which translates natural language queries into listing results. This requires:

An OpenAI API key linked to your Repliers account
NLP enabled on your account

Follow the setup guide here: Utilizing AI-Powered NLP for Real Estate Listing Searches

If NLP isn’t enabled, the other three tools (get_listing, Market_Statistics, Lookup_Possible_Values) will still work fine.

Prerequisites

Node.js — the version in .nvmrc (engine-strict is enabled, so npm install refuses other majors)

npm install

Deployment Options

There are two ways to use this MCP server. Full walkthrough with screenshots: Setting up Repliers MCP (video).

	Hosted (recommended)	Self-hosted
Server to run	none	yours (Node or Docker)
Auth	sign in with your Repliers account	none — API key in the environment
Clients	claude.ai, ChatGPT, any remote-MCP client	Claude Desktop, Postman, any stdio/HTTP client

Option 1 — Repliers Hosted MCP (recommended)

Repliers runs this server at https://mcp.repliers.io. Nothing to install; you link an API key to it and sign in from your client.

1. Link your API key to MCP (self-serve, no support ticket needed):

Открыть полный README на GitHub

Установка

docker run -i --rm --env-file /absolute/path/to/.env repliers-mcp node mcpServer.js

Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{
  "mcpServers": {
    "repliers": {
      "command": "/absolute/path/to/node",
      "args": ["/absolute/path/to/mcpServer.js"],
      "env": {
        "REPLIERS_API_KEY": "your-repliers-api-key"
      }
    }
  }
}