Plytix MCP Server

A lightweight, stateless Model Context Protocol (MCP) server that provides AI assistants with live access to Plytix PIM (Product Information Management) data. This server enables AI tools like Claude Desktop, Claude mobile app, and other MCP clients to search, look up, and retrieve product information directly from the Plytix API.

Note: This is a stateless, live API tool for read and write operations. For sync, caching, or ETL workflows, pair it with a separate persistence layer of your choosing.

Features

• 51 MCP tools via stdio and 46 via the remote worker
• Smart product lookup with automatic identifier detection (SKU, MPN, GTIN, label)
• Family & inheritance tracking with overwritten_attributes support
• Schema discovery for attributes and search filters
• Automatic authentication with token refresh
• Rate limit handling — proactive pacing to the account’s advertised window plus jittered 429/5xx backoff
• Zero persistence — stateless, no database required
• Remote server support — Deploy to Cloudflare Workers for mobile/web access

Installation

Prerequisites

• Node.js 20+
• Plytix PIM account with API access

Setup

1. Clone and install:

git clone https://github.com/Supplyline/plytix-mcp.git
cd plytix-mcp
npm install

2. Configure credentials:

cp .env.example .env
# Edit .env with your Plytix API credentials

3. Build the project:

npm run build

Usage

With Claude Desktop

Add to your Claude Desktop MCP configuration (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "plytix": {
      "command": "node",
      "args": ["/path/to/plytix-mcp/dist/index.js"],
      "env": {
        "PLYTIX_API_KEY": "your_api_key_here",
        "PLYTIX_API_PASSWORD": "your_api_password_here"
      }
    }
  }
}

Standalone

npm start          # Production mode
npm run dev        # Development with hot reload

Remote Server (Cloudflare Workers)

Deploy as a remote MCP server for access from Claude mobile app, web clients, or shared team access.

Quick Deploy

# Install dependencies (includes wrangler)
npm install

# Login to Cloudflare
wrangler login

# Deploy to Cloudflare Workers
npm run deploy

Using the Remote Server

Once deployed, connect from any MCP client using the deployed URL and your Plytix credentials:

# With Claude Desktop (using mcp-remote)
npx mcp-remote https://plytix-mcp.your-subdomain.workers.dev/mcp \
  --header "X-Plytix-API-Key: YOUR_API_KEY" \
  --header "X-Plytix-API-Password: YOUR_API_PASSWORD"

The remote worker exposes 56 tools. It intentionally omits local-only utilities and filesystem tools: identifier_detect, identifier_normalize, match_score, products_batch_update_manifest, and products_batch_export_to_file.

Protocol versions