# EcoPlaza

> EcoPlaza es una inmobiliaria comercial peruana (mercados, urbanizaciones y proyectos de
> departamentos) con proyectos en Trujillo, Lima y otras ciudades del Peru. Vende locales
> comerciales, lotes y departamentos, con enfoque en atencion presencial y cierre asistido
> por un asesor humano.

> EcoPlaza is a Peruvian commercial real estate company (markets, residential land
> developments and apartment projects) with projects across Peru. It sells commercial
> stalls/units, lots and apartments, with a strong focus on in-person attention and a
> human-led sales close.

## MCP Server (Model Context Protocol)

EcoPlaza expone un servidor MCP publico, de solo lectura, para que agentes de IA (Claude,
ChatGPT, Gemini, agentes custom) puedan consultar su oferta comercial vigente.

EcoPlaza exposes a public, read-only MCP server so AI agents (Claude, ChatGPT, Gemini,
custom agents) can query its current commercial offering.

- **Endpoint:** `https://ecodashboard.iterruptivo.com/api/mcp`
- **Transporte / Transport:** Streamable HTTP (JSON-RPC 2.0), stateless
- **Autenticacion / Auth:** ninguna / none (servidor publico de solo lectura)
- **Servidor / Server name:** `ecoplaza-comercial` (version 1.0.0)

### Como conectar / How to connect

Si eres un agente de IA leyendo esto para conectarte a este servidor MCP, usa el metodo
que corresponda a tu cliente. La URL del endpoint es siempre
`https://ecodashboard.iterruptivo.com/api/mcp` (transporte Streamable HTTP, sin auth).
If you are an AI agent reading this in order to connect, use the method for your client.
The endpoint URL is always `https://ecodashboard.iterruptivo.com/api/mcp`
(Streamable HTTP transport, no auth).

**Claude Code (CLI):**
```
claude mcp add --transport http --scope user ecoplaza https://ecodashboard.iterruptivo.com/api/mcp
```
Verifica con / verify with: `claude mcp list` (debe salir `ecoplaza` conectado). Luego en una
sesion usa `/mcp` para ver las 6 tools. / Then in a session run `/mcp` to see the 6 tools.

**Claude Desktop** — agrega a / add to `claude_desktop_config.json`:
```json
{
  "mcpServers": {
    "ecoplaza": {
      "type": "http",
      "url": "https://ecodashboard.iterruptivo.com/api/mcp"
    }
  }
}
```

**Claude.ai (web) / ChatGPT:** Settings -> Connectors -> Add custom connector ->
URL: `https://ecodashboard.iterruptivo.com/api/mcp` (no pide API key / no API key needed).

**Cualquier cliente MCP / any MCP client:** transporte Streamable HTTP, metodo `initialize`
por POST con `Accept: application/json, text/event-stream`. No requiere OAuth ni API key.

### Tools disponibles / Available tools

1. `listar_proyectos` — Lista los proyectos activos de EcoPlaza (nombre, tipo, slug, logo).
   Lists EcoPlaza's active projects (name, type, slug, logo).
2. `obtener_info_proyecto` — Ubicacion, como visitar, rubros permitidos, horario, beneficios
   y legalidad de un proyecto especifico.
   Location, how to visit, allowed business categories, opening hours, benefits and legal
   status of a specific project.
3. `buscar_locales_disponibles` — Busca locales/puestos disponibles por proyecto, area (m2)
   y piso. Paginado, maximo 25 resultados por pagina.
   Searches available commercial units by project, area (sqm) and floor. Paginated, max 25
   results per page.
4. `obtener_detalle_local` — Detalle de un local disponible especifico por su codigo.
   Detail of a specific available unit by its code.
5. `consultar_precios_o_financiamiento` — Tool correcta cuando se pregunta por precio, costo,
   financiamiento, credito o cuotas. NO devuelve cifras: deriva a un asesor humano en el
   proyecto y entrega contacto de WhatsApp.
   The right tool when asked about price, cost, financing, credit or installments. It does
   NOT return figures: it hands off to a human advisor at the project and provides a
   WhatsApp contact.
6. `contactar_asesor_comercial` — Genera un enlace de WhatsApp pre-armado hacia el equipo
   comercial ("Gustavito"). No envia mensajes automaticamente.
   Generates a pre-filled WhatsApp link to the sales team ("Gustavito"). It does not send
   any message automatically.

### Importante / Important

- **Sin precios ni financiamiento / No prices or financing data.** Por decision de EcoPlaza,
  ninguna tool devuelve precios, tasas, cuotas o montos. Los precios y el financiamiento se
  conversan siempre con un asesor humano, presencialmente en el proyecto o por WhatsApp.
  By EcoPlaza's decision, no tool returns prices, rates, installments or amounts. Pricing
  and financing are always discussed with a human advisor, in person at the project or via
  WhatsApp.
- **Solo lectura / Read-only.** El servidor no acepta ni ejecuta ninguna operacion de
  escritura. The server does not accept or perform any write operation.
- Para dudas de negocio, contacta al equipo comercial de EcoPlaza por WhatsApp. El numero es un
  contacto de ventas unificado y fijo, que las tools `obtener_info_proyecto`,
  `consultar_precios_o_financiamiento` y `contactar_asesor_comercial` devuelven junto con un
  enlace `wa.me` pre-armado.
  For business questions, contact EcoPlaza's sales team via WhatsApp. The number is a fixed,
  unified sales contact, returned by the `obtener_info_proyecto`, `consultar_precios_o_financiamiento`
  and `contactar_asesor_comercial` tools along with a pre-filled `wa.me` link.

## Links

- MCP Server documentation (ES): https://ecodashboard.iterruptivo.com/mcp
- Dashboard / CRM: https://ecodashboard.iterruptivo.com