- Complete mock API server with all Rentcast endpoints - Static test API keys with different tiers and limits - Rate limiting simulation for testing - Docker service configuration for mock API - Integration tests using mock API - Configuration support for switching between real/mock APIs - Test script to verify mock API functionality - Comprehensive documentation for mock API usage Test API Keys: - test_key_free_tier: 50 daily limit - test_key_basic: 100 daily limit - test_key_pro: 1000 daily limit - test_key_enterprise: 10000 daily limit - test_key_rate_limited: 1 daily limit (for testing) - test_key_invalid: For testing auth errors
mcrentcast - Rentcast MCP Server
A Model Context Protocol (MCP) server that provides intelligent access to the Rentcast API with advanced caching, rate limiting, and cost management features.
Features
- 🏠 Complete Rentcast API integration
- 💾 Intelligent caching with hit/miss tracking
- 🛡️ Rate limiting with exponential backoff
- 💰 Cost management and API usage tracking
- ✨ MCP elicitation for user confirmations
- 🐳 Docker Compose development environment
- 🧪 Comprehensive test suite with beautiful reports
Quick Start
- Copy environment configuration:
cp .env.example .env
- Set your Rentcast API key in
.env
:
RENTCAST_API_KEY=your_api_key_here
- Start the development environment:
make dev
Development
This project uses uv for Python dependency management and Docker Compose for the development environment.
See docs/
directory for detailed documentation.
Description
Languages
Python
95.1%
Makefile
2.4%
Dockerfile
1.7%
Shell
0.8%