Skip to content
MCP server

TD SYNNEX MCP

StreamOne ION reseller API plus a local licence book: renewals, margin, seat true-up

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
0.1.7
Listing updated
4 days ago

About TD SYNNEX MCP

TD SYNNEX MCP is an open-source MCP server. It runs locally on your machine and is started by your AI client.

Install

Run in a terminal

claude mcp add td-synnex-mcp --env TD_SYNNEX_ACCOUNT_ID='<TD_SYNNEX_ACCOUNT_ID>' --env TD_SYNNEX_ACCESS_TOKEN='<TD_SYNNEX_ACCESS_TOKEN>' --env TD_SYNNEX_REFRESH_TOKEN='<TD_SYNNEX_REFRESH_TOKEN>' --env TD_SYNNEX_MCP_HTTP_TOKEN='<TD_SYNNEX_MCP_HTTP_TOKEN>' --env PRINTING_PRESS_CLIENT_PROFILE='<PRINTING_PRESS_CLIENT_PROFILE>' -- npx -y https://github.com/Servosity/msp-skills/releases/download/td-synnex-v0.1.7/td-synnex-mcp.mcpb

Add to claude_desktop_config.json

{
  "mcpServers": {
    "td-synnex-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Servosity/msp-skills/releases/download/td-synnex-v0.1.7/td-synnex-mcp.mcpb"
      ],
      "env": {
        "TD_SYNNEX_ACCOUNT_ID": "<TD_SYNNEX_ACCOUNT_ID>",
        "TD_SYNNEX_ACCESS_TOKEN": "<TD_SYNNEX_ACCESS_TOKEN>",
        "TD_SYNNEX_REFRESH_TOKEN": "<TD_SYNNEX_REFRESH_TOKEN>",
        "TD_SYNNEX_MCP_HTTP_TOKEN": "<TD_SYNNEX_MCP_HTTP_TOKEN>",
        "PRINTING_PRESS_CLIENT_PROFILE": "<PRINTING_PRESS_CLIENT_PROFILE>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "td-synnex-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Servosity/msp-skills/releases/download/td-synnex-v0.1.7/td-synnex-mcp.mcpb"
      ],
      "env": {
        "TD_SYNNEX_ACCOUNT_ID": "<TD_SYNNEX_ACCOUNT_ID>",
        "TD_SYNNEX_ACCESS_TOKEN": "<TD_SYNNEX_ACCESS_TOKEN>",
        "TD_SYNNEX_REFRESH_TOKEN": "<TD_SYNNEX_REFRESH_TOKEN>",
        "TD_SYNNEX_MCP_HTTP_TOKEN": "<TD_SYNNEX_MCP_HTTP_TOKEN>",
        "PRINTING_PRESS_CLIENT_PROFILE": "<PRINTING_PRESS_CLIENT_PROFILE>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "td-synnex-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Servosity/msp-skills/releases/download/td-synnex-v0.1.7/td-synnex-mcp.mcpb"
      ],
      "env": {
        "TD_SYNNEX_ACCOUNT_ID": "<TD_SYNNEX_ACCOUNT_ID>",
        "TD_SYNNEX_ACCESS_TOKEN": "<TD_SYNNEX_ACCESS_TOKEN>",
        "TD_SYNNEX_REFRESH_TOKEN": "<TD_SYNNEX_REFRESH_TOKEN>",
        "TD_SYNNEX_MCP_HTTP_TOKEN": "<TD_SYNNEX_MCP_HTTP_TOKEN>",
        "PRINTING_PRESS_CLIENT_PROFILE": "<PRINTING_PRESS_CLIENT_PROFILE>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "td-synnex-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Servosity/msp-skills/releases/download/td-synnex-v0.1.7/td-synnex-mcp.mcpb"
      ],
      "env": {
        "TD_SYNNEX_ACCOUNT_ID": "<TD_SYNNEX_ACCOUNT_ID>",
        "TD_SYNNEX_ACCESS_TOKEN": "<TD_SYNNEX_ACCESS_TOKEN>",
        "TD_SYNNEX_REFRESH_TOKEN": "<TD_SYNNEX_REFRESH_TOKEN>",
        "TD_SYNNEX_MCP_HTTP_TOKEN": "<TD_SYNNEX_MCP_HTTP_TOKEN>",
        "PRINTING_PRESS_CLIENT_PROFILE": "<PRINTING_PRESS_CLIENT_PROFILE>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "td-synnex-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Servosity/msp-skills/releases/download/td-synnex-v0.1.7/td-synnex-mcp.mcpb"
      ],
      "env": {
        "TD_SYNNEX_ACCOUNT_ID": "<TD_SYNNEX_ACCOUNT_ID>",
        "TD_SYNNEX_ACCESS_TOKEN": "<TD_SYNNEX_ACCESS_TOKEN>",
        "TD_SYNNEX_REFRESH_TOKEN": "<TD_SYNNEX_REFRESH_TOKEN>",
        "TD_SYNNEX_MCP_HTTP_TOKEN": "<TD_SYNNEX_MCP_HTTP_TOKEN>",
        "PRINTING_PRESS_CLIENT_PROFILE": "<PRINTING_PRESS_CLIENT_PROFILE>"
      }
    }
  }
}

