Tu Lugar

Measured conclusion: Alive, not deep-tested. L2 outcome: not_attempted.

Search and manage Paraguay & LatAm real estate from any AI assistant.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "Tu Lugar": {
      "url": "https://tulugar.com/api/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (39)

• search_listings read-only

  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.

  Parameters:

  • city — string — City name only, e.g. "Asunción" — never with the country in it
  • sort — string
  • limit — number — Max 20
  • company — string — Agency/company NAME to list only their properties, e.g. "RE/MAX Urbana" (resolved automatically; punctuation/accents ignored).
  • country — string — Country name whenever the user gives it or it is clear, e.g. "Costa Rica" for "San José Costa Rica", "Argentina" for "Córdoba, Argentina".
  • bedrooms — number
  • building — string — 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.
  • map_zoom — number — Zoom of the interactive map this search opens/moves (5 country · 11 metro area · 13 city · 15 barrio · 17 streets). Omit normally; set it only when the user asks to zoom in/out or for a wider/closer view — start from the zoom in the page they are on and step ±2.
  • amenities — string — 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.
  • max_price — number
  • min_price — number
  • listing_type — string
  • neighborhood — string
  • property_type — string — apartment, house, land, commercial
  • price_currency — string — Currency of min_price/max_price: USD (default), PYG, ARS, BRL, MXN … — e.g. PYG for "hasta Gs. 3.000.000".

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world not declared

• get_listing read-only

  Get full listing detail by ID or slug.

  Parameters:

  • id (required) — string

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world not declared

• search read-only

  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.

  Parameters:

  • query (required) — string — Search phrase, e.g. "apartment in Villa Morra" or "Encarnación"

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world yes

• fetch read-only

  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.

  Parameters:

  • id (required) — string — Listing id returned by `search`.

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world not declared

• search_projects read-only

  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).

  Parameters:

  • q — string — Project/building name (partial ok; punctuation/accents ignored)
  • city — string
  • sort — string
  • limit — number
  • status — string
  • company — string — Developer/company name to list that developer's projects, e.g. "Pro Invest"
  • verified — boolean
  • max_price — number
  • min_price — number

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world not declared

• get_project read-only

  Get project detail with units and prices.

  Parameters:

  • id (required) — string

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world not declared

• search_companies read-only

  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).

  Parameters:

  • q — string — Company/agency name (partial ok; punctuation/accents ignored)
  • city — string
  • type — string
  • limit — number
  • verified — boolean

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world not declared

• get_company read-only

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

  Parameters:

  • id (required) — string — Company id or slug

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world not declared

• get_agent read-only

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

  Parameters:

  • id (required) — string — Agent id or slug

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world not declared

• search_agents read-only

  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.

  Parameters:

  • q — string — Agent name (or part of it)
  • city — string
  • limit — number — Max 20
  • verified — boolean — Only verified agents
  • company_id — string

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world not declared

• list_locations read-only

  List countries, cities, or neighborhoods with listing counts.

  Parameters:

  • type (required) — string
  • city — string — City name for neighborhoods (alternative to parent_id)
  • parent_id — string — country_id for cities, city_id for neighborhoods

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world not declared

• get_market_summary read-only

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

  Parameters:

  • city — string
  • country — string
  • listing_type — string
  • neighborhood — string — Neighborhood/barrio name for zone-scoped stats
  • property_type — string

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world not declared

• neighborhood_guide read-only

  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.

  Parameters:

  • neighborhood (required) — string — Neighborhood/barrio name (accents optional)
  • city — string — City the neighborhood belongs to (recommended)
  • country — string

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world not declared

• rental_yield read-only

  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.

  Parameters:

  • city (required) — string — City (required)
  • country — string
  • neighborhood — string — Optional neighborhood scope; falls back to the city when data is thin
  • property_type — string — Default apartment

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world not declared

• closing_costs read-only

  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.

  Parameters:

  • price_gs — number — Property price in guaraníes
  • price_usd — number — Property price in USD (use this OR price_gs)
  • include_mortgage_costs — boolean — Include bank appraisal/title/notary fixed fees (default true)

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world not declared

• get_guide read-only

  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.

  Parameters:

  • topic (required) — string

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world not declared

• get_str_data read-only

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

  Parameters:

  • city — string — City name or slug, accents optional (e.g. "Asunción" or "asuncion")
  • country — string — Country name or slug — disambiguates duplicate city names across countries
  • neighborhood — string — Neighborhood name for specific area stats

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world not declared

• mortgage_calculator read-only

  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.

  Parameters:

  • principal (required) — number — Loan amount
  • annual_rate (required) — number — Annual interest rate, as a decimal (0.065) or percent (6.5)
  • term_years (required) — number — Loan term in years (1–50)
  • monthly_income — number — Optional — enables a debt-to-income ratio

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world not declared

• account_status read-only

  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.

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world not declared

