Tu Lugar

Search real estate listings. Filter by city, price, bedrooms, property type, or a specific agency/company.

{
  "type": "object",
  "properties": {
    "city": {
      "type": "string",
      "description": "City name, e.g. \"Asunción\""
    },
    "neighborhood": {
      "type": "string"
    },
    "listing_type": {
      "type": "string",
      "enum": [
        "sale",
        "rent"
      ]
    },
    "property_type": {
      "type": "string",
      "description": "apartment, house, land, commercial"
    },
    "min_price": {
      "type": "number"
    },
    "max_price": {
      "type": "number"
    },
    "bedrooms": {
      "type": "number"
    },
    "company": {
      "type": "string",
      "description": "Agency/company NAME to list only their properties, e.g. \"RE/MAX Urbana\" (resolved automatically; punctuation/accents ignored)."
    },
    "building": {
      "type": "string",
      "description": "Building/tower NAME to list the actual units for sale/rent in it, e.g. \"Petra Tower\" (punctuation/accents ignored). Use this — not search_projects — when the user wants the real listings in a named building."
    },
    "amenities": {
      "type": "string",
      "description": "Comma-separated amenities/features the property must have, in the user's own words and language, e.g. \"piscina, cochera\" or \"pool, gym\". Common ones: pool/piscina, gym/gimnasio, garden/jardín, balcony/balcón, terrace/terraza, parking/cochera, furnished/amoblado, airConditioning/aire, security/seguridad, elevator/ascensor, bbq/parrilla/quincho, laundry/lavadero. Multiple = must have all."
    },
    "sort": {
      "type": "string",
      "enum": [
        "price_asc",
        "price_desc",
        "newest",
        "oldest"
      ]
    },
    "limit": {
      "type": "number",
      "description": "Max 20"
    }
  }
}

Get full listing detail by ID or slug.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    }
  },
  "required": [
    "id"
  ]
}

Search Tu Lugar real estate listings by free-text query (location, neighborhood, or keywords). Returns a list of matching listings with id, title, and URL. Use `fetch` to get a listing's full content.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Search phrase, e.g. \"apartment in Villa Morra\" or \"Encarnación\""
    }
  },
  "required": [
    "query"
  ]
}

Retrieve the full content of a single Tu Lugar listing by its id (from a `search` result). Returns title, full text description, specs, and the canonical URL.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Listing id returned by `search`."
    }
  },
  "required": [
    "id"
  ]
}

Search development projects/buildings BY NAME (or city, or DEVELOPER). Use `q` with the project or building name — e.g. q="Petra Tower" — punctuation/accents ignored, and a name lookup also finds completed/sold-out buildings. This is how you answer "apartments in <building/tower name>" and "is there a project called X". For "projects by <developer>" use `company` with the developer's name (NOT `q` — project names rarely contain the developer).

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "Project/building name (partial ok; punctuation/accents ignored)"
    },
    "company": {
      "type": "string",
      "description": "Developer/company name to list that developer's projects, e.g. \"Pro Invest\""
    },
    "city": {
      "type": "string"
    },
    "status": {
      "type": "string",
      "enum": [
        "pre_sale",
        "construction",
        "completed"
      ]
    },
    "verified": {
      "type": "boolean"
    },
    "min_price": {
      "type": "number"
    },
    "max_price": {
      "type": "number"
    },
    "sort": {
      "type": "string",
      "enum": [
        "recommended",
        "newest",
        "price_asc",
        "price_desc",
        "units"
      ]
    },
    "limit": {
      "type": "number"
    }
  }
}

Get project detail with units and prices.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    }
  },
  "required": [
    "id"
  ]
}

Search agencies and developers BY NAME (or city/type). Use `q` with the company/agency name — e.g. q="RE/MAX Urbana" — punctuation and accents are ignored. This is how you answer "properties by <agency>" (find the company here, then search_listings with company set to its name; for a DEVELOPER also check search_projects with company set — developer inventory is usually projects/units, not listings).

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "Company/agency name (partial ok; punctuation/accents ignored)"
    },
    "type": {
      "type": "string",
      "enum": [
        "agency",
        "developer"
      ]
    },
    "city": {
      "type": "string"
    },
    "verified": {
      "type": "boolean"
    },
    "limit": {
      "type": "number"
    }
  }
}

Get details about one agency or developer by id or slug (from search_companies): profile, rating, specialties, languages, service areas, and contact info.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Company id or slug"
    }
  },
  "required": [
    "id"
  ]
}

