Rentsmart MCP

🚀 RentSmart MCP

This repository hosts a minimal Multi‑Channel Plugin (MCP) service for RentSmart, an AI‑powered WhatsApp bot that instantly generates rental agreements and receipts.

✨ Features

• /validate – Conducts a basic bearer token check and returns a dummy phone number. Update the token in app/main.py to enhance the security of your deployment.
• /tool/generate_agreement – Accepts rental agreement details, populates a text template, converts it into a PDF, and provides it via a public link under /files/agreements.
• /tool/generate_rent_receipt – Creates a PDF rent receipt with the specified details and makes it available under /files/receipts.
• /tool/stamp_duty_info – Returns state‑specific stamp duty information for quick reference. A default set of values is provided for demonstration purposes and can be easily expanded to cover all Indian states.
• /health – A simple heartbeat endpoint that returns {"status":"ok"}.

📦 Installation

Directory Structure

rentsmart_mcp/
├── app/
│   ├── __init__.py
│   ├── main.py             # FastAPI application
│   └── templates/
│       ├── agreement_template.txt
│       └── receipt_template.txt
├── files/                  # Generated PDFs will be saved here
├── requirements.txt        # Python dependencies
└── README.md

Quick Start

python -m venv .venv
source .venv/bin/activate  # or .venv\Scripts\activate on Windows
pip install -r requirements.txt
uvicorn app.main:app --reload --port 8000

Navigate to http://localhost:8000/health to confirm that the server is running.

🚀 Deployment

Deploy this service on any platform that supports FastAPI, such as Render, Railway, Vercel, or your own server. Ensure that the service is exposed over HTTPS for compatibility with Puch AI.

🤝 Puch AI Integration

After deployment, connect your MCP service to Puch AI using the /mcp connect command in your WhatsApp chat. Replace the URL and token below with your actual deployment details:

/mcp connect https://YOUR-DEPLOYED-URL your_test_token

Upon successful connection, you will see the available tools (generate_agreement, generate_rent_receipt, and stamp_duty_info).

🛠️ Customisation

• Templates – Edit the files in app/templates to customize the layout and wording of your generated agreements and receipts. Placeholders in curly braces (e.g., {landlord}, {rent}) will be replaced with the values provided in the JSON request.
• Stamp Duty Data – Modify the STAMP_DUTY_DATA dictionary in app/main.py to reflect accurate state‑wise stamp duty charges and links. This example includes a few states for illustration.
• Token Validation – Change the VALID_TOKEN constant in app/main.py to enforce your own bearer token. In a production environment, you should implement a proper authentication mechanism.

📄 License

This starter is provided as‑is for hackathon or educational use. You are welcome to modify and extend it to meet your specific requirements.