Vantage Movers MCP

Servidor remoto de Model Context Protocol para que los agentes puedan usar el backend de Granot / Vantage y consultar MongoDB Atlas desde un solo lugar.

Alojado en Vercel con mcp-handler v2 y Next.js. Esa es la ruta actual compatible con Vercel: Streamable HTTP más la especificación MCP del 2026-07-28, sin Redis, sin proceso stdio de larga duración.

Por qué esta biblioteca

Related MCP server: MongoDB MCP Server

Configuración MCP requerida

VANTAGE_API_SECRET es obligatoria en la configuración del cliente. El servidor coloca ese valor en la cabecera x-api-secret cuando llama a https://vantage-movers-main-server.vercel.app.

Streamable HTTP estilo Cursor / Claude:

{
  "mcpServers": {
    "vantage-movers": {
      "url": "https://vantage-movers-mcp.vercel.app/api/mcp",
      "headers": {
        "Authorization": "Bearer <VANTAGE_API_SECRET>"
      }
    }
  }
}

x-api-secret también se acepta si un cliente prefiere el nombre de cabecera de Vantage:

{
  "mcpServers": {
    "vantage-movers": {
      "url": "https://vantage-movers-mcp.vercel.app/api/mcp",
      "headers": {
        "x-api-secret": "<VANTAGE_API_SECRET>"
      }
    }
  }
}

No pongas el secreto en env para una URL remota. Los clientes MCP HTTP solo envían headers. env es para servidores stdio locales.

En producción, VANTAGE_API_SECRET también se guarda en el proyecto de Vercel para que una URL pública no pueda abrir Mongo con un token inventado. El valor del cliente debe coincidir.

MongoDB

El servidor MCP oficial de MongoDB es stdio. Este despliegue mantiene una superficie Mongo dedicada dentro del proceso:

• mongo_list_databases

• mongo_list_collections

• mongo_collection_schema

• mongo_collection_indexes

• mongo_find

• mongo_aggregate

• mongo_count

• mongo_db_stats

Solo lectura. $out y $merge se rechazan. La base de datos por defecto es vantagemovers (o testvantagemovers cuando TEST_MODE=true).

Usa las herramientas de leads para escrituras de Form / Call Lead. Las mutaciones directas de Mongo omitirían Sheet Sync y el envío a CRM.

Primera entrega de herramientas

Entregas posteriores: sincronizaciones de Granot, elementos del Owner Registry, casos de reserva.

En local

pnpm install
cp .env.example .env.local
# fill VANTAGE_API_SECRET and MONGO_URI
pnpm test
pnpm typecheck
pnpm dev

URL MCP en local: http://localhost:3100/api/mcp

Entorno