Get details about one real estate agent by id or slug: profile, rating, reviews, specialties, and contact info.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Agent id or slug"
    }
  },
  "required": [
    "id"
  ]
}

Search REGISTERED real-estate agents and professionals on Tu Lugar by name, city, or company. Only covers people who created a public profile on the platform — there is no data about anyone else.

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "Agent name (or part of it)"
    },
    "city": {
      "type": "string"
    },
    "company_id": {
      "type": "string"
    },
    "verified": {
      "type": "boolean",
      "description": "Only verified agents"
    },
    "limit": {
      "type": "number",
      "description": "Max 20"
    }
  }
}

List countries, cities, or neighborhoods with listing counts.

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "enum": [
        "countries",
        "cities",
        "neighborhoods"
      ]
    },
    "parent_id": {
      "type": "string",
      "description": "country_id for cities, city_id for neighborhoods"
    },
    "city": {
      "type": "string",
      "description": "City name for neighborhoods (alternative to parent_id)"
    }
  },
  "required": [
    "type"
  ]
}

Market stats: avg price, median, price/m². Scope with neighborhood for zone-level numbers.

{
  "type": "object",
  "properties": {
    "country": {
      "type": "string"
    },
    "city": {
      "type": "string"
    },
    "neighborhood": {
      "type": "string",
      "description": "Neighborhood/barrio name for zone-scoped stats"
    },
    "property_type": {
      "type": "string",
      "enum": [
        "apartment",
        "house",
        "land",
        "commercial"
      ]
    },
    "listing_type": {
      "type": "string",
      "enum": [
        "sale",
        "rent"
      ]
    }
  }
}

What a neighborhood/zone is actually like, grounded in live data: sale + rent prices, listing counts, Airbnb occupancy when available, plus curated local context. ALWAYS use this for "¿cómo es <barrio>?" / "is X a good area?" questions instead of answering from memory.

{
  "type": "object",
  "properties": {
    "neighborhood": {
      "type": "string",
      "description": "Neighborhood/barrio name (accents optional)"
    },
    "city": {
      "type": "string",
      "description": "City the neighborhood belongs to (recommended)"
    },
    "country": {
      "type": "string"
    }
  },
  "required": [
    "neighborhood"
  ]
}

Gross rental yield for a zone, computed from live medians (sale vs long-term rent, plus Airbnb when available). Zone-level market reference ONLY — never a valuation of a specific property. Use for "¿conviene invertir?" / rentabilidad / yield questions.

{
  "type": "object",
  "properties": {
    "city": {
      "type": "string",
      "description": "City (required)"
    },
    "neighborhood": {
      "type": "string",
      "description": "Optional neighborhood scope; falls back to the city when data is thin"
    },
    "property_type": {
      "type": "string",
      "enum": [
        "apartment",
        "house"
      ],
      "description": "Default apartment"
    },
    "country": {
      "type": "string"
    }
  },
  "required": [
    "city"
  ]
}

Official TuLugar closing-costs breakdown for buying property in PARAGUAY: transfer tax, municipal fees, notary/registry, optional mortgage fixed costs, seller broker fee. Use when the user asks what buying costs beyond the price, or to budget cash-at-closing for a concrete price.

{
  "type": "object",
  "properties": {
    "price_usd": {
      "type": "number",
      "description": "Property price in USD (use this OR price_gs)"
    },
    "price_gs": {
      "type": "number",
      "description": "Property price in guaraníes"
    },
    "include_mortgage_costs": {
      "type": "boolean",
      "description": "Include bank appraisal/title/notary fixed fees (default true)"
    }
  }
}

Curated TuLugar guides (general education, kept current): buying-process (step-by-step + documents), foreigners (rights + restrictions for non-Paraguayans), closing-costs (what fees exist), renting (contracts, deposits, garante), publishing (listing tips), airbnb (short-term rental basics). ALWAYS use this for "how does buying/renting work" / process / documents questions — the content IS in scope to share; only personalized legal advice is not.

{
  "type": "object",
  "properties": {
    "topic": {
      "type": "string",
      "enum": [
        "buying-process",
        "foreigners",
        "closing-costs",
        "renting",
        "publishing",
        "airbnb"
      ]
    }
  },
  "required": [
    "topic"
  ]
}

Airbnb/STR city-level data: nightly rates, occupancy.