Configuration

  • TD_SYNNEX_ACCOUNT_IDYour StreamOne ION reseller account ID (portal Quick Access > Account Information). Fills {accountId} in every API path.Required
  • TD_SYNNEX_ACCESS_TOKENOptional override; leave blank. Run `td-synnex-cli auth mint --refresh-token-stdin` once instead: it saves the token this server reads, and `auth mint --if-expiring 15m` keeps it fresh. A pasted access token expires after 2 hours and keeps overriding the saved one.
  • TD_SYNNEX_REFRESH_TOKENLeave blank. Read only by `td-synnex-cli auth mint` before its first exchange; the MCP server never uses it. ION refresh tokens are single-use, so pipe it to `auth mint --refresh-token-stdin` instead.
  • TD_SYNNEX_BASE_URLOptional; leave blank. Sends every ION call to this base URL instead of https://ion.tdsynnex.com/api/v3, for tests and mock servers. It is never saved to the config file.
  • TD_SYNNEX_MCP_READ_ONLYOptional. Set to 1 to remove every tool that can change StreamOne ION (orders, cancellations, cart checkout, customer and product changes, subscriptions set). Any value except blank, 0, false, no or off turns it on. It also removes sync and the learning writers; the tools it keeps still write the synced store, command journal and recall statistics.
  • TD_SYNNEX_MCP_HTTP_TOKENRequired only when running the MCP server with --transport http (a remote/hosted deployment); callers must send a matching Authorization: Bearer header. Leave blank for Claude Desktop.
  • TD_SYNNEX_USER_AGENTOptional. Overrides the User-Agent the CLI sends to StreamOne ION. Leave blank to use the built-in one.
  • TD_SYNNEX_TAIL_MAX_PAGESOptional; leave blank. Raises the 50-page cap the CLI tail command drains per poll. Not used by MCP tools.
  • PRINTING_PRESS_CLIENT_PROFILEOnly used when the MCP server is bound to a tenant-gated client profile. This connector registers no tenant-gated source, so leave it blank.
  • TD_SYNNEX_NO_LOCAL_DATAOptional: set to 1 to keep no local copy of StreamOne ION data (no response cache, no store writes, sync refused).

Pricing

Open source

TD SYNNEX MCP FAQ

Is TD SYNNEX MCP free?

Yes. TD SYNNEX MCP is open source, so you can use and self-host it for free.

How do I add TD SYNNEX MCP to Claude Code?

Run this command in your terminal: claude mcp add td-synnex-mcp --env TD_SYNNEX_ACCOUNT_ID='<TD_SYNNEX_ACCOUNT_ID>' --env TD_SYNNEX_ACCESS_TOKEN='<TD_SYNNEX_ACCESS_TOKEN>' --env TD_SYNNEX_REFRESH_TOKEN='<TD_SYNNEX_REFRESH_TOKEN>' --env TD_SYNNEX_MCP_HTTP_TOKEN='<TD_SYNNEX_MCP_HTTP_TOKEN>' --env PRINTING_PRESS_CLIENT_PROFILE='<PRINTING_PRESS_CLIENT_PROFILE>' -- npx -y https://github.com/Servosity/msp-skills/releases/download/td-synnex-v0.1.7/td-synnex-mcp.mcpb