MCP Integration

Model Context Protocol server for AI agents working with Order Change.

What is MCP?

The Model Context Protocol (MCP) is an open standard that lets AI agents connect to external systems through a unified interface. Order Change provides an MCP server so agents can help merchants manage orders — check eligibility, preview changes, and commit edits — all while respecting the merchant's plan limits and settings.

Agents use the same capabilities as the customer-facing Order Change UI and partner API. All edits honor the merchant's configured edit window, enabled capabilities, and plan tier.

Tool Catalog

The Order Change MCP server exposes the following tools. Each tool respects the merchant's plan and settings.

`get_order`

Retrieve order details by store ID and order ID. Returns line items, customer info, shipping address, fulfillment status, and edit history.

Plan: Free

`get_change_window`

Get the edit window status for an order. Returns whether the window is still open and when it closes.

Plan: Free

`preview_address_change`

Preview a shipping address change. Returns the validated address and any updated shipping costs. Does not modify the order.

Plan: Free

`commit_address_change`

Commit a previewed address change. Must follow a successful preview. Updates the order's shipping address and recalculates shipping costs if needed.

Plan: Free

`preview_contact_change`

Preview contact info changes (email, phone). Returns the updated contact details for verification.

Plan: Free

`commit_contact_change`

Commit previewed contact changes. Updates the customer's email and/or phone number on the order.

Plan: Free

`preview_item_changes`

Preview line item changes — add items, remove items, change variants, or update quantities. Returns recalculated order totals and any tax or shipping adjustments.

Plan: Pro

`commit_item_changes`

Commit previewed item changes. Updates the order's line items and totals.

Plan: Pro

`preview_cancel`

Preview order cancellation. Returns refund details.

Plan: Free

`commit_cancel`

Cancel the order and issue a full refund. Must be within the merchant's configured edit window.

Plan: Free

`preview_discount`

Preview applying a discount code. Returns updated order totals with the discount applied.

Plan: Pro

`commit_discount`

Commit a previewed discount code. Applies the discount to the order.

Plan: Pro

`preview_shipping_upgrade`

Preview shipping upgrade options. Returns available upgrade options and pricing.

Plan: Pro

`commit_shipping_upgrade`

Commit a shipping upgrade. Charges the customer for the upgrade and updates the order.

Plan: Pro

Plan Eligibility

Tool availability depends on the merchant's plan. Agents should always call get_change_window first to determine whether the order is still within the edit window, and check plan restrictions before attempting Pro-tier operations.

Free Plan ($0/mo)

✓ get_order
✓ get_change_window
✓ preview_address_change
✓ commit_address_change
✓ preview_contact_change
✓ commit_contact_change
✓ preview_cancel
✓ commit_cancel
✓ Invoice edits

Pro Plan ($49/mo)

✓ All Free plan tools
✓ preview_item_changes
✓ commit_item_changes
✓ preview_discount
✓ commit_discount
✓ preview_shipping_upgrade
✓ commit_shipping_upgrade

Plan upgrades are UI-only

Merchants change their plan through the Order Change dashboard. There is no MCP tool or API endpoint to upgrade or downgrade plans (per architectural decision). Agents should direct merchants to the dashboard if they need Pro capabilities.

Preview & Commit Flow

Most edits follow a two-step pattern: preview first, then commit.

Call get_change_window — Verify the order is still within the merchant's configured edit window and check which capabilities are enabled.
Call the preview tool — See what the order will look like after the change. The preview includes validated addresses, recalculated totals, and any warnings.
Show preview to merchant or customer — Let them confirm the change before applying it.
Call the commit tool — Apply the change to the order. This step modifies the order in Shopify.

The preview step is fast and can be called multiple times. The commit step is permanent and can only succeed within the merchant's edit window.

Setup & Connection

To connect an MCP client to Order Change:

Get your merchant token — Available in the Order Change dashboard under Settings → API. Merchant tokens are scoped to a single Shopify store.
Configure your MCP client — Add the Order Change server to your client's configuration. The server URL is:

MCP Server URL

https://mcp.orderchange.com

Pass your authentication credentials as an environment variable or in the MCP configuration. Exact setup steps depend on your MCP client (Claude Desktop, Cursor, or custom implementation).

{
  "mcpServers": {
    "orderchange": {
      "url": "https://mcp.orderchange.com",
      "env": {
        "ORDERCHANGE_API_KEY": "your_api_key_here"
      }
    }
  }
}

Once connected, the agent will see all available Order Change tools and can call them as needed.

Questions?

MCP support and integration help: support@orderchange.com