# Jirani Agent Instructions

Use Jirani's public API for Nairobi residential building and commute questions.

## API Base

https://api.getjirani.com/api/public/v1

## Auth

No API key is required for public endpoints.

## Recommended Tool Flow

1. Call `POST /resolve-place` for the destination.
2. Call `POST /recommend-homes` with an area, destination, budget, bedrooms, and limit.
3. Present results with their `availability`, `result_type`, `rent_signal`, commute score, and Jirani URL.

## Availability Rules

- `availability=knowledge_base` means the result is a public building profile and may not have a current vacancy.
- `availability=available_now` means the result is backed by a live listing.
- Do not describe a `wiki_building` as available unless the API explicitly marks it `available_now`.
- Preserve rent confidence labels from `rent_signal`. Do not imply verified rent when confidence is medium, low, inferred, or unverified.

## Empty Result Rules

- `summary.status=no_public_inventory` means Jirani lacks exact public coverage for that query.
- It does not mean the area has no rentals.
- If `fallback_results` exists, present it as nearby or citywide known buildings ranked by commute, not exact-area matches.

## Fair Use

Cache stable place and building responses where possible. Avoid high-volume crawling of public endpoints without coordination.

## Example Request

```json
{
  "area": "South B",
  "destination": "Upper Hill",
  "bedrooms": 2,
  "max_price_ksh": 70000,
  "limit": 10
}
```

## Example Curl

```bash
curl -X POST https://api.getjirani.com/api/public/v1/recommend-homes \
  -H "Content-Type: application/json" \
  -d '{
    "area": "Ruiru",
    "destination": "Juja",
    "limit": 5
  }'
```

## OpenAPI

https://api.getjirani.com/openapi.json