Netmex MCP Admin Bridge

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

Este proyecto no implementa logica de negocio localmente. Su funcion es recibir solicitudes MCP por stdin, reenviarlas al backend remoto y devolver la respuesta por stdout.

Que hace este bridge

• Expone un proceso compatible con Claude Desktop usando transporte stdio.
• Se conecta al Admin MCP remoto de Netmex.
• Reenvia solicitudes MCP al backend remoto.
• No implementa reglas de negocio ni reportes localmente.

Configuracion

Variables de entorno requeridas:

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

Descripcion:

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

Ejemplo apuntando a staging:

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

Uso local

npm start

Paquete npm publicado:

netmex-mcp-admin-bridge

Repositorio GitHub:

https://github.com/imerowas/netmex-mcp-admin-bridge

Significado de cada sitio

• netmex = propiedades comerciales.
• casasenmx = casas.
• depasenmx = departamentos.
• site=all = agrega las 3 colecciones.

Significado de published

• published = isDraft=false y propiedad no expirada.

Significado de active_member

• active_member depende de isMembershipActive().
• Incluye usuarios activos por Stripe y por Transfer.

Herramientas expuestas actualmente

El bridge reenvia al Admin MCP remoto, que actualmente expone estas herramientas:

• get_property_report_summary: resumen agregado de propiedades segun filtros como sitio, publicacion y rango temporal.
• get_property_report_top_state_type: ranking o distribucion de propiedades por estado y tipo.
• get_property_report_top_city_type: ranking o distribucion de propiedades por ciudad y tipo.
• get_recent_uploaded_properties: lista de propiedades cargadas recientemente; usa el campo created.
• get_active_properties_by_price: lista de propiedades activas por precio; devuelve seller, no agent, y tambien datos de agencia si existen.
• get_user_membership_summary: resumen de membresias de usuarios, incluyendo el estado de membresia activa.
• find_duplicate_stripe_customers: deteccion de clientes duplicados relacionados con Stripe.
• get_accounts: consulta paginada de cuentas de usuario en el backend administrativo.
• get_orphan_contexts: obtiene contexts sin vinculacion de membresia o cuenta resuelta segun la logica remota.
• get_registered_user_contexts_without_membership: lista contexts asociados a usuarios registrados sin membresia activa.
• get_contexts_by_accounts: consulta contexts asociados a cuentas especificas.

Aclaraciones funcionales importantes

• get_recent_uploaded_properties usa el campo created.
• get_accounts con all=true usa paginacion.
• La IA puede pedir la siguiente pagina con page y perPage.
• Las tools de contexts hacen matching por ultimos 10 digitos.
• Las tools de contexts consideran User.phone y User.cellphone.
• Las tools de contexts incluyen firstMessage.
• firstMessage es el primer mensaje con role="user"; si no existe, se usa el primer mensaje disponible.
• get_active_properties_by_price devuelve seller, no agent.
• get_active_properties_by_price devuelve tambien datos de agencia si existen.

Claude Desktop

Ejemplo de claude_desktop_config.json:

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

Notas

• Este repositorio distribuye y documenta el bridge.
• La disponibilidad real de herramientas y su comportamiento depende del backend remoto Admin MCP de Netmex.
• Esta actualizacion modifica solo la documentacion; no cambia la logica del bridge.