Ryan Malloy 723123a6fe Add comprehensive mock Rentcast API for testing
- 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
2025-09-09 08:56:01 -06:00

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

  1. Copy environment configuration:
cp .env.example .env
  1. Set your Rentcast API key in .env:
RENTCAST_API_KEY=your_api_key_here
  1. 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
MCP Server for Rentcast API with intelligent caching and rate limiting
Readme 297 KiB
Languages
Python 95.1%
Makefile 2.4%
Dockerfile 1.7%
Shell 0.8%