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

Tool	Description
`search_listings`	Search listings by city, price, bedrooms, property type, etc.
`get_listing`	Get full listing detail by ID or slug
`search_projects`	Search development projects (verified first, available units)
`get_project`	Get project detail with units, prices, and developer info
`search_companies`	Search real estate agencies and developers
`list_locations`	List countries, cities, or neighborhoods with listing counts
`get_market_summary`	Market stats: avg price, median, price/m², counts
`get_str_data`	Airbnb/STR city-level data: nightly rates, occupancy stats
`mortgage_calculator`	Estimate 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:

{
  "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

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 Variable	Default	Description
`TULUGAR_API_URL`	`https://tulugar.com/api/v1`	API base URL
`TULUGAR_SITE_URL`	`https://tulugar.com`	Site URL for listing links

License

MIT