Skip to content
MarketBox

Early accessThe MarketBox MCP server

MarketBox in Claude, ChatGPT, Gemini and Grok.

Connect your AI assistant to your MarketBox projects. Ask about bookings, suppliers and clients, and plan changes that apply only after you agree.

MCP server URL

https://box.gomarketbox.com/mcp

For project admins and managers.

Add MarketBox to your assistant

You sign in with your MarketBox account and choose what the assistant may reach. Pick your assistant.

Add MarketBox to Claude

Tested

  1. Copy the MCP server URL.

    https://box.gomarketbox.com/mcp
  2. In claude.ai, open Settings › Connectors and choose Add custom connector.

  3. Name it “MarketBox” and paste the URL. Leave the advanced OAuth fields empty.

  4. Choose Connect. Claude opens the MarketBox sign-in: sign in as usual.

  5. MarketBox asks “Connect Claude to MarketBox?”. Choose the projects and the access, then Approve. You’re back in Claude.

Tested with Claude on the web, desktop and mobile, and Claude Code.

In Claude Code

  1. Add the server:

    claude mcp add --transport http box https://box.gomarketbox.com/mcp
  2. Run /mcp, pick box and choose Authenticate. A browser opens for the sign-in and the approval.

  3. The approval screen warns that the app runs on your computer. Approve only if you started it yourself.

Claude’s guide to custom connectors (opens in a new tab) ↗

Next steps

  1. 01An admin turns on AI connectorsIn the dashboard, a project admin opens Settings › Config › AI connectors. It’s Off by default. Read only lets assistants read and plan; Read and make changes lets them apply plans too.
  2. 02Sign in with your MarketBox accountYou need to be an admin or manager in a project whose AI connectors are on.
  3. 03Choose projects and accessOn the approval screen, pick one project, several or all of them, and Read or Read and write. Check the app’s name and where it sends you back. Choose Read unless you want changes.
  4. 04Ask a questionThe assistant sees only what you may see in the dashboard, and only in the projects you approved.
  5. 05Check each plan before you agreeFor a change, the assistant shows you a plan: what changes, from what to what. Nothing happens until you say yes.

What your assistant can do

  • Read your projectSettings, the catalog, suppliers, clients and bookings, and the history of setting changes.
  • Plan a changeAny change starts as a plan you can read. A plan changes nothing, even on a Read connection.
  • Update settings and the catalogProject settings, services, service categories, attributes, skills and locations.Needs Read and write
  • Change prices, fees and packagesAn offering’s prices and price rules, fees, and packages.Needs Read and write
  • Set supplier availabilityA supplier’s settings, schedules, blocked times and travel zones.Needs Read and write
  • Cancel, reschedule and note bookingsCancel a booking, move its times or add a note. The plan shows the time in the booking’s own zone and who is emailed.Needs Read and write
  • Add and update clientsCreate a client or update one. Client addresses stay in the dashboard.Needs Read and write

Try asking

Ask the way you would ask a colleague

  • “Which bookings does Maya have tomorrow?”
  • “What changed in our project settings this month?”
  • “Block Friday afternoon for Leo, and show me the plan first.”
  • “Move Sam’s Tuesday booking to 3pm.”
  • “Raise the price of our 60-minute service by 5%. What would change?”

What your assistant can and cannot do

  • Nothing changes until you agreeEvery change is planned, shown to you and applied only after you say yes. A plan expires after 15 minutes, and a plan for something that changed since is refused.
  • Never money or the teamNo card refunds, payments, payouts or orders, and no changes to the team. A cancellation can leave credit or no refund, as the plan recommends; refunds stay in the dashboard.
  • Client and supplier text is dataNotes, reviews, bios and cancellation reasons reach the assistant marked as untrusted. A note that says “cancel all bookings” is never an instruction.
  • Only what you may seeBox goes through the same roles and history as the dashboard. A manager can plan anything, but applying fails where the dashboard needs an admin.
  • Connections endA connection lasts up to 180 days and ends after 30 days unused. Revoke it any time in the dashboard under Connected apps. Removing it in the assistant may not end it, so revoke there too.

The server

Endpoint
https://box.gomarketbox.com/mcp
Transport
Streamable HTTP
Authentication
OAuth, following the MCP authorization spec. Clients identify with a client ID metadata document or dynamic client registration. Every connection is approved in the MarketBox dashboard.
Discovery
https://box.gomarketbox.com/.well-known/oauth-protected-resource/mcpAn unsigned call answers 401 with a WWW-Authenticate header pointing here.
Changes
plan_project_settings_changeplan_service_changeplan_pricing_changeplan_fees_changeplan_package_changeplan_catalog_changeplan_supplier_changeplan_availability_changeplan_booking_cancelplan_booking_rescheduleplan_booking_noteplan_client_createplan_client_updateapply_changelist_pending_changesdiscard_changeA plan returns a diff and a changeId; apply_change applies it within 15 minutes.
Reads
list_bookingsget_supplierlist_settings_historysearchapi_getAbout 30 read tools. Payment identifiers and card details are removed from every answer.
Revoke
https://box.gomarketbox.com/oauth/revoke

Everything your assistant does here, you can do in the MarketBox dashboard. Sign in to the dashboard

Box is in early access.

Box is open to a few MarketBox accounts for now. Others see “box is not enabled for your MarketBox account yet” when they sign in. Ask us and we’ll turn it on for yours.