search_listings
Search Listings
Search real estate listings. Filter by city, price, bedrooms, property type, or a specific agency/company. Returns TuLugar listings first, then "En otros sitios": homes on agency websites (RE/MAX, Century 21, Rent-A-House) in the same place, shown on the same map.
输入参数citysortlimitcompanycountrybedroomsbuildingmap_zoomamenitiesmax_pricemin_pricelisting_type另有 3 个
Get full listing detail by ID or slug.
输入参数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.
输入参数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.
输入参数id必填
search_projects
Search Projects
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). For "projects / new buildings / en pozo in <city>" use `city` (add `status` when they say pre-sale or under construction).
输入参数qcitysortlimitstatuscompanyverifiedmax_pricemin_price
Get project detail with units and prices.
输入参数id必填
search_companies
Search Agencies & Developers
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).
输入参数qcitytypelimitverified
Get details about one agency or developer by id or slug (from search_companies): profile, rating, specialties, languages, service areas, and contact info.
输入参数id必填
Get details about one real estate agent by id or slug: profile, rating, reviews, specialties, and contact info.
输入参数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.
输入参数qcitylimitverifiedcompany_id
list_locations
List Locations
List countries, cities, or neighborhoods with listing counts.
输入参数citytype必填parent_id
get_market_summary
Market Summary
Market stats: avg price, median, price/m². Scope with neighborhood for zone-level numbers.
输入参数citycountrylisting_typeneighborhoodproperty_type
neighborhood_guide
Neighborhood Guide
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.
输入参数citycountryneighborhood必填
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.
输入参数city必填countryneighborhoodproperty_type
closing_costs
Closing Costs (Paraguay)
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.
输入参数price_gsprice_usdinclude_mortgage_costs
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.
输入参数topic必填
get_str_data
Short-Term Rental Data
Airbnb/STR city-level data: nightly rates, occupancy.
输入参数citycountryneighborhood
mortgage_calculator
Mortgage Calculator
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.
输入参数principal必填term_years必填annual_rate必填monthly_income
account_status
Account Status
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.
无需输入参数。
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.
输入参数name必填emailphonemessage必填company_idlisting_idproject_id
open_web_session
Open Signed-in Web Session
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.
输入参数return_to
link_email
Link Email to Account
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).
输入参数email必填
connect_account
Connect Tu Lugar Account
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.
无需输入参数。
create_listing
Create Listing
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.
输入参数imageslocation必填descriptionland_detailslisting_type必填price_amount必填house_detailsproperty_type必填price_currencysource_language必填apartment_detailscommercial_details
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).
输入参数id必填imagesdescriptionland_detailsprice_amounthouse_detailsprice_currencyapartment_detailscommercial_details
publish_listing
Publish Listing
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.
输入参数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.
输入参数id必填
upload_listing_image
Upload Listing Image
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.
输入参数url必填
send_whatsapp_verification
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.
输入参数phone必填language
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.
输入参数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.
输入参数limitstatus
List buyer inquiries (leads) received on the authenticated agent's listings, newest first.
输入参数limit
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.
输入参数message必填inquiry_id必填
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.
输入参数citynamebedroomscurrencymax_pricemin_pricelisting_type必填neighborhoodproperty_typealert_frequency
List the connected user's saved searches and their alert settings.
无需输入参数。
Delete one of the connected user's saved searches by id (stops its alerts).
输入参数id必填
promote_listing
Promote Listing
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.
输入参数listing_id必填
buy_promotional_credits
Buy Promotional Credits
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).
输入参数locale
share_listing_whatsapp
Share Listing on WhatsApp
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=...).
输入参数localelisting_id必填client_phone