Connector guide7-minute read20 MCP tools7 languages

Connect Salsify to Gemini CLI via MCP

Salsify PXM API for one organization: products and their property values, digital assets, property definitions, list membership, exports, import runs and channel runs. API key (bearer) and organization id.

HCBy HelpCode teamUpdated 7 min read Open-source on GitHub

No credit card · 7-day trial · Self-host alternative available

Salsify

Salsify

Salsify PXM API for one organization: products and their property values, digital assets, property definitions, list membership, exports, import runs and channel runs. API key (bearer) and organization id.

tools

20

Region

INTL

Category

E-commerce

Authentication

Bearer Token

Required env vars

SALSIFY_ORG_IDSALSIFY_API_TOKEN
Install in one click on Cloud

7-day free trial · No credit card

  • 7-day free trial
    No credit card required
  • GDPR & SOC 2 ready
    EU data residency, audit logs
  • Open-source on GitHub
    Open source · AGPL-3.0
  • Works with ChatGPT, Claude, Gemini
    Any MCP-compatible client

Summary

Salsify PXM API for one organization: products and their property values, digital assets, property definitions, list membership, exports, import runs and channel runs. API key (bearer) and organization id.

Guided setup

Connect Salsify to Gemini in 2 minutes

Start a free trial on AnythingMCP Cloud, connect Salsify in the guided setup, then add your MCP URL to Gemini. No code and no server to run.

No credit card · 7-day trial · Self-host alternative available

Try asking

Example prompts for Salsify

Click any prompt to copy it. Paste into Claude, ChatGPT, Cursor, Gemini, Copilot or OpenClaw to run it against this connector.

Salsify · live via MCP
Share
Opus 4.7

Claude is AI and can make mistakes. Please double-check responses.

💡 No install? Use cloud.anythingmcp.com directly. Sign in, click Connectors → Salsify, paste your credentials, mint an MCP API key and you're done. No Docker, no git clone, no local server.

Salsify + Gemini

Salsify PXM API for one organization: products and their property values, digital assets, property definitions, list membership, exports, import runs and channel runs. API key (bearer) and organization id.

Prerequisites

See the full setup instructions baked into the connector (visible in the in-app store when you select the connector). The required environment variables for this connector are:

SALSIFY_ORG_ID, SALSIFY_API_TOKEN

Step 1 — Get credentials

