{
  "markdown": "<p align=\"center\">\n  <img src=\"icon.png\" width=\"96\" height=\"96\" alt=\"Synchronity\" />\n</p>\n\n<h1 align=\"center\">Synchronity</h1>\n\n<p align=\"center\">Shop anything online with AI — search, compare, and buy across connected stores from any AI assistant.</p>\n\n---\n\nSynchronity is commerce infrastructure for AI assistants. It connects to the hosted **Synchronity gateway** at `https://api.synchronity.app` — there is nothing to self-host.\n\nThis repository contains the public, MIT-licensed pieces:\n\n| Part | What it is |\n|---|---|\n| [`packages/mcp`](packages/mcp) | The MCP server — exposes shopping tools to Claude, Cursor, and any MCP client |\n| [`packages/sdk`](packages/sdk) | Typed gateway client used by the MCP server |\n| [`desktop-extension`](desktop-extension) | Claude Desktop extension (`.mcpb`) source — a zero-dependency bridge to the gateway |\n| [`plugins/synchronity`](plugins/synchronity) | Cross-assistant plugin (Claude Code + Codex) — install via the marketplace below |\n| [`woocommerce`](woocommerce) | The Synchronity WooCommerce plugin — makes a store agent-ready |\n\n> Releases attach prebuilt artifacts: the **`synchronity.mcpb`** desktop extension and the **WooCommerce plugin zip**. See [Releases](https://github.com/themewireco/synchronity/releases).\n\n## For shoppers — connect your AI assistant\n\n### Claude Desktop (easiest)\n\n1. Download **`synchronity.mcpb`** from the [latest release](https://github.com/themewireco/synchronity/releases/latest) (or from [api.synchronity.app/setup/download](https://api.synchronity.app/setup/download)).\n2. Open it with Claude Desktop and click **Install**.\n3. Ask Claude to shop — e.g. *\"Search Synchronity for a wireless keyboard.\"*\n\n### Claude Code (plugin marketplace)\n\n```bash\n/plugin marketplace add themewireco/synchronity\n/plugin install synchronity@synchronity\n```\n\nThen just shop — *\"find me a birthday cake from my stores\"*. The plugin bundles\nthe `synchronity-commerce` skill and runs the MCP server locally via `npx`, so\nthere is nothing to clone or build.\n\n### Codex\n\nAdd the **Synchronity** plugin from this repo (`plugins/synchronity`). Codex\nreads `.codex-plugin/plugin.json` and connects to the hosted MCP at\n`https://api.synchronity.app/mcp`, with the same `synchronity-commerce` skill.\n\n### Any MCP client (manual)\n\n```bash\nnpm install && npm run build\n```\n\n```jsonc\n{\n  \"mcpServers\": {\n    \"synchronity\": {\n      \"command\": \"node\",\n      \"args\": [\"/absolute/path/to/synchronity/packages/mcp/dist/index.js\"],\n      \"env\": { \"GATEWAY_URL\": \"https://api.synchronity.app\" }\n    }\n  }\n}\n```\n\n`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.\n\n### What the assistant can do\n\nProduct 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.\n\n## For merchants — make your WooCommerce store agent-ready\n\n1. Download the **WooCommerce plugin zip** from the [latest release](https://github.com/themewireco/synchronity/releases/latest).\n2. In WordPress: **Plugins → Add New → Upload Plugin**, choose the zip, **Install** and **Activate**.\n3. Open **WooCommerce → Synchronity**, copy your connector key, and register your store with Synchronity.\n\nYour store keeps its own catalog, currency, shipping, and orders — Synchronity routes agent requests to it through the gateway.\n\n## Build the artifacts yourself\n\n```bash\nnpm run build         # build the MCP server + client\nnpm run build:mcpb    # -> synchronity.mcpb (Claude Desktop extension)\nnpm run build:plugin  # -> synchronity-woocommerce-v<version>.zip\n```\n\n## Configuration\n\n| Env var | Default | Purpose |\n|---|---|---|\n| `GATEWAY_URL` | `https://api.synchronity.app` | Synchronity gateway base URL |\n| `DEFAULT_SITE_ID` | — | Optional default store to scope tools to |\n| `DEBUG` | `false` | Verbose logging to stderr |\n\n## Reviewing & testing\n\nNew here or reviewing the connector? Follow the end-to-end walkthrough: [docs/reviewer-testing.md](docs/reviewer-testing.md).\n\n## Privacy & support\n\n- Privacy Policy: [PRIVACY.md](PRIVACY.md) · at [synchronity.app/privacy-policy](https://synchronity.app/privacy-policy)\n- Support: hello@themewire.co\n\n## License\n\nMIT © Themewire — see [LICENSE](LICENSE).\n",
  "bytes": 4397,
  "sha": "3cfde2fceb6ffaf85021950487270da18a3add4cd3d612be547ec4bcc467fb8c",
  "repo_slug": "themewireco/synchronity",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_themewireco_synchronity_073edf2f/readme"
}