• create_lead destructive

  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.

  Parameters:

  • name (required) — string — Buyer name
  • message (required) — string — The inquiry message
  • email — string — Buyer email (email or phone required)
  • phone — string — Buyer phone / WhatsApp (email or phone required)
  • company_id — string — Company/agency to contact directly
  • listing_id — string — Listing to inquire about (exactly one of listing_id / project_id / company_id)
  • project_id — string — Development project to inquire about

  Hints: read-only no · destructive yes · idempotent not declared · open-world yes

• open_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.

  Parameters:

  • return_to — string — Optional site path to land on (e.g. "/es/account/listings"). Defaults to the account home.

  Hints: read-only no · destructive no · idempotent not declared · open-world not declared

• link_email

  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).

  Parameters:

  • email (required) — string — The email address the user wants to attach

  Hints: read-only no · destructive no · idempotent not declared · open-world not declared

• connect_account read-only

  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.

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world yes

• 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.

  Parameters:

  • listing_type (required) — string
  • property_type (required) — string
  • price_amount (required) — number — Price (positive number)
  • source_language (required) — string — Language the title/description are written in
  • location (required) — object — 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.
  • images — array — Up to 25 image URLs. Optional for a draft; at least one is required to publish.
  • description — string
  • land_details — object — Bedrooms/bathrooms/area for the property.
  • house_details — object — Bedrooms/bathrooms/area for the property.
  • price_currency — string — 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.
  • apartment_details — object — Bedrooms/bathrooms/area for the property.
  • commercial_details — object — Bedrooms/bathrooms/area for the property.

  Hints: read-only no · destructive no · idempotent not declared · open-world yes

• edit_listing

  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).

  Parameters:

  • id (required) — string — Listing ID to update
  • images — array
  • description — string
  • land_details — object — Bedrooms/bathrooms/area for the property.
  • price_amount — number
  • house_details — object — Bedrooms/bathrooms/area for the property.
  • price_currency — string
  • apartment_details — object — Bedrooms/bathrooms/area for the property.
  • commercial_details — object — Bedrooms/bathrooms/area for the property.

  Hints: read-only no · destructive no · idempotent not declared · open-world yes

• publish_listing destructive

  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.

  Parameters:

  • id (required) — string — Listing ID to submit for review

  Hints: read-only no · destructive yes · idempotent not declared · open-world yes

• close_listing destructive

  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.

  Parameters:

  • id (required) — string — ID of the agent's own listing to close (from my_listings)

  Hints: read-only no · destructive yes · idempotent not declared · open-world yes

• 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.

  Parameters:

  • url (required) — string — Public https URL of the source image

  Hints: read-only no · destructive no · idempotent not declared · open-world yes

• 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.

  Parameters:

  • phone (required) — string — Mobile number in international format, e.g. +595981234567
  • language — string — Message language (default es)

  Hints: read-only no · destructive no · idempotent not declared · open-world yes

• verify_whatsapp_code

  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.

  Parameters:

  • code (required) — string — The 6-digit code sent to the WhatsApp number

  Hints: read-only no · destructive no · idempotent not declared · open-world yes

• my_listings read-only

  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.

  Parameters:

  • limit — number — Max 100 (default 50)
  • status — string — Optional status filter

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world not declared

• my_inquiries read-only

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

  Parameters:

  • limit — number — Max 100 (default 50)

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world not declared

• reply_to_inquiry

  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.

  Parameters:

  • inquiry_id (required) — string — The inquiry/lead id (from my_inquiries)
  • message (required) — string — The reply to send to the buyer

  Hints: read-only no · destructive not declared · idempotent not declared · open-world yes

• save_search

  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.

  Parameters:

  • listing_type (required) — string
  • city — string
  • name — string — Optional label for the saved search
  • bedrooms — number
  • currency — string
  • max_price — number
  • min_price — number
  • neighborhood — string
  • property_type — string
  • alert_frequency — string — How often to be alerted about new matches (default daily)

  Hints: read-only no · destructive no · idempotent not declared · open-world yes

• my_saved_searches read-only

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

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world not declared

• delete_saved_search destructive

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

  Parameters:

  • id (required) — string — Saved search id (from my_saved_searches)

  Hints: read-only no · destructive yes · idempotent not declared · open-world yes

• promote_listing destructive

  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.

  Parameters:

  • listing_id (required) — string — ID of the agent's own listing to feature (from my_listings)

  Hints: read-only no · destructive yes · idempotent not declared · open-world yes

• 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).

  Parameters:

  • locale — string — Language for the checkout page (default es)

  Hints: read-only no · destructive no · idempotent not declared · open-world yes

• share_listing_whatsapp read-only

  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=...).

  Parameters:

  • listing_id (required) — string — ID of the agent's own listing (from my_listings)
  • locale — string — Message language (default es)
  • client_phone — string — Optional client phone, international format (e.g. +595981234567), to pre-address the WhatsApp chat

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world yes

Publisher website Repository

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.