Tu Lugar

com.tulugar由 tulugar.com 發布官方發布者v1.0.1更新於 Oct 25, 2026

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

已驗證Streamable HTTP可網頁執行溝通與協作資料與分析商業與電商

概覽

AI 產生的概覽

Tu Lugar 讓助理搜尋巴拉圭與拉美地區的房產物件、開發案、仲介與市場資料,並管理仲介自己的物件。

可以做什麼
搜尋並檢視物件、開發案、仲介公司、建商和仲介人員,結果中同時顯示其他仲介網站的物件。查詢地點與市場統計,例如平均價、中位價、每平方公尺價格、租金報酬率、交易費用和 Airbnb 入住率。閱讀關於購屋、租屋、外國人和刊登物件的指南。為已連結的仲介建立、編輯、刊登、關閉和推廣自己的物件,上傳圖片並查看詢問。代買方送出詢問、回覆潛在客戶、透過 WhatsApp 分享物件,以及儲存或刪除帶通知的搜尋。
適用情境
適合在巴拉圭與拉美進行房產搜尋與市場調查,也適合希望借助助理草擬、刊登和管理物件並回覆買方詢問的房產仲介。
執行需求
透過 streamable HTTP 連線到 tulugar.com 的遠端端點。寫入工具和儲存搜尋需要透過 OAuth 流程連結 Tu Lugar 帳號;刊登物件還需要已驗證的 WhatsApp 號碼。本機 npm 套件為唯讀,可選用 TULUGAR_API_URL 和 TULUGAR_SITE_URL 設定。
安裝前請注意
寫入工具會變更真實資料:publish_listing 是不可撤回的提交,close_listing 無法復原,promote_listing 會消耗一個付費額度。buy_promotional_credits 會回傳 Stripe 結帳連結,由使用者自行付款。create_lead 會透過電子郵件和 WhatsApp 向廣告方送出真實訊息。connect_account 和 open_web_session 會產生 10 分鐘內失效的一次性登入連結,只應交給使用者本人。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Tu Lugar,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/com.tulugar%2Ftulugar/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "tu-lugar": {
      "type": "http",
      "url": "https://tulugar.com/api/mcp"
    }
  }
}

README

Tu Lugar MCP Server

MCP server for Tu Lugar — search real estate listings, development projects, companies, and market data in Paraguay and Latin America, straight from Claude, ChatGPT, Cursor, or any MCP client.

Website → tulugar.com · Connector docs & one-click setup → tulugar.com/mcp

Tools

ToolDescription
search_listingsSearch listings by city, price, bedrooms, property type, etc.
get_listingGet full listing detail by ID or slug
search_projectsSearch development projects (verified first, available units)
get_projectGet project detail with units, prices, and developer info
search_companiesSearch real estate agencies and developers
list_locationsList countries, cities, or neighborhoods with listing counts
get_market_summaryMarket stats: avg price, median, price/m², counts
get_str_dataAirbnb/STR city-level data: nightly rates, occupancy stats
mortgage_calculatorEstimate monthly payment, total interest, and debt-to-income

This npm package is read-only. To create / edit / publish listings or contact agents (the agent + buyer write tools), connect the remote OAuth connector instead — see Remote connector (write access) below. Writes require an authenticated Tu Lugar account and aren't available over the local stdio transport.

Install

Claude Desktop (local)

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

json
{  "mcpServers": {    "tulugar": {      "command": "npx",      "args": ["-y", "@tulugar/mcp-server"]    }  }}

Claude Desktop (remote — write access)

Settings → Connectors → Add custom connector → URL: https://tulugar.com/api/mcp

The remote connector serves the same read tools plus the OAuth-gated write tools. Ask Claude to connect (or use the connect_account tool) and it runs the OAuth consent flow once so the connector can act on your behalf:

  • Connect: account_status (is my account connected / can I publish?), connect_account (returns a one-tap link to connect your Tu Lugar account)
  • Agents: create_listing, upload_listing_image, edit_listing, publish_listing, my_listings, my_inquiries, share_listing_whatsapp (ready-to-send WhatsApp message + branded image for a listing)
  • Buyers: create_lead (contact an agent — works without an account)

Claude Code

bash
claude mcp add tulugar -- npx -y @tulugar/mcp-server

Cursor / Windsurf

Same JSON config format as Claude Desktop.

Example Queries

Once connected, try asking:

  • "Find me a 2-bedroom apartment in Asuncion under $100,000"
  • "What are the average apartment prices in Villa Morra?"
  • "Show me development projects under construction"
  • "What's the Airbnb occupancy rate in Asuncion?"
  • "List verified real estate developers in Paraguay"

Configuration

Env VariableDefaultDescription
TULUGAR_API_URLhttps://tulugar.com/api/v1API base URL
TULUGAR_SITE_URLhttps://tulugar.comSite URL for listing links

Links

License

MIT

來源:README.md,提交 2cb957e

工具

39

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_listing

Get Listing

Get full listing detail by ID or slug.

輸入參數id必填

fetch

Fetch

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

Get Project

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_company

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_agent

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

輸入參數id必填

search_agents

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必填

rental_yield

Rental Yield

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

get_guide

TuLugar Guides

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.

無需輸入參數。

create_lead

Contact Agent

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

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

edit_listing

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

輸入參數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_listing

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

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.

輸入參數code必填

my_listings

My Listings

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

my_inquiries

My Inquiries

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

輸入參數limit

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.

輸入參數message必填inquiry_id必填

my_saved_searches

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

無需輸入參數。

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

版本歷史

1
  1. v1.0.1最新Sep 16, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分