Maxmove LogoDocs

ChatGPT integration

How the Maxmove app in ChatGPT connects to a Maxmove account over MCP and OAuth, what it can do per role, and how bookings and payment work.

View as Markdown

The Maxmove app for ChatGPT lets a signed-in Maxmove user check serviceability, compare vehicle types, get binding quotes, book after explicit confirmation, and track orders in a ChatGPT conversation.

For setup, see Use Maxmove in ChatGPT.

How it connects#

ChatGPT connects to the Maxmove MCP server at https://api.maxmove.com/mcp. It does not use the public /v1 API or API keys.

  • Sign-in. The user selects Connect in ChatGPT and signs in with their Maxmove account (OAuth 2.1 with PKCE). ChatGPT identifies itself with an OAuth client metadata document on a chatgpt.com or openai.com domain.
  • Permissions. The connection starts with read access. The first booking, cancellation, or dispatch change asks the user to grant write access.
  • Workspace. The connection is bound to the Maxmove workspace that was active when the user connected. To switch, the user changes the workspace in Maxmove and reconnects.
  • Disconnect. Removing the app or its connection in ChatGPT under Settings → Apps & Connectors revokes ChatGPT's access.

Data flow#

  1. Quote

    The user describes the transport. ChatGPT calls the quote tool with the addresses as the user gave them; Maxmove geocodes them and checks serviceability and the vehicle. The quote renders as a booking summary card.

  2. Confirm

    ChatGPT books only after the user confirms the reviewed quote in the conversation or taps the button on the card. The booking redeems exactly that quote.

  3. Track

    The order renders as a tracking card with status, driver, and arrival time. The user can list their orders, cancel one, or open a support conversation.

Orders booked this way are normal Maxmove orders in the workspace, marked as booked through ChatGPT. They don't send /v1 webhook events.

What it can do#

The tools depend on the workspace type and the user's role: personal and business accounts can quote, book, track, and cancel; fleet control roles can inspect the order board and vehicle readiness and make confirmed dispatch changes; drivers can read their own routes, orders, and tours. See Tools by role.

Payment#

Bookings confirmed in ChatGPT use monthly invoice or cash payment. For card payment, ChatGPT hands the reviewed route, time, vehicle, and extras to a booking page on maxmove.com, where the user pays by card. That page prices the route again.

Requirements#

  • A Maxmove account with an active personal, business, fleet, or driver workspace and an eligible role.
  • A ChatGPT plan and region in which OpenAI offers apps.
  • Addresses inside the Maxmove service area.

Did this answer your question?