Summary
Let your AI run your exito.com marketplace store in Colombia through Grupo Éxito's seller API: list your products and their approval status, create products with images, descriptions and attributes, set prices and stock, and read orders and payout statements.
Guided setup
Connect Grupo Éxito Marketplace to Meta Muse in 2 minutes
Start a free trial on AnythingMCP Cloud, connect Grupo Éxito Marketplace in the guided setup, then add your MCP URL to Meta Muse. No code and no server to run.
No credit card · 7-day trial · Self-host alternative available
Try asking
Example prompts for Grupo Éxito Marketplace
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 → Grupo Éxito Marketplace, paste your credentials, mint an MCP API key and you're done. No Docker, no
git clone, no local server.
Grupo Éxito Marketplace + Meta Muse
Let your AI run your exito.com marketplace store in Colombia through Grupo Éxito's seller API: list your products and their approval status, create products with images, descriptions and attributes, set prices and stock, and read orders and payout statements.
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:
EXITO_USERNAME, EXITO_PASSWORD, EXITO_API_KEY, EXITO_LOGIN_URL, EXITO_SELLER_ID
Step 1 — Get credentials
Setting up takes about 10 minutes once Éxito has granted you API access. With that access Éxito sends authentication instructions: a username, a password, an API key and the address that issues the token. You also need your numeric seller id.
There is no sandbox: Éxito documents none, so every call, writes included, acts on your live store.
- Paste the API user (an e-mail address) into
EXITO_USERNAMEand the API password intoEXITO_PASSWORD, both from Éxito's instructions. - Paste the
x-api-keyfrom the same instructions intoEXITO_API_KEY. - Paste the full
https://address of the token request intoEXITO_LOGIN_URL. It is not published on developers.exito.com, so copy it from the document Éxito sent. - Put your numeric seller id (idSeller, e.g.
11795) intoEXITO_SELLER_ID.exito_marketplace_get_bulk_upload_statusalso shows it asdata.idSeller. - Install the connector. Run
exito_marketplace_list_categoriesto check the connection.
How it signs in: the connector asks the token address for a token with your username, password and API key, and sends it with the API key on every call. Tokens are renewed automatically, every hour at the latest. The password and the key are stored encrypted and never shown to the AI.
Cloud and self-hosted work the same way: the credentials are the same, and there is no redirect URL to set.
Selling on Éxito is asynchronous:
- Pick the most specific category with
exito_marketplace_list_categoriesand read its specifications withexito_marketplace_get_category_features. Required specifications must be sent; a specification with a list of values only accepts those. - Create products with
exito_marketplace_create_products, up to 400 EANs per call. Images are public URLs, 1000x1000 px (733x1000 px for clothing). The brand must already exist at Éxito; your Éxito account manager creates a missing one. - Follow the batch with
exito_marketplace_get_bulk_upload_status. No new batch is accepted while one is starting or processing. - Éxito's content team reviews every product.
exito_marketplace_get_products_waitinglists those in review,exito_marketplace_get_products_rejectedthose rejected with the reason, andexito_marketplace_get_products_pending_seller_approvalthose that differ from the same product already in the marketplace. After approval a product needs up to an hour before it can get an offer. - Give approved products a price and stock with
exito_marketplace_upsert_offersor, for one EAN,exito_marketplace_update_offer_price_stock.exito_marketplace_load_products_and_offerssends products and offers in one request. Offers reach the sites within about 4 hours.
Prices and stock: prices are whole Colombian pesos above 8000, without separators (45000). A sale price must be lower than the price. To change only the price, send the current stock with IsUpdatedStock 0. A price change of more than 30% comes back with code PEX and needs to be sent again with price approval: the AI asks you before doing that. To stop selling a product, set its stock to 0: the API has no delete.
Orders and payouts: exito_marketplace_get_orders lists orders from exito.com, carulla.com and Éxito's other sites, with status, totals, commission and delivery type. exito_marketplace_get_bills lists payout statements. Lists page with paginationToken.
Switched off at install: exito_marketplace_set_order_tracking (mark products of an order as shipped, with carrier and tracking number) and exito_marketplace_upload_order_invoice (attach the invoice to an order). Switch them on on the connector page when the AI should handle orders; the AI asks you to confirm every call. Creating products and setting prices and stock is switched on (exito_marketplace_create_products, exito_marketplace_load_products_and_offers, exito_marketplace_upsert_offers, exito_marketplace_update_offer_price_stock).
Read every answer: batch writes answer HTTP 200 with one message per refused EAN, so a 200 does not mean every product or offer was accepted. Requests and answers are in Spanish.
Not covered: shipping labels, Éxito's moderation and offer notifications, and anything the Seller Center web app does that the API does not offer.
Common errors: if no token is issued, check the username, password and API key against Éxito's instructions, and that EXITO_LOGIN_URL is the token address from that document. 401 means the token was refused. 403 usually means the API key is missing or wrong, or the API is not enabled for your user: ask Éxito which APIs your access covers.
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 Muse
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.
Muse adds remote MCP servers as custom connectors and signs in to them with OAuth.
- In Muse, open Settings → Connectors and choose Add custom connector.
- Paste the MCP server URL
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. - Muse opens the AnythingMCP sign-in page: sign in and approve access.
- In a chat, ask Muse for something that needs the
Grupo Éxito Marketplacetools.
You can also set it up from a chat, on the web, in the iOS and Android apps or in WhatsApp. Send Muse this message:
Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth
Self-hosting? Use your instance's public HTTPS address instead of https://cloud.anythingmcp.com. Muse connects from Meta's cloud, so localhost does not work.
Available tools
| Tool | What it does |
|---|---|
exito_marketplace_get_products | List the seller's products in the Éxito marketplace with name, EAN, VTEX PLU, image, created and updated dates, price, sale price, stock… |
exito_marketplace_get_products_waiting | Products waiting for approval by Éxito's content team (moderation), with EAN, name, image, processing date and parent reference |
exito_marketplace_get_products_rejected | Products Éxito's content team rejected and that must be corrected, with EAN, name, image, Reason and Comment of the rejection |
exito_marketplace_get_products_pending_seller_approval | Products that need your decision because they differ from the same product already in the marketplace: each row has oldProduct and… |
exito_marketplace_get_bulk_upload_status | Status of your last product creation batch (exito_marketplace_create_products). data.status: 4 starting, 1 processing, 2 completed… |
exito_marketplace_list_categories | All Éxito marketplace categories with Id, IdParent, Name and ProductType (Technology or Clothing) |
exito_marketplace_get_category | One category by id: Id, IdParent, Name and ProductType |
exito_marketplace_get_category_features | Specification groups of a category: for each spec its specName, label, whether it is required and its allowed values (values[].label; an… |
exito_marketplace_get_orders | Orders received through Éxito's sites (exito.com, carulla.com and others) with order number, channel, dates, status, totals, commission… |
exito_marketplace_get_bills | Payout statements (billing) of the seller: billing number, order number, payment order, concept, payment date, commission, total, IVA and… |
exito_marketplace_create_products | Create products (or change existing ones: send the same EAN again; ModifyImage "1" replaces the images) with title, HTML description… |
exito_marketplace_load_products_and_offers | Send products together with their offers in one request: each item has a Product (the fields of exito_marketplace_create_products) and an… |
exito_marketplace_upsert_offers | Create or update offers (price, sale price, stock, shipping and delivery promise) for EANs that Éxito already approved, in all Éxito sites… |
exito_marketplace_update_offer_price_stock | Change the price and/or stock of one existing offer (one EAN). Éxito needs EAN, Stock and Price on every update: to change only the price… |
exito_marketplace_set_order_tracking | Mark products of an order as shipped with the carrier and tracking number (orders with standard delivery) |
exito_marketplace_upload_order_invoice | Attach the invoice of an order as a base64 PDF or ZIP |
Example prompts
- "Which of my products did Éxito reject, and why?"
- "Show the orders assigned to me this week that still need to ship."
- "What is the price and stock of EAN 7701234567890 on exito.com?"
- "Set the stock of EAN 7701234567890 to 25 units and keep the price."
- "Sum up the commission in my payout statements for October."
FAQ
Where is Muse available? Meta currently offers Muse in the US and Canada, on the web, in the iOS and Android apps and in WhatsApp.
Does Meta review this connector? No. Meta doesn't review custom connectors. Muse sees only the tools you switched on for this MCP server in AnythingMCP, and you can disconnect it anytime under Settings → Connectors.
Next steps
Was this guide helpful?