Skip to main content
Glama

Rentcast MCP Server

by tandat8503
GitHub
JavaScript
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

šŸ  Rentcast MCP Server

A Model Context Protocol (MCP) server that provides access to Rentcast Real Estate API data through a standardized interface. This server enables AI assistants and applications to retrieve comprehensive real estate information including property details, market analysis, rent estimates, and property valuations.

āœØ Features

  • šŸ” Property Search: Search properties with filters (city, state, bedrooms, bathrooms, etc.)

  • šŸŽ² Random Properties: Get random properties for market analysis

  • šŸ“Š Market Analysis: Comprehensive market statistics and trends

  • šŸ’° Property Valuation: Automated property value estimates with comparables

  • šŸ  Rent Estimates: Long-term rent estimates with comparable properties

  • šŸ˜ļø Sale Listings: Current properties for sale

  • šŸ˜ļø Rental Listings: Current properties for rent

  • šŸ  Property Details: Detailed property information and parameters

šŸš€ Quick Start

Prerequisites

Installation

# Clone the repository git clone https://github.com/tandat8503/mcp_rentcast.git cd mcp_rentcast # Install dependencies npm install # Copy environment file cp .env.example .env # Edit .env with your Rentcast API key RENTCAST_API_KEY=your_api_key_here # Build the project npm run build # Start the server npm start

Using with MCP Inspector

# Start MCP Inspector npx @modelcontextprotocol/inspector node dist/index.js # Open browser at http://localhost:6274 # Use the provided auth token to access the interface

šŸ› ļø Available Tools

1. search_properties

Search for properties with comprehensive information.

Parameters:

  • city (optional): City name (e.g., "Austin", "New York")

  • state (optional): State abbreviation (e.g., "TX", "CA")

  • zipCode (optional): ZIP code (e.g., "78705")

  • bedrooms (optional): Number of bedrooms (1-10)

  • bathrooms (optional): Number of bathrooms (1-10)

  • propertyType (optional): Property type (e.g., "Single Family", "Condo")

  • limit (optional): Maximum results (default: 15, max: 50)

Example:

{ "city": "Austin", "state": "TX", "bedrooms": 2, "limit": 20 }

2. get_random_properties

Get random properties for market analysis.

Parameters:

  • city (optional): City name

  • state (optional): State abbreviation

  • zipCode (optional): ZIP code

  • limit (optional): Number of properties (default: 10, max: 50)

3. analyze_market

Get comprehensive market statistics and trends.

Parameters:

  • zipCode (optional): ZIP code for analysis

  • city (optional): City name

  • state (optional): State abbreviation

  • dataType (optional): "All", "Sale", or "Rental" (default: "All")

4. get_property_value

Get automated property value estimates.

Required (one of):

  • address: Full property address

  • latitude + longitude: GPS coordinates

  • propertyId: Unique property identifier

Optional:

  • propertyType: Property type

  • bedrooms: Number of bedrooms

  • bathrooms: Number of bathrooms

  • squareFootage: Property size in sq ft

Example:

{ "address": "1011 W 23rd St, Austin, TX 78705", "propertyType": "Apartment", "bedrooms": 1, "bathrooms": 1 }

5. get_rent_estimates

Get long-term rent estimates with comparable properties.

Required (one of):

  • address: Full property address

  • latitude + longitude: GPS coordinates

  • propertyId: Unique property identifier

Optional:

  • propertyType: Property type

  • bedrooms: Number of bedrooms

  • bathrooms: Number of bathrooms

  • squareFootage: Property size in sq ft

6. get_sale_listings

Get current properties for sale.

Parameters:

  • city (optional): City name

  • state (optional): State abbreviation

  • zipCode (optional): ZIP code

  • limit (optional): Maximum results (default: 15, max: 50)

7. get_rental_listings

Get current properties for rent.

Parameters:

  • city (optional): City name

  • state (optional): State abbreviation

  • zipCode (optional): ZIP code

  • limit (optional): Maximum results (default: 15, max: 50)

8. get_property_details

Get detailed property information.

Parameters:

  • id (required): Property or listing ID

9. get_server_status

Get server status and API usage information.

Parameters: None

šŸ”§ Configuration

Environment Variables

Variable

Description

Default

Required

RENTCAST_API_KEY

Your Rentcast API key

-

āœ…

RENTCAST_BASE_URL

Rentcast API base URL

https://api.rentcast.io/v1

āŒ

MAX_API_CALLS_PER_SESSION

Maximum API calls per session

40

āŒ

TIMEOUT_SECONDS

API call timeout

30

āŒ

ENABLE_RATE_LIMITING

Enable rate limiting

true

āŒ

RATE_LIMIT_PER_MINUTE

Rate limit per minute

60

āŒ

DEBUG

Enable debug mode

false

āŒ

LOG_LEVEL

Log level

INFO

āŒ

API Limits

  • Free Tier: 45 API calls per month

  • Default Session Limit: 40 calls per session

  • Rate Limiting: 60 calls per minute (configurable)

šŸ—ļø Project Structure