{
  "type": "object",
  "properties": {
    "city": {
      "type": "string",
      "description": "City name or slug, accents optional (e.g. \"Asunción\" or \"asuncion\")"
    },
    "country": {
      "type": "string",
      "description": "Country name or slug — disambiguates duplicate city names across countries"
    },
    "neighborhood": {
      "type": "string",
      "description": "Neighborhood name for specific area stats"
    }
  }
}

Estimate a monthly mortgage payment and total interest for a buyer. Currency-agnostic. Optionally pass monthly_income for a debt-to-income ratio. This is an informational arithmetic estimate only — not financial advice, a loan offer, or a rate quote.

{
  "type": "object",
  "properties": {
    "principal": {
      "type": "number",
      "description": "Loan amount"
    },
    "annual_rate": {
      "type": "number",
      "description": "Annual interest rate, as a decimal (0.065) or percent (6.5)"
    },
    "term_years": {
      "type": "number",
      "description": "Loan term in years (1–50)"
    },
    "monthly_income": {
      "type": "number",
      "description": "Optional — enables a debt-to-income ratio"
    }
  },
  "required": [
    "principal",
    "annual_rate",
    "term_years"
  ]
}

REPORT-ONLY status check: returns whether the user's Tu Lugar account is connected and whether they can publish (needs a verified WhatsApp number). It does NOT and CANNOT start a connection. If the user asks to connect / authorize / log in / sign in, or wants to create a listing while not connected, call `connect_account` instead — that is the tool that opens the Approve prompt. Use account_status only when you purely want to know the current state. Never tell the user to merely visit the login page to authorize Claude — connecting is a one-time Approve, not a website login.

{
  "type": "object",
  "properties": {}
}

Send an inquiry on behalf of the user to the advertiser of a listing, a development project, or a real-estate company. Notifies them (email + WhatsApp) and starts a conversation. Works without an account. This sends a real message to real people — confirm the details with the user before calling.

{
  "type": "object",
  "properties": {
    "listing_id": {
      "type": "string",
      "description": "Listing to inquire about (exactly one of listing_id / project_id / company_id)"
    },
    "project_id": {
      "type": "string",
      "description": "Development project to inquire about"
    },
    "company_id": {
      "type": "string",
      "description": "Company/agency to contact directly"
    },
    "name": {
      "type": "string",
      "description": "Buyer name"
    },
    "email": {
      "type": "string",
      "description": "Buyer email (email or phone required)"
    },
    "phone": {
      "type": "string",
      "description": "Buyer phone / WhatsApp (email or phone required)"
    },
    "message": {
      "type": "string",
      "description": "The inquiry message"
    }
  },
  "required": [
    "name",
    "message"
  ]
}

Give the signed-in user a ONE-TAP link that opens tulugar.com already logged in to their account — no code, no password. Use when a WhatsApp user needs the website: upload photos, finish a listing in the wizard, manage their account. The link is single-use and expires in 10 minutes; share it verbatim. Only works for accounts with a verified WhatsApp number.

{
  "type": "object",
  "properties": {
    "return_to": {
      "type": "string",
      "description": "Optional site path to land on (e.g. \"/es/account/listings\"). Defaults to the account home."
    }
  }
}

Attach a real email address to the signed-in user's phone-keyed TuLugar account (accounts created via WhatsApp have no usable email). Sends a confirmation link TO that email; the user must open it — the link proves they own the address. Ask for the email, confirm it back to them, then call this. Only works for accounts that do not have a real email yet; if the email belongs to another account, the tool explains the options (never merges silently).

{
  "type": "object",
  "properties": {
    "email": {
      "type": "string",
      "description": "The email address the user wants to attach"
    }
  },
  "required": [
    "email"
  ]
}

THE tool to connect/authorize the user's Tu Lugar account. Call this IMMEDIATELY (without first calling account_status) whenever the user asks to "connect", "authorize", "link", "log in to", or "sign in to" Tu Lugar, or wants to create/manage a listing while not connected — do NOT wait for them to create a listing first. When not connected, it returns a clickable "Connect your Tu Lugar account" link — show that link to the user verbatim and tell them to open it (one click if they are already signed in at tulugar.com; no separate Approve step). After they open it they are connected — they can then ask you again. If already connected, it confirms who they are connected as. account_status only REPORTS status and can never start this.

{
  "type": "object",
  "properties": {}
}

