{
  "markdown": "# Tu Lugar MCP Server\n\nMCP server for [Tu Lugar](https://tulugar.com) — search real estate listings, development projects, companies, and market data in Paraguay and Latin America, straight from Claude, ChatGPT, Cursor, or any MCP client.\n\n**Website → [tulugar.com](https://tulugar.com)**  ·  **Connector docs & one-click setup → [tulugar.com/mcp](https://tulugar.com/mcp)**\n\n## Tools\n\n| Tool | Description |\n|------|-------------|\n| `search_listings` | Search listings by city, price, bedrooms, property type, etc. |\n| `get_listing` | Get full listing detail by ID or slug |\n| `search_projects` | Search development projects (verified first, available units) |\n| `get_project` | Get project detail with units, prices, and developer info |\n| `search_companies` | Search real estate agencies and developers |\n| `list_locations` | List countries, cities, or neighborhoods with listing counts |\n| `get_market_summary` | Market stats: avg price, median, price/m², counts |\n| `get_str_data` | Airbnb/STR city-level data: nightly rates, occupancy stats |\n| `mortgage_calculator` | Estimate monthly payment, total interest, and debt-to-income |\n\n> **This npm package is read-only.** To **create / edit / publish listings** or\n> **contact agents** (the agent + buyer write tools), connect the remote OAuth\n> connector instead — see [Remote connector (write access)](#claude-desktop-remote--write-access)\n> below. Writes require an authenticated Tu Lugar account and aren't available\n> over the local stdio transport.\n\n## Install\n\n### Claude Desktop (local)\n\nAdd to `~/Library/Application Support/Claude/claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"tulugar\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@tulugar/mcp-server\"]\n    }\n  }\n}\n```\n\n### Claude Desktop (remote — write access)\n\nSettings → Connectors → Add custom connector → URL: `https://tulugar.com/api/mcp`\n\nThe remote connector serves the same read tools **plus** the OAuth-gated write\ntools. Ask Claude to connect (or use the `connect_account` tool) and it runs the\nOAuth consent flow once so the connector can act on your behalf:\n\n- **Connect:** `account_status` (is my account connected / can I publish?),\n  `connect_account` (returns a one-tap link to connect your Tu Lugar account)\n- **Agents:** `create_listing`, `upload_listing_image`, `edit_listing`,\n  `publish_listing`, `my_listings`, `my_inquiries`,\n  `share_listing_whatsapp` (ready-to-send WhatsApp message + branded image for a listing)\n- **Buyers:** `create_lead` (contact an agent — works without an account)\n\n### Claude Code\n\n```bash\nclaude mcp add tulugar -- npx -y @tulugar/mcp-server\n```\n\n### Cursor / Windsurf\n\nSame JSON config format as Claude Desktop.\n\n## Example Queries\n\nOnce connected, try asking:\n\n- \"Find me a 2-bedroom apartment in Asuncion under $100,000\"\n- \"What are the average apartment prices in Villa Morra?\"\n- \"Show me development projects under construction\"\n- \"What's the Airbnb occupancy rate in Asuncion?\"\n- \"List verified real estate developers in Paraguay\"\n\n## Configuration\n\n| Env Variable | Default | Description |\n|-------------|---------|-------------|\n| `TULUGAR_API_URL` | `https://tulugar.com/api/v1` | API base URL |\n| `TULUGAR_SITE_URL` | `https://tulugar.com` | Site URL for listing links |\n\n## Links\n\n- [Connector home](https://tulugar.com/mcp)\n- [API Documentation](https://tulugar.com/developers)\n- [OpenAPI Spec](https://tulugar.com/api/v1/openapi.json)\n- [Tu Lugar](https://tulugar.com)\n\n## License\n\nMIT\n",
  "bytes": 3486,
  "sha": "ae6490a9220726679104395228768214f33fe934534a145e659c2e309535622f",
  "repo_slug": "jankratochvil1/tulugar-mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_com_tulugar_tulugar_f3961695/readme"
}