Connector guide7-minute read16 MCP tools7 languages

Connect Éxito to ChatGPT via MCP: Offers and Stock

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.

HCBy HelpCode teamUpdated 7 min read Open-source on GitHub

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

Grupo Éxito Marketplace

Grupo Éxito Marketplace

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.

tools

16

Region

INTL

Category

E-commerce

Authentication

Sign-in token

Required env vars

EXITO_USERNAMEEXITO_PASSWORDEXITO_API_KEYEXITO_LOGIN_URLEXITO_SELLER_ID
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

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 ChatGPT in 2 minutes

Start a free trial on AnythingMCP Cloud, connect Grupo Éxito Marketplace in the guided setup, then add your MCP URL to ChatGPT. No code and no server to run.

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

AnythingMCP's plugin in ChatGPT's directory answers questions from your company databases on AnythingMCP Cloud (PostgreSQL, MySQL, SQL Server, Oracle, SAP HANA, SQLite, MongoDB, read-only): open the listing (opens in a new tab) and click Install plugin. Every other connector is added to ChatGPT as a custom MCP server with your AnythingMCP MCP URL.

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.

Grupo Éxito Marketplace · 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 → 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 + ChatGPT

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.

  1. Paste the API user (an e-mail address) into EXITO_USERNAME and the API password into EXITO_PASSWORD, both from Éxito's instructions.
  2. Paste the x-api-key from the same instructions into EXITO_API_KEY.
  3. Paste the full https:// address of the token request into EXITO_LOGIN_URL. It is not published on developers.exito.com, so copy it from the document Éxito sent.
  4. Put your numeric seller id (idSeller, e.g. 11795) into EXITO_SELLER_ID. exito_marketplace_get_bulk_upload_status also shows it as data.idSeller.
  5. Install the connector. Run exito_marketplace_list_categories to 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:

  1. Pick the most specific category with exito_marketplace_list_categories and read its specifications with exito_marketplace_get_category_features. Required specifications must be sent; a specification with a list of values only accepts those.
  2. 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.
  3. Follow the batch with exito_marketplace_get_bulk_upload_status. No new batch is accepted while one is starting or processing.
  4. Éxito's content team reviews every product. exito_marketplace_get_products_waiting lists those in review, exito_marketplace_get_products_rejected those rejected with the reason, and exito_marketplace_get_products_pending_seller_approval those 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.
  5. Give approved products a price and stock with exito_marketplace_upsert_offers or, for one EAN, exito_marketplace_update_offer_price_stock. exito_marketplace_load_products_and_offers sends 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 ChatGPT

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.

ChatGPT adds MCP servers as plugins on its Plugins page, on the web and on paid plans. Developer mode is no longer needed. In a Business workspace only admins and owners can add one; in Enterprise and Edu an admin can grant the Create plugins with MCPs permission.

  1. Go to chatgpt.com/plugins, click Add, then Add custom MCP server.
  2. Enter a name, e.g. Name: Grupo Éxito Marketplace.
  3. Under Connection, enter the Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID and keep Authentication on OAuth.
  4. Select I understand and want to continue, then Create as a plugin. When ChatGPT asks, sign in to AnythingMCP and allow access.
  5. Install the new plugin from your personal plugins, then type @ in a chat and pick it.

Available tools

ToolWhat it does
exito_marketplace_get_productsList 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_waitingProducts waiting for approval by Éxito's content team (moderation), with EAN, name, image, processing date and parent reference
exito_marketplace_get_products_rejectedProducts É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_approvalProducts 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_statusStatus of your last product creation batch (exito_marketplace_create_products). data.status: 4 starting, 1 processing, 2 completed…
exito_marketplace_list_categoriesAll Éxito marketplace categories with Id, IdParent, Name and ProductType (Technology or Clothing)
exito_marketplace_get_categoryOne category by id: Id, IdParent, Name and ProductType
exito_marketplace_get_category_featuresSpecification groups of a category: for each spec its specName, label, whether it is required and its allowed values (values[].label; an…
exito_marketplace_get_ordersOrders received through Éxito's sites (exito.com, carulla.com and others) with order number, channel, dates, status, totals, commission…
exito_marketplace_get_billsPayout statements (billing) of the seller: billing number, order number, payment order, concept, payment date, commission, total, IVA and…
exito_marketplace_create_productsCreate products (or change existing ones: send the same EAN again; ModifyImage "1" replaces the images) with title, HTML description…
exito_marketplace_load_products_and_offersSend 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_offersCreate 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_stockChange 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_trackingMark products of an order as shipped with the carrier and tracking number (orders with standard delivery)
exito_marketplace_upload_order_invoiceAttach 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

Does the free ChatGPT plan work with custom MCP servers? OpenAI documents custom MCP servers for paid plans only; the Free plan is not on its list.

Next steps

Was this guide helpful?

Connect Grupo Éxito Marketplace to ChatGPT in 2 minutes

Start a free trial on AnythingMCP Cloud, connect Grupo Éxito Marketplace in the guided setup, then add your MCP URL to ChatGPT. No code and no server to run.

Related guides

Connectors

Connect Éxito to Claude via MCP: Products and Orders

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.

Connectors

Connect Éxito to Microsoft Copilot via MCP

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.

Connectors

Connect Éxito to Cursor via MCP: Catalog Uploads

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.

Connectors

Connect Éxito to Gemini CLI via MCP: Orders

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.

Connectors

Connect Éxito to Meta Muse via MCP: Store Orders

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.

Connectors

Éxito MCP Server: Products, Offers and Orders

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.