Netmex MCP B2C Bridge

Bridge stdio para Claude Desktop que se conecta al B2C MCP remoto de Netmex.

Este paquete no implementa logica de negocio localmente. Solo recibe solicitudes MCP por stdin, las reenvia al backend remoto y devuelve la respuesta por stdout.

Configuracion

Variables de entorno requeridas:

NETMEX_MCP_URL=https://netmex-api-staging-0455fe68d15a.herokuapp.com/mcp/b2c
NETMEX_MCP_API_KEY=tu_api_key

• NETMEX_MCP_URL: URL base del endpoint MCP remoto.
• NETMEX_MCP_API_KEY: API key usada para autenticar las solicitudes al backend remoto.

El bridge puede apuntar a staging o produccion. Para staging, usa:

https://netmex-api-staging-0455fe68d15a.herokuapp.com/mcp/b2c

Uso local

npm start

Sitios soportados

• netmex: propiedades comerciales.
• casasenmx: casas.
• depasenmx: departamentos.
• site=all: agrega los tres inventarios en una sola busqueda.

Publicacion B2C

El B2C remoto expone solo propiedades publicas.

• published significa isDraft=false y propiedad no expirada.
• No se devuelven drafts.
• propertyUrl depende del entorno remoto que estes usando, por ejemplo staging o produccion.

Herramienta MCP expuesta

Actualmente el B2C MCP remoto expone una sola herramienta:

• search_properties

Como funciona search_properties

search_properties consulta inventario publico en el backend remoto y devuelve resultados ya adaptados para consumo por clientes MCP.

Parametros principales:

• site: inventario a consultar. Puede ser netmex, casasenmx, depasenmx o all.
• operation: operacion inmobiliaria, por ejemplo venta o renta.
• type: tipo de propiedad.
• state: estado.
• city: ciudad con matching tolerante.
• minPrice: precio minimo.
• maxPrice: precio maximo.
• minBuild: construccion minima.
• maxBuild: construccion maxima.
• minLand: terreno minimo.
• maxLand: terreno maximo.
• highlights: lista de atributos destacados usados como senales de ranking.
• services: lista de servicios usados como senales de ranking.
• page: pagina actual para paginacion.
• perPage: cantidad de resultados por pagina.

Aclaraciones funcionales importantes

• Si existe specs.agent, ese contacto reemplaza al seller en la respuesta publica.
• visibleContact respeta privates; privates[0] oculta email.
• visibleContact respeta privates; privates[1] oculta telefono y WhatsApp.
• addressPartial se arma con suburb + city + state.
• highlights y services no son filtros duros; son senales de ranking.
• El matching de highlights y services es suave; tolera acentos.
• El matching de highlights y services es suave; tolera variaciones de espacios.
• El matching de highlights y services es suave; tolera texto pegado.
• El matching de highlights y services es suave; tolera coincidencias parciales razonables.
• city tambien usa matching tolerante.
• La IA puede pedir la siguiente pagina usando page y perPage.

Que devuelve search_properties

Cada resultado puede incluir:

• id
• site
• title
• propertyType
• operation
• price
• currency
• addressPartial
• city
• state
• highlights
• services
• photos
• propertyUrl
• visibleContact
• matchScore
• matchedHighlights
• matchedServices

Claude Desktop

Ejemplo de claude_desktop_config.json:

{
  "mcpServers": {
    "netmex-b2c": {
      "command": "npx",
      "args": ["-y", "netmex-mcp-b2c-bridge"],
      "env": {
        "NETMEX_MCP_URL": "https://netmex-api-staging-0455fe68d15a.herokuapp.com/mcp/b2c",
        "NETMEX_MCP_API_KEY": "tu_api_key"
      }
    }
  }
}

npx descargara y ejecutara el paquete automaticamente la primera vez. La API key real solo va en env, no en el repo.

Alcance del bridge

Este bridge solo documenta y reenvia solicitudes al B2C MCP remoto de Netmex. No modifica resultados ni replica reglas del backend en local.