Vantage Movers MCP

Remote Model Context Protocol server so agents can use the Granot / Vantage backend and query MongoDB Atlas from one place.

Hosted on Vercel with mcp-handler v2 and Next.js. That is the current Vercel-supported path: Streamable HTTP plus the 2026-07-28 MCP spec, no Redis, no long-lived stdio process.

Why this library

Related MCP server: MongoDB MCP Server

Required MCP configuration

VANTAGE_API_SECRET is required in the client config. The server puts that value on the x-api-secret header when it calls https://vantage-movers-main-server.vercel.app.

Cursor / Claude-style Streamable HTTP:

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

x-api-secret is accepted as well if a client prefers the Vantage header name:

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

Do not put the secret in env for a remote URL. HTTP MCP clients only send headers. env is for local stdio servers.

Production also stores VANTAGE_API_SECRET on the Vercel project so a public URL cannot open Mongo with a made-up token. The client value must match.

MongoDB

The official MongoDB MCP server is stdio. This deployment keeps a dedicated Mongo surface in-process:

• mongo_list_databases

• mongo_list_collections

• mongo_collection_schema

• mongo_collection_indexes

• mongo_find

• mongo_aggregate

• mongo_count

• mongo_db_stats

Read-only. $out and $merge are rejected. Default database is vantagemovers (or testvantagemovers when TEST_MODE=true).

Use lead tools for Form / Call Lead writes. Raw Mongo mutations would skip Sheet Sync and CRM posting.

First tool slice

History tools (read-only)

The general endpoint also exposes read-only history tools backed by the main server's GET /api/v1/internal/sales-intelligence/history/* routes (authenticated with the same x-api-secret; never raw Mongo). They return names, E.164 numbers, job numbers, summaries, findings and story prose, and never transcript text, Lead Message bodies or emails.

Later slices: Granot syncs, Owner Registry items, booking cases.

Scoped Sales Intelligence (CSI-17)

The dedicated /api/intelligence-mcp endpoint exposes twelve tools: get_intelligence_context, get_call_transcript, list_number_activity, search_leads, get_lead, search_bookings, get_booking, get_rep_identity, query_operational_records, search_ringcentral_calls, get_ringcentral_call, and submit_intelligence_analysis. A run's signed tool allowlist can narrow discovery and invocation further.

It publishes prompt sales_intelligence_analyze_v1 and resource csi://schemas/csi-envelope-v1. Contracts are generated from main-server schemas, including tool arguments. The server is the semantic authority and validates refinements/evidence after MCP shape validation. This endpoint has no general Mongo, arbitrary HTTP, Lead mutation, Owner command or messaging tools. The general endpoint remains separate and rejects intelligence credentials.

See intelligence contract and synthetic requests. CSI-13 model execution and effect application remain separate work; acceptance of a submission is not application success. No deployment or live RingCentral proof is implied.

Local

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

MCP URL locally: http://localhost:3100/api/mcp

Deploy

Production is Vercel CLI only. The project is not Git-connected. Agents follow .agents/skills/deploy-vantage-movers-mcp/SKILL.md.

npx --yes vercel --prod --yes --scope vantage-4d3db9ef

Environment