Create a real estate listing for the authenticated agent. Always creates a private DRAFT — it is NOT visible publicly. A city or neighborhood is enough to start; NEVER invent coordinates (fabricated pins are discarded). The response returns an edit-page link with a map: ask the user to open it and drop the pin on the exact property location, and wait for their confirmation before publish_listing — publishing is blocked until a human sets the pin and at least one photo. Requires a CONNECTED account with a verified WhatsApp number — if unsure, call account_status FIRST and, if not connected, share the connect steps it returns instead of attempting to create.

{
  "type": "object",
  "properties": {
    "listing_type": {
      "type": "string",
      "enum": [
        "sale",
        "rent"
      ]
    },
    "property_type": {
      "type": "string",
      "enum": [
        "apartment",
        "house",
        "land",
        "commercial"
      ]
    },
    "price_amount": {
      "type": "number",
      "description": "Price (positive number)"
    },
    "price_currency": {
      "type": "string",
      "enum": [
        "USD",
        "PYG",
        "BRL",
        "ARS",
        "UYU"
      ],
      "description": "Use the currency local to the market (e.g. PYG in Paraguay, UYU or USD in Uruguay, ARS in Argentina, BRL in Brazil). Defaults to PYG if omitted."
    },
    "source_language": {
      "type": "string",
      "enum": [
        "es",
        "en",
        "pt"
      ],
      "description": "Language the title/description are written in"
    },
    "description": {
      "type": "string"
    },
    "location": {
      "type": "object",
      "description": "Listing location. The country/market is inferred from the city and coordinates — use real place names so it resolves correctly (e.g. Asunción → Paraguay, Montevideo → Uruguay, Buenos Aires → Argentina, Curitiba → Brazil). For a draft, a city or neighborhood is enough; the owner sets the exact pin on the web. Provide latitude/longitude ONLY if you have precise coordinates — never guess them.",
      "properties": {
        "city": {
          "type": "string",
          "description": "City name, e.g. \"Asunción\", \"Montevideo\", \"Curitiba\""
        },
        "neighborhood": {
          "type": "string",
          "description": "Neighborhood name, e.g. \"Villa Morra\", \"Pocitos\""
        },
        "state_province": {
          "type": "string",
          "description": "State / province / department, e.g. \"Central\", \"Maldonado\", \"Buenos Aires\", \"Paraná\""
        },
        "address": {
          "type": "string",
          "description": "Street address if known (min 5 chars)"
        },
        "latitude": {
          "type": "number",
          "description": "Precise latitude. Omit if unknown."
        },
        "longitude": {
          "type": "number",
          "description": "Precise longitude. Omit if unknown."
        }
      }
    },
    "images": {
      "type": "array",
      "items": {
        "type": "string",
        "description": "Image URL (use upload_listing_image to get hosted URLs)"
      },
      "description": "Up to 25 image URLs. Optional for a draft; at least one is required to publish."
    },
    "apartment_details": {
      "type": "object",
      "description": "Bedrooms/bathrooms/area for the property.",
      "properties": {
        "bedrooms": {
          "type": "number"
        },
        "bathrooms": {
          "type": "number"
        },
        "area_sqm": {
          "type": "number",
          "description": "Built / land area in square meters"
        }
      }
    },
    "house_details": {
      "type": "object",
      "description": "Bedrooms/bathrooms/area for the property.",
      "properties": {
        "bedrooms": {
          "type": "number"
        },
        "bathrooms": {
          "type": "number"
        },
        "area_sqm": {
          "type": "number",
          "description": "Built / land area in square meters"
        }
      }
    },
    "land_details": {
      "type": "object",
      "description": "Bedrooms/bathrooms/area for the property.",
      "properties": {
        "bedrooms": {
          "type": "number"
        },
        "bathrooms": {
          "type": "number"
        },
        "area_sqm": {
          "type": "number",
          "description": "Built / land area in square meters"
        }
      }
    },
    "commercial_details": {
      "type": "object",
      "description": "Bedrooms/bathrooms/area for the property.",
      "properties": {
        "bedrooms": {
          "type": "number"
        },
        "bathrooms": {
          "type": "number"
        },
        "area_sqm": {
          "type": "number",
          "description": "Built / land area in square meters"
        }
      }
    }
  },
  "required": [
    "listing_type",
    "property_type",
    "price_amount",
    "source_language",
    "location"
  ]
}

