diff --git a/README.md b/README.md index 7665883..d476fbb 100644 --- a/README.md +++ b/README.md @@ -5,10 +5,18 @@

MCP Server for Rentcast API

Intelligent property data access with advanced caching, rate limiting, and cost management

+ +

+ API Home • + Documentation • + Repository +

--- +> **The Rentcast real estate and property data API provides on-demand access to 140+ million property records, owner details, home value and rent estimates, comparable properties, active sale and rental listings, as well as aggregate real estate market data.** + A Model Context Protocol (MCP) server that provides intelligent access to the Rentcast API with advanced caching, rate limiting, and cost management features. ## 🌟 Features @@ -493,12 +501,24 @@ The server provides complete access to Rentcast API endpoints: | **Market Data** | Statistics and trends | `get_market_statistics` | | **Management** | Configuration and monitoring | 6 management tools | -### Cost Management +### 💰 API Pricing & Cost Management +#### Rentcast API Pricing +Rentcast offers several pricing tiers for API access. See [official pricing](https://www.rentcast.io/api#api-pricing) for current rates: +- **Free Tier**: Limited requests for testing +- **Basic**: $99/month for 1,000 requests +- **Professional**: Higher volumes with bulk pricing +- **Enterprise**: Custom pricing for large-scale usage + +> **Why We Cache**: Each API request costs money! Our [intelligent caching system](#-features) stores responses for 24 hours (configurable), dramatically reducing costs by serving repeated requests from cache instead of making new API calls. This can reduce API costs by 70-90% in typical usage patterns. + +#### Cost Management Features - **Automatic Cost Estimation**: Know before you spend - **User Confirmations**: Approve expensive operations - **Usage Tracking**: Monitor daily/monthly consumption - **Smart Caching**: Minimize redundant API calls +- **Rate Limiting**: Prevent accidental overuse +- **Cache Analytics**: Track hit rates and savings - **Mock API**: Unlimited testing without credits ## 📄 License @@ -522,12 +542,18 @@ Contributions are welcome! Please: ## 📞 Support -### Documentation Resources +### Project Documentation - **[Installation Guide](docs/INSTALLATION.md)**: Complete setup instructions - **[Usage Examples](docs/USAGE.md)**: All 13 tools with real-world examples - **[Mock API Testing](docs/mock-api.md)**: Test without consuming credits - **[Claude Integration](docs/claude-setup.md)**: MCP configuration help +### Rentcast API Resources +- **[API Documentation](https://developers.rentcast.io/reference/introduction)**: Official API reference +- **[API Pricing](https://www.rentcast.io/api#api-pricing)**: Current pricing tiers +- **[API Dashboard](https://app.rentcast.io)**: Manage your API keys +- **[Rentcast Support](https://www.rentcast.io/contact)**: Official support channel + ### Getting Help - **Issues**: [Create an issue](https://git.supported.systems/MCP/mcrentcast/issues) on the repository - **Discussions**: Use GitHub discussions for questions and community support