{
  "$schema": "https://modelcontextprotocol.io/schema/2025-06-18/server-manifest",
  "name": "wherenext-relocation",
  "title": "WhereNext Relocation Intelligence",
  "version": "2026-05-13",
  "description": "Model Context Protocol server exposing WhereNext's deterministic relocation intelligence (country shortlist, multi-country comparison, readiness scoring, first-year cost, advisor handoff packet, source lookup, natural-language relocation search, unified plan-relocation orchestrator) plus a consented partner-intro submission tool. Read-only tools are safe to call without user confirmation; `request_provider_handoff` mutates state and requires explicit consent captured by the agent.",
  "publisher": {
    "name": "WhereNext",
    "url": "https://getwherenext.com",
    "contact": "https://getwherenext.com/platform/api"
  },
  "endpoints": {
    "streamableHttp": "https://getwherenext.com/api/mcp",
    "documentation": "https://getwherenext.com/platform/mcp"
  },
  "transport": ["streamable-http", "stdio"],
  "protocolVersion": "2025-06-18",
  "authentication": {
    "type": "bearer",
    "header": "Authorization",
    "scheme": "Bearer",
    "tokenIssuance": "https://getwherenext.com/platform/api",
    "rationale": "The Streamable HTTP transport requires MCP_BEARER_TOKEN. The stdio transport (local Claude Desktop / Claude Code installs) is local-only and not gated. Tokens are issued manually through the API access lead form while WhereNext is in early public beta; this is the same intake the AI-agent commerce surfaces use."
  },
  "tools": [
    {
      "name": "shortlist",
      "summary": "Rank countries from caller-supplied dimensional weights.",
      "readOnly": true
    },
    {
      "name": "compare",
      "summary": "Side-by-side scoring for 2-4 countries with per-dimension winners.",
      "readOnly": true
    },
    {
      "name": "relocation_readiness",
      "summary": "0-100 readiness score + severity-tagged blockers + top next step.",
      "readOnly": true
    },
    {
      "name": "first_year_cost",
      "summary": "Move-in cash + monthly recurring + one-time first-year cost for a destination + household.",
      "readOnly": true
    },
    {
      "name": "advisor_packet",
      "summary": "Disclosure copy, required fields, questions, document checklist per provider category.",
      "readOnly": true
    },
    {
      "name": "source_lookup",
      "summary": "Find canonical WhereNext sources (datasets + visa registry) by free-text query.",
      "readOnly": true
    },
    {
      "name": "nl_query",
      "summary": "Free-form relocation question parsed into structured signals, then scored.",
      "readOnly": true
    },
    {
      "name": "plan_relocation",
      "summary": "Unified orchestrator: NL parse OR case → shortlist → per-destination readiness + cost + recommendation.",
      "readOnly": true
    },
    {
      "name": "request_provider_handoff",
      "summary": "Submit a consented partner-intro request on the user's behalf. REQUIRES consent record with the exact disclosure copy the agent showed the user. Mutating tool — a human reviews and follows up within 2 business days.",
      "readOnly": false,
      "requiresConsent": true
    }
  ],
  "policy": {
    "rankingIndependence": "https://getwherenext.com/providers#ranking-independence",
    "consentDisclosureBoundary": "WhereNext is decision-support intelligence only. Tools do not file taxes, prepare visa applications, broker property purchases, or guarantee school admissions. Agents calling `request_provider_handoff` MUST surface the canonical disclosure copy to the end user and obtain explicit affirmative consent — fabricating consent is a serious safety violation and every partner_intros.consent_trail row is manually audited.",
    "rateLimit": "30 requests / minute / token. Burst 60.",
    "license": "Tool outputs are licensed under CC BY 4.0; cite https://getwherenext.com/data."
  },
  "discovery": {
    "llmsTxt": "https://getwherenext.com/llms.txt",
    "openApi": "https://getwherenext.com/openapi.yaml",
    "capabilitiesManifest": "https://getwherenext.com/.well-known/wherenext-capabilities.json",
    "ucpManifest": "https://getwherenext.com/.well-known/ucp/manifest.json",
    "destinationSummaries": "https://getwherenext.com/api/data/destination-summaries"
  }
}