# 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:
```bash
cp .env.example .env
```

2. Set your Rentcast API key in `.env`:
```bash
RENTCAST_API_KEY=your_api_key_here
```

3. Start the development environment:
```bash
make dev
```

## Development

This project uses uv for Python dependency management and Docker Compose for the development environment.

See `docs/` directory for detailed documentation.