# Syncro [Health: Active]

**Category:** 🎧 Support & Service Management  
**Repository:** https://github.com/WYRE-AI/syncro-mcp  
**GitHub Stars:** 4  
**Views:** 1  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/syncro

## Description
MCP server for Syncro MSP — customers, tickets, assets, invoices, and more.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "syncro": {
    "command": "npx",
    "args": ["-y","github:WYRE-AI/syncro-mcp"],
    "env": {
      "SYNCRO_API_KEY": "",
      "SYNCRO_SUBDOMAIN": "",
      "NODE_AUTH_TOKEN": "",
      "GITHUB_TOKEN": "",
      "MCP_BRAND_NAME": "",
      "MCP_BRAND_LOGO_URL": "",
      "MCP_BRAND_PRIMARY_COLOR": "",
      "MCP_BRAND_ACCENT_COLOR": ""
    }
  }
}
```

**Requires environment variables:** `SYNCRO_API_KEY`, `SYNCRO_SUBDOMAIN`, `NODE_AUTH_TOKEN`, `GITHUB_TOKEN`, `MCP_BRAND_NAME`, `MCP_BRAND_LOGO_URL`, `MCP_BRAND_PRIMARY_COLOR`, `MCP_BRAND_ACCENT_COLOR` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What Syncro MCP server does

The Syncro MCP server exposes selected Syncro MSP operations through the Model Context Protocol. It covers five domains: customers, tickets, assets, contacts, and invoices. Depending on the domain, an agent can list, search, retrieve, create, update, add comments, or email invoices.

Customer tools support listing with filters, lookup by ID, creation, and text search. Ticket tools cover filtered listing, retrieval, creation, updates, and comments. Asset tools provide listing, lookup, and searches by query or serial number. Contact tools handle listing, retrieval, and creation. Invoice tools support listing, retrieval, creation, and emailing an invoice.

## How it works

The Syncro MCP server uses a decision-tree navigation model rather than exposing every domain tool at once. At startup, navigation and status operations are available. An agent selects a domain with `syncro_navigate`, uses the tools loaded for that domain, and can return to the main menu with `syncro_back`. `syncro_status` reports the current navigation state and credential status.

Domain handlers and the Syncro client load on demand. This structure is intended to reduce the number of simultaneously visible tools and improve tool selection. The underlying Syncro API client automatically handles the documented limit of 180 requests per minute.

The ticket retrieval tool can render an interactive ticket card in MCP Apps hosts such as Claude Desktop and the web experience. The card supports an in-card add-comment round trip through the ticket comment operation. Other hosts retain plain JSON behavior. Card branding can be supplied through window injection or the documented `MCP_BRAND_*` variables.

## Setup and configuration

Use the hosted WYRE MCP Gateway by configuring an HTTP MCP endpoint and passing `X-Syncro-Api-Key` with the API key. Local deployment options include the Claude Code CLI, the GHCR Docker image, and a source checkout built with npm.

Set `SYNCRO_API_KEY` to a Syncro API key generated under Syncro MSP Settings > API Tokens. `SYNCRO_SUBDOMAIN` is optional and applies when a subdomain is needed. Source and package installation require access to the private `@wyre-technology/node-syncro` SDK on GitHub Packages. Set `NODE_AUTH_TOKEN` for local npm installation; cloud builds need a `read:packages` token, with Cloudflare using `NODE_AUTH_TOKEN` and DigitalOcean using the build-time `GITHUB_TOKEN` secret.

For a source build, install dependencies, run `npm run build`, and start `node dist/index.js`. The repository also documents development, type-checking, and lint commands.

## Tools and capabilities

Available navigation tools are `syncro_navigate`, `syncro_back`, and `syncro_status`. Domain tools include:

- Customers: list, get, create, and search.
- Tickets: list, get, create, update, and add a comment.
- Assets: list, get, and search.
- Contacts: list, get, and create.
- Invoices: list, get, create, and email.

Most list operations accept filters such as customer ID, status, query, email, asset type, or date. Create and update operations accept the fields documented by the corresponding Syncro operation.

## Limitations and notes

A valid Syncro API key is required. The optional subdomain setting may still be needed for accounts that use one. One-click cloud deployment is not install-and-run without GitHub Packages authentication because the private SDK requires a token on every package install.

Interactive ticket cards are host-dependent, while other hosts receive the regular JSON result. Syncro API usage is subject to 180 requests per minute, with rate limiting handled by the underlying SDK.

_Full upstream README: https://allmcps.com/mcp/syncro/readme_