Update one of the authenticated agent's listings. Pass only the fields to change. Editing images/title/description counts against the edit quota and re-triggers review. Also works on SYNCED listings (auto-imported from the agent's portal, marked synced:true in my_listings): everything is editable, and changing the price makes it stop auto-syncing — the agent's price then always wins over the portal's. Publish state of synced listings cannot be changed here (use close_listing).

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Listing ID to update"
    },
    "price_amount": {
      "type": "number"
    },
    "price_currency": {
      "type": "string",
      "enum": [
        "USD",
        "PYG",
        "BRL",
        "ARS",
        "UYU"
      ]
    },
    "description": {
      "type": "string"
    },
    "images": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "apartment_details": {
      "type": "object",
      "description": "Bedrooms/bathrooms/area for the property.",
      "properties": {
        "bedrooms": {
          "type": "number"
        },
        "bathrooms": {
          "type": "number"
        },
        "area_sqm": {
          "type": "number",
          "description": "Built / land area in square meters"
        }
      }
    },
    "house_details": {
      "type": "object",
      "description": "Bedrooms/bathrooms/area for the property.",
      "properties": {
        "bedrooms": {
          "type": "number"
        },
        "bathrooms": {
          "type": "number"
        },
        "area_sqm": {
          "type": "number",
          "description": "Built / land area in square meters"
        }
      }
    },
    "land_details": {
      "type": "object",
      "description": "Bedrooms/bathrooms/area for the property.",
      "properties": {
        "bedrooms": {
          "type": "number"
        },
        "bathrooms": {
          "type": "number"
        },
        "area_sqm": {
          "type": "number",
          "description": "Built / land area in square meters"
        }
      }
    },
    "commercial_details": {
      "type": "object",
      "description": "Bedrooms/bathrooms/area for the property.",
      "properties": {
        "bedrooms": {
          "type": "number"
        },
        "bathrooms": {
          "type": "number"
        },
        "area_sqm": {
          "type": "number",
          "description": "Built / land area in square meters"
        }
      }
    }
  },
  "required": [
    "id"
  ]
}

Submit a draft listing for moderation review, making it eligible to go public once approved. This is an irreversible submission — confirm with the user before calling.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Listing ID to submit for review"
    }
  },
  "required": [
    "id"
  ]
}

Close (retire) one of the authenticated agent's OWN listings — use when a property is sold, rented, or withdrawn from the market. It disappears from public results. This is NOT reversible (a closed listing cannot be reopened), so confirm with the user before calling. Pass the id from my_listings. Also works on SYNCED listings (synced:true): closing one stops the portal sync from reopening it.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "ID of the agent's own listing to close (from my_listings)"
    }
  },
  "required": [
    "id"
  ]
}

Upload a listing image by URL. Fetches the image, optimizes it, and returns hosted Tu Lugar image URLs to pass into create_listing.images[] or edit_listing.images[]. Rejected if the image fails property-photo moderation.

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "Public https URL of the source image"
    }
  },
  "required": [
    "url"
  ]
}

Send a WhatsApp verification code to the agent's mobile number. Publishing listings requires a verified WhatsApp number — if account_status shows can_publish=false, use this to start verification. A 6-digit code is delivered to the number over WhatsApp; then call verify_whatsapp_code with it.

{
  "type": "object",
  "properties": {
    "phone": {
      "type": "string",
      "description": "Mobile number in international format, e.g. +595981234567"
    },
    "language": {
      "type": "string",
      "enum": [
        "es",
        "en",
        "pt"
      ],
      "description": "Message language (default es)"
    }
  },
  "required": [
    "phone"
  ]
}

Complete WhatsApp verification by submitting the 6-digit code the agent received on WhatsApp (after send_whatsapp_verification). On success the account can publish listings.

{
  "type": "object",
  "properties": {
    "code": {
      "type": "string",
      "description": "The 6-digit code sent to the WhatsApp number"
    }
  },
  "required": [
    "code"
  ]
}

List the authenticated agent's own listings across all statuses (draft, pending review, active, closed), so they can see what is live and what is awaiting moderation. Includes SYNCED listings (auto-imported from the agent's portal and kept up to date automatically) — those carry synced:true plus a sync block with the source platform, source URL and last check time. Synced listings can be edited, promoted and closed like any other.

{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "enum": [
        "draft",
        "active",
        "closed",
        "completed"
      ],
      "description": "Optional status filter"
    },
    "limit": {
      "type": "number",
      "description": "Max 100 (default 50)"
    }
  }
}

