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 分