mcp_rentcast/ ā”œā”€ā”€ src/ ā”‚ ā”œā”€ā”€ index.ts # Main MCP server implementation ā”‚ ā”œā”€ā”€ services/ ā”‚ ā”‚ ā”œā”€ā”€ config.ts # Configuration service ā”‚ ā”‚ ā””ā”€ā”€ rentcast-api.ts # Rentcast API client ā”‚ ā””ā”€ā”€ types/ ā”‚ ā””ā”€ā”€ index.ts # TypeScript type definitions ā”œā”€ā”€ dist/ # Compiled JavaScript output ā”œā”€ā”€ package.json # Project dependencies and scripts ā”œā”€ā”€ tsconfig.json # TypeScript configuration ā”œā”€ā”€ .env.example # Environment variables template ā”œā”€ā”€ .gitignore # Git ignore patterns ā””ā”€ā”€ README.md # This file

šŸš€ Development

Scripts

# Build the project npm run build # Start in development mode with hot reload npm run dev # Start production server npm start # Run tests npm test # Lint code npm run lint # Format code npm run format

Building

# Development build npm run build # The compiled output will be in the `dist/` directory

Debug Mode

The server includes comprehensive console logging for debugging:

  • Input Parameters: Logs all parameters received by tools

  • API Responses: Logs API call results and data samples

  • Error Handling: Detailed error logging with context

  • Performance: API call counts and rate limiting information

šŸ” Debugging

Console Logs

Each tool provides detailed logging:

šŸ” [tool_name] Tool called with params: { ... } šŸ” [tool_name] Built search params: { ... } šŸ” [tool_name] API result: { ... } šŸ” [tool_name] Data sample: { ... } šŸ” [tool_name] Tool completed successfully

Common Issues

  1. Missing API Key: Ensure RENTCAST_API_KEY is set in .env

  2. API Limits: Monitor remaining API calls with get_server_status

  3. Rate Limiting: Wait between API calls if rate limited

  4. Invalid Parameters: Check parameter validation in console logs

šŸ“Š API Usage Optimization

Best Practices

  1. Batch Requests: Use higher limits when possible to reduce API calls

  2. Caching: Implement caching for frequently requested data

  3. Parameter Validation: Provide accurate parameters for better results

  4. Error Handling: Implement proper error handling for failed requests

Rate Limiting

  • Default: 60 calls per minute

  • Configurable via RATE_LIMIT_PER_MINUTE

  • Automatic delays between calls when enabled

šŸ¤ Contributing

  1. Fork the repository

  2. Create a feature branch

  3. Make your changes

  4. Add tests if applicable

  5. Submit a pull request

šŸ“ License

This project is licensed under the MIT License - see the LICENSE file for details.

šŸ”— Links

šŸ†˜ Support

For issues and questions:

  1. Check the console logs for debugging information

  2. Verify your API key and configuration

  3. Check Rentcast API status and limits

  4. Open an issue in the repository

Built with ā¤ļø for the MCP community

Deploy Server
-
security - not tested
F
license - not found
-
quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

Enables intelligent property data analysis through the Rentcast API with optimized API call allocation. Provides comprehensive real estate market insights, property valuations, rental estimates, and listings data with built-in rate limiting and fallback mechanisms.

  1. āœØ Features
    1. šŸš€ Quick Start
      1. Prerequisites
      2. Installation
      3. Using with MCP Inspector
    2. šŸ› ļø Available Tools
      1. 1. search_properties
      2. 2. get_random_properties
      3. 3. analyze_market
      4. 4. get_property_value
      5. 5. get_rent_estimates
      6. 6. get_sale_listings
      7. 7. get_rental_listings
      8. 8. get_property_details
      9. 9. get_server_status
    3. šŸ”§ Configuration
      1. Environment Variables
      2. API Limits
    4. šŸ—ļø Project Structure
      1. šŸš€ Development
        1. Scripts
        2. Building
        3. Debug Mode
      2. šŸ” Debugging
        1. Console Logs
        2. Common Issues
      3. šŸ“Š API Usage Optimization
        1. Best Practices
        2. Rate Limiting
      4. šŸ¤ Contributing
        1. šŸ“ License
          1. šŸ”— Links
            1. šŸ†˜ Support

              Related MCP Servers

              • Roam Research

                2b3pro
                A
                security
                A
                license
                A
                quality
                Provides comprehensive access to Roam Research's API functionality. This server enables AI assistants like Claude to interact with your Roam Research graph through a standardized interface.
                Last updated -
                14
                66
                MIT License
                • Apple

              • PolyMarket MCP Server

                berlinbra
                A
                security
                A
                license
                A
                quality
                Enables interaction with the PolyMarket API to fetch prediction market data such as market information, prices, and historical data, with robust error handling and rate limit management.
                Last updated -
                4
                40
                MIT License
                • Apple

              • RateSpot MCP Server

                zad0xlik
                A
                security
                F
                license
                A
                quality
                Provides access to RateSpot.io mortgage rate APIs, enabling AI assistants to fetch real-time mortgage rates, compare loan products, calculate payments, and access comprehensive lending information.
                Last updated -
                7
                • Apple

              • Daft.ie MCP Server

                amineremache
                -
                security
                A
                license
                -
                quality
                An MCP server that enables interaction with the Daft.ie API for searching rental properties and retrieving detailed information about specific rental listings.
                Last updated -
                10
                ISC License

              View all related MCP servers

              New MCP Servers

              MCP directory API

              We provide all the information about MCP servers via our MCP API.

              curl -X GET 'https://glama.ai/api/mcp/v1/servers/tandat8503/mcp_rentcast'

              If you have feedback or need assistance with the MCP directory API, please join our Discord server