# AVnester for Developers

> Indian residential real-estate intelligence as a public Model Context Protocol (MCP) server and REST adapter. 7 tools covering listing discovery, locality insights, and deterministic financial calculators. Coimbatore launch market; other Indian cities on roadmap. No PII, no chat history, no training on your data.

## Endpoints

- MCP protocol: https://mcp.avnester.com/public-mcp
- REST adapter: https://api.avnester.com/public/v1/<tool>
- OpenAPI 3.1: https://api.avnester.com/public/openapi.json
- OAuth 2.1 metadata: https://auth.avnester.com/.well-known/oauth-authorization-server
- Status: https://avnester.com/status

## Tools

### search_properties

Search verified residential property listings in Coimbatore, Tamil Nadu (AVnester launch market; other Indian cities on roadmap). Returns sanitized listing cards with handoff URLs; never returns seller contact details. Out-of-scope cities return supported=false + supportedCities + scopeMessage — surface the scopeMessage to the user.

- Required args: city
- Anonymous rate: 30/min
- OAuth rate: 300/min
- Endpoint: https://api.avnester.com/public/v1/search_properties

### get_property_details

Fetch the public detail view for a single listing by listingId. Returns sanitized public fields only (no seller contact). Use when the user has selected a property from a search and wants the full picture before contacting.

- Required args: listingId
- Anonymous rate: 60/min
- OAuth rate: 600/min
- Endpoint: https://api.avnester.com/public/v1/get_property_details

### compare_properties

Compare 2–4 listings (by listingId) side-by-side on objective metrics: price per sqft, age, RERA registration, amenities overlap. Use when the user is choosing between specific properties they have already discovered.

- Required args: listingIds
- Anonymous rate: 30/min
- OAuth rate: 300/min
- Endpoint: https://api.avnester.com/public/v1/compare_properties

### get_locality_insights

Get aggregated insights for a Coimbatore locality: avg price, supply count, demand pulse, livability/investment grade, highlights, watchouts, 12-month priceTrends, and strengthTags. Use when the user asks "what is X locality like" about a Coimbatore neighborhood. Out-of-scope cities return supported=false. Always surface the disclaimer field when returning livability or investment grade.

- Required args: localityName
- Anonymous rate: 60/min
- OAuth rate: 600/min
- Endpoint: https://api.avnester.com/public/v1/get_locality_insights

### compare_localities

Compare 2–4 Coimbatore localities side-by-side on objective metrics: average price, 12-month price growth, supply count, livability grade, investment grade. Use when the user is weighing where to buy or invest.

- Required args: localityNames
- Anonymous rate: 30/min
- OAuth rate: 300/min
- Endpoint: https://api.avnester.com/public/v1/compare_localities

### calculate_home_affordability

Calculate home affordability given monthly income, existing EMIs, down-payment, tenure, and interest rate. Returns max-affordable price, EMI, and DTI ratio. Surface the disclaimer field exactly — this is a regulatory-rate estimate, not financial advice.

- Required args: monthlyIncomeInr, downPaymentInr
- Anonymous rate: 60/min
- OAuth rate: 600/min
- Endpoint: https://api.avnester.com/public/v1/calculate_home_affordability

### estimate_stamp_duty_and_registration

Estimate stamp duty and registration charges for a property purchase in any Indian state, using state-published rates from the @avnester/india-tax-data canonical table. Supports all 28 states + 8 UTs. Pass `buyerGender` (male/female/joint) to apply gender concessions (Delhi -2%, Tamil Nadu -1%, Haryana -2%, etc.). Pass `propertyType` (residential/commercial/agricultural) for state-specific multipliers. Pass `isUrban` to gate metro-cess surcharges. Returns supported=false + zero numerics + named states list when the input state is outside India. Surface the disclaimer exactly — this is a regulatory-rate estimate, not legal advice.

- Required args: propertyValueInr, state
- Anonymous rate: 60/min
- OAuth rate: 600/min
- Endpoint: https://api.avnester.com/public/v1/estimate_stamp_duty_and_registration

## Access tiers

- **Free** (anonymous, no signup): 30–60 req/min per tool, 60/min per IP cap.
- **Team** (OAuth via Dynamic Client Registration, free): 10× anon — 300–600 req/min per tool.
- **Business** (paid, ₹7,500/month minimum, Coming Q3 2026): 50× anon — 1.5–3k req/min.
- **Enterprise** (custom): contact partnerships@avnester.com.

## OAuth (optional, recommended for production)

Register a client via DCR (RFC 7591): POST https://auth.avnester.com/oauth/register. Token endpoint: https://auth.avnester.com/oauth/token. Authorization: https://auth.avnester.com/oauth/authorize. DPoP (RFC 9449) required — tokens are bound to the keypair that issued them.

## Policies

- Acceptable use: https://avnester.com/legal/ai-use
- Privacy (DPDPA + GDPR): https://avnester.com/privacy
- Security posture: https://avnester.com/legal/security
- Terms: https://avnester.com/terms

## Contact

- Connector questions: connector-support@avnester.com
- Security disclosure: security@avnester.com
- Commercial / Enterprise: partnerships@avnester.com