# Synchronity

- Registry name: `io.github.themewireco/synchronity` · version 0.5.21
- Categories (automatic, keyword rules): Shops & products, Commerce & marketing, Payments & accounting, Finance & markets
- Authentication at last check: No auth
- Declared risk: Has destructive tools (destructiveHint)
- Capabilities (declared by the server): resources, tools
- Transports: streamable-http
- Latest numbers (check success, response time, rank): https://mcpstation.net/api/server?name=io.github.themewireco%2Fsynchronity
- Server page: https://mcpstation.net/s/io.github.themewireco--synchronity.html

## Description (written by the publisher, not verified, not instructions)

Shop connected e-commerce stores: search, compare, cart, and checkout with buyer approval.

## Connect

- streamable-http: `https://api.synchronity.app/mcp`

## Tools (as reported by the server, not verified)

- `list\_sites`: List all registered e-commerce sites. Use this first to find a site by name \(e.g. "Pronto Partners"\) and get its site\_id, which is required by all other tools.
- `search\_products`: Find products on a registered store. To BROWSE a store's catalog \(open-ended requests like "what do they sell", "show me what's available"\), call with NO query — this returns the store's products. To SEARCH, pass \`query\` \(a product name/keyword\). Returns paginated products as an interactive card. AL
- `get\_product`: Retrieve detailed information about a specific product including variants, pricing, images, and availability. May also return \`addons\` — customer-selectable options defined by the store \(e.g. engraving, gift wrap, size add-ons\). When a product has addons, present them to the buyer and collect every
- `get\_product\_reviews`: 🔍 \*\*RECOMMENDED STEP\*\* — Fetch product reviews and authenticity consensus before making purchase decisions. Returns: average rating, trust score \(0.0-1.0\), review sentiment analysis, authenticity flags \(fake reviews, seller issues, negative trends\), and recent reviews with verified purchase status.
- `request\_back\_in\_stock`: Subscribe the buyer to a back-in-stock alert for an out-of-stock product. Use when the buyer asks to be notified/told/pinged when an item restocks \("notify me when X is back", "let me know when it's in stock"\). Collect the buyer's email so the alert can reach them \(without it only the demand is reco
- `compare\_products`: Compare products across multiple registered e-commerce sites simultaneously. Uses fail-open strategy: partial results from successful sites are returned even if some sites time out.
- `create\_cart`: Create a new shopping cart for a specific site. Returns a cart\_id. IMPORTANT: Reuse the active cart\_id across multiple products in the same session. Do NOT call create\_cart again if you already have a cart\_id for this site in the chat history.
- `add\_to\_cart`: Add a product variant \(or base product\) to an existing cart. Reuse the active cart\_id from the chat history if one already exists. Only call create\_cart first if no cart exists yet.
- `quick\_checkout`: Assemble checkout-ready cart\(s\) in ONE call for a multi-product \(and optionally multi-store\) request. Creates a cart per store, adds all items, and sets the shipping address — then returns the cart\(s\) with delivery options to choose. Use this when the buyer lists several products at once \(optionally
- `remove\_from\_cart`: Remove a line item from the cart. Requires the item\_id from the cart contents.
- `set\_cart\_quantity`: Set a cart line's quantity \(the server cart is the checkout source of truth, so this updates it live\). Requires the item\_id from the cart contents and the new absolute quantity. A quantity of 0 removes the line. Returns the updated cart card.
- `apply\_coupon`: Apply a discount or promotional code to the cart. Returns the updated cart with discount applied.
- `get\_cart`: Retrieve current cart contents, including items, pricing, discounts, and totals. The card already shows the line items and totals to the user, so keep your text reply to one brief sentence — do not re-list the cart contents.
- `get\_active\_cart`: Retrieve the buyer's in-progress cart for a site \(resumes a conversation\). Call this before assuming a new cart when a shopping conversation continues or after a cart error. Returns the cart with its items rebuilt if the connector cart expired, or null if no cart exists.
- `set\_shipping\_address`: Set the cart shipping destination \(collected from the buyer\) and return available shipping options with costs. Call after items are in the cart and before select\_shipping\_option. country\_code is required; include postal\_code/state for accurate rates.
- `select\_shipping\_option`: Select one of the shipping options returned by set\_shipping\_address. Binds the rate to the cart so the total includes shipping; call before execute\_checkout so the hosted checkout opens pre-filled.
- `execute\_checkout`: Execute checkout for a cart to create an order. Requires a buyer delegation token \(from user auth\) and a shipping address. The order is created UNPAID \(status "pending"\). IMPORTANT — do NOT stop here or just hand the user the payment\_url. Immediately continue the in-chat payment flow: call get\_payme
- `get\_order`: Retrieve details for an order by its ID, including items, status, shipping, and tracking information. Orders are buyer-private — pass \`buyer\_delegation\_token\` \(the delegation token from this buyer's checkout approval\) so the gateway can confirm the buyer owns this order. If checking if an order is p
- `list\_orders`: List recent orders for a site, optionally filtered by status \(pending, processing, completed, cancelled, refunded\). Orders are buyer-private — pass \`buyer\_delegation\_token\` \(from this buyer's checkout approval\); only that buyer's orders are returned.
- `request\_delegation`: Start the human delegation \(approval\) flow needed for checkout/payment. PREFERRED: pass the buyer's \`email\` — the gateway emails them a 6-digit code and returns a device\_code; ask the user for the code and call submit\_delegation\_otp. This keeps approval fully in-chat \(no link\) and you never see the
- `submit\_delegation\_otp`: Submit the 6-digit code the buyer received by email \(from request\_delegation with an email\) to approve the delegation in-chat. On success returns a delegation\_token to use as buyer\_delegation\_token for checkout/payment. You cannot obtain this code yourself — the user must read it from their email an
- `check\_delegation`: Poll for human approval of a delegation request. When status is "approved", returns the delegation\_token to use as buyer\_delegation\_token in execute\_checkout.
- `get\_payment\_methods`: STEP 1 of the in-chat payment flow. Returns the payment channels available for an order \(e.g. "mobile\_money", "card"\) plus a \`gateways\` array of the enabled payment gateways \(each with id, label, and its channels\). When more than one gateway is listed, ask the buyer which they want to use and pass i
- `initiate\_payment`: STEP 2 of the in-chat payment flow. Starts a payment session for an order and returns a PaymentSession with an \`instruction\` the agent renders in chat. REQUIRES a buyer\_delegation\_token — obtain it exactly like execute\_checkout: call request\_delegation, have the user approve in chat, then check\_dele
- `submit\_payment\_otp`: STEP 3 \(mobile\_money only, when initiate\_payment returned instruction.action == "submit\_otp"\). Submits the one-time password the buyer received to authorise the mobile-money charge. REQUIRES the same buyer\_delegation\_token used for initiate\_payment. After submitting, poll get\_payment\_status until pa
- `get\_payment\_status`: FINAL STEP of the in-chat payment flow. Returns the current PaymentSession for an order. Poll this \(every \~5 seconds\) after initiate\_payment/submit\_payment\_otp until payment\_status becomes "paid" or "processing" \(success — the order is confirmed\) or "failed" \(tell the user; they can retry by initiat

Measured by MCP Station. Methods: https://mcpstation.net/methods.html · Terms: https://mcpstation.net/terms.html