@synchronity/mcp-server

@synchronity/mcp-server

MCP (Model Context Protocol) server for Synchronity — gives AI assistants like Claude the tools to autonomously browse, compare, and purchase products on connected e-commerce stores.

Installation

npm install -g @synchronity/mcp-server

Or use the .mcpb Claude Desktop extension — download the latest package from your Synchronity dashboard.

Claude Desktop Setup

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "synchronity": {
      "command": "synchronity-mcp",
      "env": {
        "GATEWAY_URL": "https://api.synchronity.app",
        "AIT": "your-agent-identity-token",
        "DEFAULT_SITE_ID": "your-site-id"
      }
    }
  }
}

Claude Web Setup

In Claude web, go to Settings → Integrations → Add Integration and enter:

https://api.synchronity.app/mcp

Get an Agent Token

curl -X POST https://api.synchronity.app/v1/auth/agents/register \
  -H "Content-Type: application/json" \
  -d '{
    "name": "my-agent",
    "scopes": ["read_products", "manage_cart", "execute_checkout", "read_orders"]
  }'

Available Tools

Tool	Description
list_sites	List connected stores
search_products	Search products on a connected store
get_product	Get full product details by ID
get_product_reviews	Get reviews for a product
compare_products	Compare products across multiple stores
create_cart	Create a new shopping cart
get_cart	Get current cart contents
add_to_cart	Add an item to the cart
remove_from_cart	Remove an item from the cart
apply_coupon	Apply a discount coupon
set_shipping_address	Set the shipping destination and fetch shipping rates
select_shipping_option	Select a shipping rate; binds it to the cart total
execute_checkout	Place the order (requires delegation approval)
get_order	Get order details by ID
list_orders	List recent orders
request_delegation	Request human approval for checkout
submit_delegation_otp	Submit the emailed delegation approval code
check_delegation	Poll delegation approval status
get_payment_methods	List available payment channels for an order
initiate_payment	Start in-chat payment for an order
submit_payment_otp	Submit a payment OTP when prompted
get_payment_status	Poll payment/order status until paid

Links

• TypeScript SDK