Setting up takes about 3 minutes.

  1. Sign in to Salsify (ideally as a dedicated integration user with only the rights it needs) and open your profile, API access (https://app.salsify.com/app/profile/edit/api). Copy the API key (generate one if empty) into SALSIFY_API_TOKEN. It acts with that user's permissions and stays valid until it is regenerated.
  2. Copy the organization id from the address bar: the part after /orgs/, starting with s- (for example s-1a2b3c4d-...). Paste it into SALSIFY_ORG_ID.

API access depends on your Salsify licence; ask your Salsify contact if the profile shows no API key. The token is sent as a bearer token.

Where to start: salsify_list_products (with a filter, or without for all) and salsify_get_product for one product. Property ids are the keys you see on products; salsify_get_property explains one.

Products: salsify_list_products, salsify_get_product, salsify_create_product, salsify_update_product. Values are keyed by property id (for example Brand, Product Name); a multi-valued property takes a list; null clears a value. Unknown property ids are created as text properties, so check spelling. salsify_upsert_products (bulk) and salsify_delete_product are installed switched off.

Digital assets: salsify_list_digital_assets, salsify_get_digital_asset, salsify_create_digital_asset (from a public URL; processed in the background), salsify_update_digital_asset. Link an asset to a product by setting the product's asset property to the asset id.

Properties and lists: salsify_get_property, salsify_add_list_members, salsify_remove_list_members. There is no documented call to list every property: export with entity_type attribute.

Exports and imports: salsify_start_export then salsify_get_export until completed; the url is a temporary link to the file. salsify_get_import_run reads an import run; salsify_start_import_run (runs a configured import, possibly over many products) is switched off.

Channels: salsify_get_latest_channel_run and salsify_get_channel_run show the state and feed link of a channel; salsify_start_channel_run is switched off because a run can publish to a retailer. The channel routes are used by Salsify's own integrations but are only partly described in the public reference.

Filters: Salsify filter language: ='Brand':'Acme' (equals), ='Product Name':^'Mug' (starts with), ='Price':>'10', =list:12345 (list members); join conditions with a comma for AND. Property names and values sit in single quotes.

Paging and limits: page from 1 and per_page up to 100; meta.total_entries gives the total. Paging stops at the 10,000th result (422): use an export for larger sets. The organization may make 10,000 requests per hour across all its users (429 above; headers x-ratelimit-remaining and x-ratelimit-reset). Errors come as 422 with an errors list; 401 means the API key is wrong; 400 with a list of organizations means the organization id is missing or wrong.

Step 2 — Install the adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Step 3 — Add the connector in Gemini

Your server URL: in AnythingMCP, open MCP Servers → the server this connector is on, and copy its URL (https://cloud.anythingmcp.com/mcp/…). Use it wherever this guide shows YOUR_SERVER_ID.

Gemini CLI reads MCP servers from ~/.gemini/settings.json (on Windows %USERPROFILE%\.gemini\settings.json). Add:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}
  1. Create an MCP API key in AnythingMCP under MCP Servers → your server → API keys, and paste it in place of YOUR_MCP_API_KEY.
  2. Save the file and restart gemini.
  3. Run /mcp inside Gemini CLI (or gemini mcp list in your shell) — anythingmcp should show as connected.
  4. Start prompting — Gemini CLI can now call the Salsify tools.

Available tools

ToolWhat it does
salsify_list_productsList products, optionally narrowed by a Salsify filter: every property value of each product as property id and value pairs, plus system…
salsify_get_productGet one product by its product id: all property values (property id and value pairs, lists for multi-valued properties), system fields…
salsify_create_productCreate a product from property id and value pairs; the product id property is required. A property id that does not exist yet is created as…
salsify_update_productUpdate property values of one product: only the properties sent change; each sent value replaces the stored one, null removes it.…
salsify_upsert_productsCreate or update up to 100 products in one call from a list of property value objects (each with the product id property). Answers with the…
salsify_delete_productDelete one product permanently, with its property values. Cannot be undone. Installed switched off
salsify_list_digital_assetsList digital assets (images, videos, documents), optionally narrowed by a filter: salsify:id, salsify:name, salsify:url, salsify:format…
salsify_get_digital_assetGet one digital asset: salsify:id, salsify:name, salsify:url (download link), salsify:format, salsify:bytes, salsify:status (in_progress…
salsify_create_digital_assetAdd a digital asset from a public URL; Salsify downloads it in the background (salsify:status in_progress, then completed). Optional id…
salsify_update_digital_assetUpdate a digital asset: custom metadata, salsify:name, or salsify:source_url to replace the file (which creates a new link). Only the…
salsify_get_propertyGet one property (attribute) definition: salsify:id, salsify:name, salsify:data_type (string, rich_text, number, date, boolean, enumerated…
salsify_add_list_membersAdd products (or other entities) to an existing Salsify list by their ids. The list id is the number in the list URL in Salsify
salsify_remove_list_membersRemove products (or other entities) from a Salsify list. The products themselves stay
salsify_start_exportStart an export file of products, digital assets, properties (attribute), enumerated values (attribute_value) or everything (all). Returns…
salsify_get_exportGet the state of an export run: status (running, completed, failed), progress, estimated_time_remaining, failure_reason and, once…
salsify_start_import_runRun an import that is already configured in Salsify (for example a JSON or CSV import from a mount point). It can change many products at…
salsify_get_import_runGet the state of an import run: status (running, completed, failed, canceled, stopped), progress and errors. Poll no more than every 15…
salsify_get_latest_channel_runGet the latest run of a channel (a product feed or publication to a retailer or site): id, status (running, completed, failed), timestamps…
salsify_get_channel_runGet one run of a channel: status, timestamps and product_export_url once completed
salsify_start_channel_runStart a new run of a channel, which regenerates its feed and, for publishing channels, sends it to the retailer or site. Installed switched…

Example prompts

  • "Which Salsify products of the brand Northwind have no product name?"
  • "Show product 00012345678905 with its property values."
  • "Start an export of the list Holiday Catalog and tell me when it is ready."
  • "When did the last channel run of our retailer channel finish, and with which errors?"
  • "Add products 00012345678905 and 00012345678912 to the list Spring Launch."

FAQ

Where do the token and organization id come from? The API key from your Salsify profile, API access, ideally of a dedicated integration user; the organization id is the part of the address after /orgs/, starting with s-. API access depends on your Salsify licence.

What does it cover? Products and their property values, digital assets, property definitions, list membership, exports, import runs and channel runs.

Which tools install switched off? salsify_upsert_products, salsify_delete_product, salsify_start_import_run and salsify_start_channel_run, because a channel run can publish to a retailer. Switch them on on the connector page only if the AI should use them.

Where does Gemini CLI look for MCP servers? In ~/.gemini/settings.json for your user, or in .gemini/settings.json inside a project. gemini mcp list shows each server and whether it connects.

Next steps

Was this guide helpful?

Connect Salsify to Gemini in 2 minutes

Start a free trial on AnythingMCP Cloud, connect Salsify in the guided setup, then add your MCP URL to Gemini. No code and no server to run.

Related guides

Connectors

Connect Salsify to ChatGPT via MCP

Salsify PXM API for one organization: products and their property values, digital assets, property definitions, list membership, exports, import runs and channel runs. API key (bearer) and organization id.

Connectors

Connect Salsify to Claude via MCP

Salsify PXM API for one organization: products and their property values, digital assets, property definitions, list membership, exports, import runs and channel runs. API key (bearer) and organization id.

Connectors

Connect Salsify to Microsoft Copilot via MCP

Salsify PXM API for one organization: products and their property values, digital assets, property definitions, list membership, exports, import runs and channel runs. API key (bearer) and organization id.

Connectors

Connect Salsify to Cursor via MCP

Salsify PXM API for one organization: products and their property values, digital assets, property definitions, list membership, exports, import runs and channel runs. API key (bearer) and organization id.

Connectors

Connect Salsify to Meta Muse via MCP

Salsify PXM API for one organization: products and their property values, digital assets, property definitions, list membership, exports, import runs and channel runs. API key (bearer) and organization id.

Connectors

Salsify MCP Server: Products, Assets and Exports

Salsify PXM API for one organization: products and their property values, digital assets, property definitions, list membership, exports, import runs and channel runs. API key (bearer) and organization id.