List buyer inquiries (leads) received on the authenticated agent's listings, newest first.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "number",
      "description": "Max 100 (default 50)"
    }
  }
}

Reply to a buyer inquiry (lead) on one of the agent's listings. Compose a helpful, professional reply as `message`, and this returns a one-tap WhatsApp link (wa.me) to the buyer with your message pre-filled — share that link with the agent to tap and send. Pass inquiry_id from my_inquiries. If the buyer left only an email, it returns the email to reply to instead.

{
  "type": "object",
  "properties": {
    "inquiry_id": {
      "type": "string",
      "description": "The inquiry/lead id (from my_inquiries)"
    },
    "message": {
      "type": "string",
      "description": "The reply to send to the buyer"
    }
  },
  "required": [
    "inquiry_id",
    "message"
  ]
}

Save a property search for the connected user so they get alerts when new matching listings appear (e.g. "2-bed apartments for rent under $800 in Villa Morra"). Requires a connected account — if not connected, use connect_account first. Uses the same filters as search_listings. Returns the saved id.

{
  "type": "object",
  "properties": {
    "listing_type": {
      "type": "string",
      "enum": [
        "sale",
        "rent"
      ]
    },
    "city": {
      "type": "string"
    },
    "neighborhood": {
      "type": "string"
    },
    "property_type": {
      "type": "string",
      "enum": [
        "apartment",
        "house",
        "land",
        "commercial"
      ]
    },
    "min_price": {
      "type": "number"
    },
    "max_price": {
      "type": "number"
    },
    "bedrooms": {
      "type": "number"
    },
    "currency": {
      "type": "string",
      "enum": [
        "USD",
        "PYG",
        "BRL",
        "ARS",
        "UYU"
      ]
    },
    "alert_frequency": {
      "type": "string",
      "enum": [
        "instant",
        "daily",
        "weekly"
      ],
      "description": "How often to be alerted about new matches (default daily)"
    },
    "name": {
      "type": "string",
      "description": "Optional label for the saved search"
    }
  },
  "required": [
    "listing_type"
  ]
}

List the connected user's saved searches and their alert settings.

{
  "type": "object",
  "properties": {}
}

Delete one of the connected user's saved searches by id (stops its alerts).

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Saved search id (from my_saved_searches)"
    }
  },
  "required": [
    "id"
  ]
}

Promote (feature) one of the authenticated agent's OWN listings by spending ONE promotional credit. A featured listing is highlighted and ranked ahead of regular results for ~14 days (extends the window if already featured). This SPENDS a paid credit, so confirm with the user before calling. If the account has no credits, this returns a message telling the user to buy some — use buy_promotional_credits for that. Pass listing_id from my_listings. Synced listings (synced:true) are promotable too.

{
  "type": "object",
  "properties": {
    "listing_id": {
      "type": "string",
      "description": "ID of the agent's own listing to feature (from my_listings)"
    }
  },
  "required": [
    "listing_id"
  ]
}

Start a purchase of a promotional-credit pack for the connected account. Returns a secure Stripe checkout link that the USER opens to pay — you never handle card details, and payment happens on Stripe's page, not here. After they pay, the credits are added to their account and can be spent with promote_listing. One pack = 5 credits (each promotes one property for ~14 days).

{
  "type": "object",
  "properties": {
    "locale": {
      "type": "string",
      "enum": [
        "es",
        "en",
        "pt"
      ],
      "description": "Language for the checkout page (default es)"
    }
  }
}

Generate a ready-to-send WhatsApp message for one of the authenticated agent's OWN listings: a polished, WhatsApp-tuned caption + a one-tap wa.me link (optionally pre-addressed to a client phone) + the property's main photo to attach. Use whenever the agent wants to send, share, or forward a listing to a client (or to their WhatsApp status). Pass listing_id (from my_listings); optionally client_phone to pre-address the chat. After calling, you can personalize the message for a specific client and rebuild the wa.me link yourself (URL-encode the new text into https://wa.me/<number>?text=...).

{
  "type": "object",
  "properties": {
    "listing_id": {
      "type": "string",
      "description": "ID of the agent's own listing (from my_listings)"
    },
    "client_phone": {
      "type": "string",
      "description": "Optional client phone, international format (e.g. +595981234567), to pre-address the WhatsApp chat"
    },
    "locale": {
      "type": "string",
      "enum": [
        "es",
        "en",
        "pt"
      ],
      "description": "Message language (default es)"
    }
  },
  "required": [
    "listing_id"
  ]
}