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 Cursor in 2 minutes
Start a free trial on AnythingMCP Cloud, connect Salsify in the guided setup, then add your MCP URL to Cursor. 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.
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 + Cursor
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.
- 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. - Copy the organization id from the address bar: the part after
/orgs/, starting withs-(for examples-1a2b3c4d-...). Paste it intoSALSIFY_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 Cursor
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 showsYOUR_SERVER_ID.
Cursor reads MCP servers from ~/.cursor/mcp.json. Add this entry:
{
"mcpServers": {
"anythingmcp": {
"url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
"headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
}
}
}
- Create an MCP API key in AnythingMCP under MCP Servers → your server → API keys, and paste it in place of
YOUR_MCP_API_KEY. - Save the file and restart Cursor.
- Open Cursor → Settings → MCP and check that
anythingmcpis listed and connected. - Start chatting — the agent can now call the
Salsifytools.
Available tools
| Tool | What it does |
|---|---|
salsify_list_products | List products, optionally narrowed by a Salsify filter: every property value of each product as property id and value pairs, plus system… |
salsify_get_product | Get one product by its product id: all property values (property id and value pairs, lists for multi-valued properties), system fields… |
salsify_create_product | Create 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_product | Update property values of one product: only the properties sent change; each sent value replaces the stored one, null removes it.… |
salsify_upsert_products | Create 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_product | Delete one product permanently, with its property values. Cannot be undone. Installed switched off |
salsify_list_digital_assets | List digital assets (images, videos, documents), optionally narrowed by a filter: salsify:id, salsify:name, salsify:url, salsify:format… |
salsify_get_digital_asset | Get one digital asset: salsify:id, salsify:name, salsify:url (download link), salsify:format, salsify:bytes, salsify:status (in_progress… |
salsify_create_digital_asset | Add a digital asset from a public URL; Salsify downloads it in the background (salsify:status in_progress, then completed). Optional id… |
salsify_update_digital_asset | Update a digital asset: custom metadata, salsify:name, or salsify:source_url to replace the file (which creates a new link). Only the… |
salsify_get_property | Get one property (attribute) definition: salsify:id, salsify:name, salsify:data_type (string, rich_text, number, date, boolean, enumerated… |
salsify_add_list_members | Add 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_members | Remove products (or other entities) from a Salsify list. The products themselves stay |
salsify_start_export | Start an export file of products, digital assets, properties (attribute), enumerated values (attribute_value) or everything (all). Returns… |
salsify_get_export | Get the state of an export run: status (running, completed, failed), progress, estimated_time_remaining, failure_reason and, once… |
salsify_start_import_run | Run 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_run | Get 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_run | Get 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_run | Get one run of a channel: status, timestamps and product_export_url once completed |
salsify_start_channel_run | Start 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.
Does Cursor support custom MCP servers on the free tier? Yes — MCP is available on Hobby, Pro and Business plans.
Next steps
Was this guide helpful?