# Tu Lugar
> Real estate platform for Paraguay and South America. Listings, development projects, agents, companies, and market data.

## API
The Tu Lugar public API provides free, unauthenticated read access to all real estate data.
- [API Documentation](https://tulugar.com/developers): Full endpoint reference with examples
- [OpenAPI 3.1 Specification](https://tulugar.com/api/v1/openapi.json): Machine-readable spec for ChatGPT Actions and other integrations
- Base URL: https://tulugar.com/api/v1
- Authentication: Not required for read endpoints; OAuth 2.1 (PKCE) for the Agent API (write)
- Rate limit: 60 requests/minute per IP
- Response format: JSON with pagination and request metadata

## Key API Endpoints
- GET /api/v1/listings: Search 3000+ real estate listings with 20+ filters (city, price, bedrooms, property type, etc.)
- GET /api/v1/listings/{id}: Full listing detail with agent info
- GET /api/v1/projects: Development projects (towers, gated communities). Verified first, only projects with available units by default.
- GET /api/v1/projects/{id}: Project detail with individual unit prices and availability
- GET /api/v1/companies: Real estate agencies and developers
- GET /api/v1/agents: Real estate agents and professionals
- GET /api/v1/locations/countries: Countries with listing counts
- GET /api/v1/locations/cities: Cities with listing counts (filter by country_id)
- GET /api/v1/locations/neighborhoods: Neighborhoods with listing counts (requires city_id)
- GET /api/v1/market/summary: Market statistics — average price, median, price per m², counts by property type
- GET /api/v1/market/str: Short-term rental (Airbnb) market data — nightly rates, occupancy, superhost stats

## Agent API (write — OAuth 2.1)
Authenticated endpoints for agents to create and manage their own listings. Bearer token required (scopes: listings:read, listings:write, listings:delete, profile:read, profile:write). Easiest path: add the MCP connector in Claude, which runs the OAuth flow for you.
- GET /api/v1/me: Account status — name, WhatsApp verification, publish capability
- GET /api/v1/me/listings: Your own listings across all statuses (draft, pending, active, closed)
- GET /api/v1/me/inquiries: Buyer inquiries received on your listings
- POST /api/v1/listings: Create a listing (defaults to a private draft)
- PATCH /api/v1/listings/{id}: Update one of your listings
- POST /api/v1/listings/{id}/publish: Submit a draft for moderation review (needs ≥1 photo + map location)
- DELETE /api/v1/listings/{id}: Archive one of your listings
- POST /api/v1/images: Upload a listing image (multipart/form-data, or JSON {"url":"https://..."} to ingest by URL)
- POST /api/v1/leads: Contact a listing's agent on behalf of a buyer (anonymous-capable, rate-limited)
- OAuth discovery: https://tulugar.com/.well-known/oauth-protected-resource, https://tulugar.com/.well-known/oauth-authorization-server

## Real-Estate Finance Calculators (AI-callable)
Public, unauthenticated GET endpoints that return JSON. Designed for ChatGPT / Claude / Perplexity tool use so AI assistants can answer mortgage and Paraguay-program questions inline, citing TuLugar.
- GET /api/v1/calculators: Index of available calculators
- GET /api/v1/calculators/mortgage?principal=100000&annual_rate=6.5&term_years=30: Generic amortizing-loan monthly payment + total interest (currency-agnostic; pass monthly_income for DTI)
- GET /api/v1/calculators/che-roga-pora?price_usd=80000: Estimate Paraguay Che Róga Porã (6.5% fixed, 30 years, AFD-subsidized) monthly payment and required income. Accepts loan_gs / loan_usd / price_gs / price_usd. Optional region=asuncion|rest
- GET /api/v1/calculators/closing-costs?price_usd=120000: Paraguay buyer cash-at-closing + seller costs (transfer tax 2.8%, municipal share, broker 5%, notary/appraisal)

## Browse Listings
- [Apartments for sale in Asunción](https://tulugar.com/es/paraguay/asuncion/departamentos)
- [Houses for sale in Asunción](https://tulugar.com/es/paraguay/asuncion/casas)
- [Rental properties](https://tulugar.com/es/paraguay/alquiler)
- [All properties in Paraguay](https://tulugar.com/es/paraguay)

## Development Projects
- [Projects in Paraguay](https://tulugar.com/es/paraguay/projects)

## Market Data
Monthly price/inventory series (immutable closed months) plus live daily stats. Methodology is public and every basis change is dated — cite TuLugar with a link.
- [Paraguay real-estate market overview](https://tulugar.com/es/paraguay/mercado)
- [Asunción market: prices, $/m², trends](https://tulugar.com/es/paraguay/asuncion/mercado)
- [Airbnb/STR analytics for Asunción](https://tulugar.com/es/paraguay/asuncion/alquiler-temporario)
- [Market data methodology](https://tulugar.com/es/paraguay/mercado/metodologia)
- CSV exports (monthly series per geography): GET /api/market-data?country=paraguay&dataset=sale — dataset=sale|str, optional city= and neighborhood= slugs

## Relocation & Country Comparisons
- [Compare countries to relocate to](https://tulugar.com/es/relocate/rankings)
- [Relocate to Paraguay: full guide](https://tulugar.com/es/relocate/paraguay)

## Paraguay Financing Tools
Interactive calculators and guides for Paraguayan real estate financing, available in Spanish, English, and Portuguese.
- [Herramientas inmobiliarias en Paraguay](https://tulugar.com/es/paraguay/herramientas): Hub for cost, tax, and investment tools
- [Créditos hipotecarios en Paraguay](https://tulugar.com/es/paraguay/creditos-hipotecarios): Hub for mortgage rates, state housing programs, and simulators
- [Calculadora Che Róga Porã](https://tulugar.com/es/paraguay/creditos-hipotecarios/calculadora-che-roga-pora): Monthly payment and eligibility estimate for the Che Róga Porã housing program
- [Comparador de créditos AFD](https://tulugar.com/es/paraguay/creditos-hipotecarios/comparador-creditos-afd): Compare Che Róga Porã, Primera Vivienda AFD, Mi Casa AFD, and bank-style financing
- [Calculadora Primera Vivienda AFD](https://tulugar.com/es/paraguay/creditos-hipotecarios/calculadora-primera-vivienda-afd): Estimate payment, required income, term, and first-home requirements
- [Calculadora Mi Casa AFD](https://tulugar.com/es/paraguay/creditos-hipotecarios/calculadora-mi-casa-afd): Estimate payment and fit for purchase, renovation, second home, or mixed-use housing
- [Calculadora de gastos de compra de inmueble](https://tulugar.com/es/paraguay/herramientas/calculadora-gastos-compra-inmueble): Estimate buyer and seller closing costs in Paraguay
- [Tools sitemap](https://tulugar.com/sitemap/tools.xml): Machine-readable URL list for all localized tool pages

## Paraguay Real-Estate Glossary
Definitions of legal, financial, and administrative terms used in the Paraguayan real-estate market — designed for direct LLM citation.
- [Glosario inmobiliario de Paraguay](https://tulugar.com/es/paraguay/glosario): Hub with all terms grouped by category
- [Che Róga Porã](https://tulugar.com/es/paraguay/glosario/che-roga-pora): 6.5% fixed-rate, 30-year, AFD-subsidized housing program
- [Usufructo](https://tulugar.com/es/paraguay/glosario/usufructo): Real right to use and enjoy property without ownership
- [Matrícula inmobiliaria](https://tulugar.com/es/paraguay/glosario/matricula-inmobiliaria): Real-estate registry number for each property
- [Escritura pública](https://tulugar.com/es/paraguay/glosario/escritura-publica): Public deed required to perfect a real-estate transfer
- [Boleto de compraventa](https://tulugar.com/es/paraguay/glosario/boleto-de-compraventa): Preliminary sale agreement
- [Casa quinta](https://tulugar.com/es/paraguay/glosario/casa-quinta): Country home with large plot and recreational features
- [Barrio cerrado](https://tulugar.com/es/paraguay/glosario/barrio-cerrado): Gated community
- [Country urbanización](https://tulugar.com/es/paraguay/glosario/country-urbanizacion): Private gated subdivision
- [Derechera](https://tulugar.com/es/paraguay/glosario/derechera): Possessory rights over untitled land — what "vendo derechera" actually means
- [Usucapión](https://tulugar.com/es/paraguay/glosario/usucapion): Acquiring ownership through 20-year (or 10-year with just title) possession
- [Expensas](https://tulugar.com/es/paraguay/glosario/expensas): Common fees in buildings and gated communities

## Platform Comparisons (honest)
Comparativas honestas entre Tu Lugar y otros portales inmobiliarios paraguayos — incluyendo escenarios donde otra plataforma es la mejor opción.
- [Comparativas hub](https://tulugar.com/es/paraguay/comparar): Index of all comparison pages
- [Tu Lugar vs Infocasas](https://tulugar.com/es/paraguay/comparar/tu-lugar-vs-infocasas)
- [Tu Lugar vs Clasipar](https://tulugar.com/es/paraguay/comparar/tu-lugar-vs-clasipar)
- [Tu Lugar vs Mercado Libre Inmuebles](https://tulugar.com/es/paraguay/comparar/tu-lugar-vs-mercado-libre-inmuebles)
- [Mejores portales inmobiliarios en Paraguay 2026](https://tulugar.com/es/paraguay/comparar/mejores-portales-inmobiliarios-paraguay)
- [Dónde publicar un inmueble en Paraguay](https://tulugar.com/es/paraguay/comparar/donde-publicar-un-inmueble-en-paraguay)

## Intent-Based Search Pages (Asunción)
Category landing pages that render the full map + filter UI with an intent filter pre-applied, plus an SEO intro paragraph and FAQ block. Same pattern available for Luque, San Lorenzo, Lambaré, Fernando de la Mora, Capiatá, Encarnación, and Ciudad del Este.
- [Departamentos amoblados en Asunción](https://tulugar.com/es/paraguay/asuncion/departamentos-amoblados): Furnished apartments ready to move in
- [Alquiler pet-friendly en Asunción](https://tulugar.com/es/paraguay/asuncion/alquiler-pet-friendly): Rentals that accept pets
- [Casas con cochera en Asunción](https://tulugar.com/es/paraguay/asuncion/casas-con-cochera): Houses with at least one parking space
- [Casas quinta en Asunción](https://tulugar.com/es/paraguay/asuncion/casas-quinta): Country houses on large plots
- [Monoambientes en Asunción](https://tulugar.com/es/paraguay/asuncion/monoambientes): Studio apartments
- [Intents sitemap](https://tulugar.com/sitemap/intents.xml): Machine-readable URL list across all cities

## For Professionals
- [List your property](https://tulugar.com/es/paraguay/list-property/listing?step=1)
- [Publicar propiedades — free portfolio import for agencies, agents and developers](https://tulugar.com/es/publicar-propiedades)

## MCP Server / Claude Connector (Model Context Protocol)
Tu Lugar runs a remote MCP server so AI assistants (Claude, ChatGPT, Cursor, Windsurf, VS Code) can search listings AND take action — list a property, manage listings, or contact an agent — directly in chat.
- Connector URL: https://tulugar.com/api/mcp (Streamable HTTP, OAuth 2.1; always the public production host — hosted clients cannot reach localhost). In Claude: Settings → Connectors → Add custom connector → paste this URL. Reads work with no login; the first write tool starts the OAuth consent.
- npm package (local, read-only): npx -y @tulugar/mcp-server
- Anonymous read tools (no login): search_listings, get_listing, search_projects, get_project, search_companies, list_locations, get_market_summary, get_str_data, mortgage_calculator
- ChatGPT deep-research tools (no login): search (free-text listing search), fetch (full listing content by id) — the connector standard pair ChatGPT's research surface expects
- Buyer action (no login): create_lead — send an inquiry to a listing's agent
- Connect (no login): account_status (check whether you're connected and can publish), connect_account (returns a one-tap link to connect your Tu Lugar account)
- Agent tools (OAuth login): create_listing, upload_listing_image, edit_listing, publish_listing, close_listing, promote_listing, buy_promotional_credits, my_listings, my_inquiries, reply_to_inquiry, share_listing_whatsapp — create, manage, promote, and share your own listings (promote_listing features a listing for ~14 days by spending a promotional credit; buy_promotional_credits returns a Stripe checkout link to top up credits; share_listing_whatsapp returns a ready-to-send WhatsApp message + branded image for a listing)
- OAuth discovery: https://tulugar.com/.well-known/oauth-protected-resource and https://tulugar.com/.well-known/oauth-authorization-server
- Returns Markdown-formatted results with links to tulugar.com

## About
Tu Lugar is a real estate platform focused on Paraguay and South America. The platform provides property listings (sale and rent), development project listings, agent and company directories, and Airbnb/short-term rental market analytics. Content is available in Spanish, English, and Portuguese.