How do I install Synchronity?

Copy the http config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Synchronity need an API key?

The publisher lists these environment variables: GATEWAY_URL, DEFAULT_SITE_ID.

What transport does Synchronity use?

Synchronity is reached over HTTP.

When was Synchronity last checked?

Last checked 2026-11-10. Shop connected e-commerce stores: search, compare, cart, and checkout with buyer approval.

Synchronity MCP server

Power your agent

Add this server

The publisher's own URL. Not a PlugMCP endpoint.

Add to Cursor Add in Claude Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Server URL

https://api.synchronity.app/mcp

Credentials from the publisher

GATEWAY_URL — Synchronity gateway base URL. Defaults to the hosted gateway.
DEFAULT_SITE_ID — Optional store ID to use when the assistant does not name a store.

The Claude button above opens Claude with the name and URL filled in. You still confirm it there.

shClaude Code

1claude mcp add --transport http io.github.themewireco-synchronity https://api.synchronity.app/mcp

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "io.github.themewireco-synchronity": {4      "command": "npx",5      "args": [6        "-y",7        "mcp-remote",8        "https://api.synchronity.app/mcp"9      ]10    }11  }12}

claude_desktop_config.json

Remote · HTTPPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Remote

Transport: http
Version: 0.5.21

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

Synchronity is commerce infrastructure for AI assistants. It connects to the hosted Synchronity gateway at https://api.synchronity.app — there is nothing to self-host.

This repository contains the public, MIT-licensed pieces:

Part	What it is
`packages/mcp`	The MCP server — exposes shopping tools to Claude, Cursor, and any MCP client
`packages/sdk`	Typed gateway client used by the MCP server
`desktop-extension`	Claude Desktop extension (`.mcpb`) source — a zero-dependency bridge to the gateway
`plugins/synchronity`	Cross-assistant plugin (Claude Code + Codex) — install via the marketplace below
`woocommerce`	The Synchronity WooCommerce plugin — makes a store agent-ready

Releases attach prebuilt artifacts: the synchronity.mcpb desktop extension and the WooCommerce plugin zip. See Releases.

For shoppers — connect your AI assistant

Claude Desktop (easiest)

Download synchronity.mcpb from the latest release (or from api.synchronity.app/setup/download).
Open it with Claude Desktop and click Install.
Ask Claude to shop — e.g. "Search Synchronity for a wireless keyboard."

Claude Code (plugin marketplace)

/plugin marketplace add themewireco/synchronity
/plugin install synchronity@synchronity

Then just shop — "find me a birthday cake from my stores". The plugin bundles the synchronity-commerce skill and runs the MCP server locally via npx, so there is nothing to clone or build.

Codex

Add the Synchronity plugin from this repo (plugins/synchronity). Codex reads .codex-plugin/plugin.json and connects to the hosted MCP at https://api.synchronity.app/mcp, with the same synchronity-commerce skill.

Any MCP client (manual)

npm install && npm run build

{
  "mcpServers": {
    "synchronity": {
      "command": "node",
      "args": ["/absolute/path/to/synchronity/packages/mcp/dist/index.js"],
      "env": { "GATEWAY_URL": "https://api.synchronity.app" }
    }
  }
}

GATEWAY_URL defaults to https://api.synchronity.app. Sensitive actions (checkout, payment) require buyer approval — the assistant walks you through a one-time approval step.

What the assistant can do

Product search & details (with inline images), compare across stores, reviews, cart management, shipping, checkout, card/mobile-money payment, order tracking, and human-in-the-loop approval for sensitive actions.

For merchants — make your WooCommerce store agent-ready

Download the WooCommerce plugin zip from the latest release.
In WordPress: Plugins → Add New → Upload Plugin, choose the zip, Install and Activate.
Open WooCommerce → Synchronity, copy your connector key, and register your store with Synchronity.

Your store keeps its own catalog, currency, shipping, and orders — Synchronity routes agent requests to it through the gateway.

Build the artifacts yourself

npm run build         # build the MCP server + client
npm run build:mcpb    # -> synchronity.mcpb (Claude Desktop extension)
npm run build:plugin  # -> synchronity-woocommerce-v<version>.zip

Configuration

Env var	Default	Purpose
`GATEWAY_URL`	`https://api.synchronity.app`	Synchronity gateway base URL
`DEFAULT_SITE_ID`	—	Optional default store to scope tools to
`DEBUG`	`false`	Verbose logging to stderr

Reviewing & testing

New here or reviewing the connector? Follow the end-to-end walkthrough: docs/reviewer-testing.md.

Privacy & support

Privacy Policy: PRIVACY.md · at synchronity.app/privacy-policy
Support: [email protected]

Synchronity

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Synchronity?

Does Synchronity need an API key?

What transport does Synchronity use?

When was Synchronity last checked?

Documentation

For shoppers — connect your AI assistant

Claude Desktop (easiest)

Claude Code (plugin marketplace)

Codex

Any MCP client (manual)

What the assistant can do

For merchants — make your WooCommerce store agent-ready

Build the artifacts yourself

Configuration

Reviewing & testing

Privacy & support

License