Mergado MCP Server

This domain hosts the MCP (Model Context Protocol) server for Mergado. It provides a unified interface for AI assistants to access Mergado tools, product feeds, and data management capabilities.Tato doména hostuje MCP (Model Context Protocol) server pro Mergado. Poskytuje jednotné rozhraní pro přístup AI asistentů k nástrojům Mergado, produktovým feedům a dalším funkcím platformy.Táto doména hostuje MCP (Model Context Protocol) server pre Mergado. Poskytuje jednotné rozhranie pre prístup AI asistentov k nástrojom Mergado, produktovým feedom a ďalším funkciám platformy.Ez a domain a Mergado MCP (Model Context Protocol) szerverét szolgálja ki. Egységes felületet biztosít az AI asszisztensek számára a Mergado eszközeihez, termékfeedjeihez és adatkezelési funkcióihoz.

Contact supportKontaktovat podporuKontaktovať podporuKapcsolat a támogatással

Getting StartedJak se připojitAko sa pripojiťElső lépések

AuthenticationAutentizaceAutentifikáciaHitelesítés

The Mergado MCP server requires authentication. There are two ways:Mergado MCP server vyžaduje autentizaci. Existují dva způsoby:Mergado MCP server vyžaduje autentifikáciu. Existujú dva spôsoby:A Mergado MCP szerver hitelesítést igényel. Két módja van:

Sign in through your client (Recommended)Přihlášení přes klienta (doporučeno)Prihlásenie cez klienta (odporúčané)Bejelentkezés a kliensen keresztül (ajánlott)

Some MCP clients (like ChatGPT or Claude) have sign-in built right into MCP. Just add the MCP server URL and the client redirects you to log in and authorize access to Mergado on its own - no token or manual setup needed.Někteří MCP klienti (např. ChatGPT nebo Claude) mají přihlášení zabudované přímo v MCP. Stačí zadat URL MCP serveru a klient vás sám přesměruje na přihlášení a autorizaci do Mergada - žádný token ani jeho ruční nastavení není potřeba.Niektorí MCP klienti (napr. ChatGPT alebo Claude) majú prihlásenie zabudované priamo v MCP. Stačí zadať URL MCP servera a klient vás sám presmeruje na prihlásenie a autorizáciu do Mergada - žiadny token ani jeho ručné nastavenie nie je potrebné.Egyes MCP kliensekben (például a ChatGPT-ben vagy a Claude-ban) a bejelentkezés közvetlenül az MCP-be van építve. Elég megadni az MCP szerver URL-jét, és a kliens magától átirányítja Önt a Mergadóba való bejelentkezésre és engedélyezésre - nincs szükség tokenre vagy kézi beállításra.

Client registration is automatic. The client registers itself with the server on first connect - there's nothing to create or fill in by hand.Registrace klienta probíhá automaticky. Klient se k serveru zaregistruje sám při prvním připojení - nemusíte nic ručně vytvářet ani nikam vyplňovat.Registrácia klienta prebieha automaticky. Klient sa k serveru zaregistruje sám pri prvom pripojení - nemusíte nič ručne vytvárať ani nikam vypĺňať.A kliens regisztrációja automatikusan történik. A kliens az első csatlakozáskor magától regisztrál a szerveren - semmit nem kell kézzel létrehoznia vagy kitöltenie.

Bearer tokenBearer tokenBearer tokenBearer token

Clients that don't support signing in through MCP use a Personal Access Token (PAT). Add it to every request in the Authorization header:Klienti, kteří přihlášení přes MCP nepodporují, použijí Personal Access Token (PAT). Přidejte jej do každého požadavku v hlavičce Authorization:Klienti, ktorí prihlásenie cez MCP nepodporujú, použijú Personal Access Token (PAT). Pridajte ho do každej požiadavky v hlavičke Authorization:Azok a kliensek, amelyek nem támogatják az MCP-n keresztüli bejelentkezést, Personal Access Tokent (PAT) használnak. Adja hozzá minden kéréshez az Authorization fejlécben:

Authorization: Bearer YOUR_TOKEN

You can create a PAT in your Mergado account: Personal Access Token ->PAT vytvoříte v nastavení svého účtu Mergado: Osobní přístupový token ->PAT vytvoríte v nastavení svojho účtu Mergado: Osobný prístupový token ->PAT-ot a Mergado fiókja beállításaiban hozhat létre: Személyes hozzáférési token ->

Server URLURL serveruURL serveraA szerver URL-je

The Mergado MCP server URL is:URL Mergado MCP serveru je:URL Mergado MCP servera je:A Mergado MCP szerver URL-je: 

https://mcp.mergado.com

Client SetupNastavení klientaNastavenie klientaA kliens beállítása

Select your MCP client to see the setup instructions.Vyberte svého MCP klienta a zobrazte pokyny k nastavení.Vyberte svojho MCP klienta a zobrazte pokyny na nastavenie.Válassza ki az MCP kliensét a beállítási útmutató megjelenítéséhez.

ChatGPT supports remote MCP servers with built-in sign-in.ChatGPT podporuje vzdálené MCP servery se zabudovaným přihlášením.ChatGPT podporuje vzdialené MCP servery so zabudovaným prihlásením.A ChatGPT beépített bejelentkezéssel támogatja a távoli MCP szervereket.

  1. Enable Developer mode in Settings -> Apps -> Advanced settingsZapněte Developer mode v Settings -> Apps -> Advanced settingsZapnite Developer mode v Settings -> Apps -> Advanced settingsKapcsolja be a Developer mode beállítást itt: Settings -> Apps -> Advanced settings
  2. Go to Settings -> Apps -> Create appPřejděte do Settings -> Apps -> Create appPrejdite do Settings -> Apps -> Create appLépjen a Settings -> Apps -> Create app menüpontra
  3. Paste the MCP server URL: https://mcp.mergado.comVložte URL MCP serveru: https://mcp.mergado.comVložte URL MCP servera: https://mcp.mergado.comIllessze be az MCP szerver URL-jét: https://mcp.mergado.com
  4. ChatGPT will handle authorization automatically - you'll be redirected to log inChatGPT provede autorizaci automaticky - budete přesměrováni na přihlášeníChatGPT vykoná autorizáciu automaticky - budete presmerovaní na prihlásenieA ChatGPT automatikusan elvégzi az engedélyezést - át lesz irányítva a bejelentkezésre
  5. After authorizing, the server tools will be available in your conversationsPo autorizaci budou nástroje serveru dostupné ve vašich konverzacíchPo autorizácii budú nástroje servera dostupné vo vašich konverzáciáchAz engedélyezés után a szerver eszközei elérhetők lesznek a beszélgetéseiben
Remote MCP servers in ChatGPT require a Plus, Pro, Business, Enterprise, or Edu plan with Developer mode enabled.Vzdálené MCP servery v ChatGPT vyžadují plán Plus, Pro, Business, Enterprise nebo Edu se zapnutým Developer mode.Vzdialené MCP servery v ChatGPT vyžadujú plán Plus, Pro, Business, Enterprise alebo Edu so zapnutým Developer mode.A távoli MCP szerverekhez a ChatGPT-ben Plus, Pro, Business, Enterprise vagy Edu előfizetés szükséges, bekapcsolt Developer mode mellett.

Claude.ai supports remote MCP servers with built-in sign-in.Claude.ai podporuje vzdálené MCP servery se zabudovaným přihlášením.Claude.ai podporuje vzdialené MCP servery so zabudovaným prihlásením.A Claude.ai beépített bejelentkezéssel támogatja a távoli MCP szervereket.

  1. Open claude.ai -> Settings -> ConnectorsOtevřete claude.ai -> Settings -> ConnectorsOtvorte claude.ai -> Settings -> ConnectorsNyissa meg a claude.ai -> Settings -> Connectors menüpontot
  2. Click Add custom connector and paste the MCP server URLKlikněte na Add custom connector a vložte URL MCP serveruKliknite na Add custom connector a vložte URL MCP serveraKattintson az Add custom connector gombra, és illessze be az MCP szerver URL-jét
  3. Claude will redirect you to log in and authorizeClaude vás přesměruje na přihlášení a autorizaciClaude vás presmeruje na prihlásenie a autorizáciuA Claude átirányítja Önt a bejelentkezésre és az engedélyezésre
  4. Once connected, the server tools will appear in your conversationsPo připojení se nástroje serveru zobrazí ve vašich konverzacíchPo pripojení sa nástroje servera zobrazia vo vašich konverzáciáchA csatlakozás után a szerver eszközei megjelennek a beszélgetéseiben
Custom connectors are available on the Free, Pro, Max, Team, and Enterprise plans (Free is limited to one connector). On Team and Enterprise, only Owners can add a connector.Vlastní konektory jsou dostupné v plánech Free, Pro, Max, Team a Enterprise (Free je omezen na jeden konektor). V plánech Team a Enterprise může konektor přidat pouze vlastník (Owner).Vlastné konektory sú dostupné v plánoch Free, Pro, Max, Team a Enterprise (Free je obmedzený na jeden konektor). V plánoch Team a Enterprise môže konektor pridať iba vlastník (Owner).Az egyéni konnektorok a Free, Pro, Max, Team és Enterprise csomagokban érhetők el (a Free egyetlen konnektorra van korlátozva). A Team és Enterprise csomagokban konnektort csak a tulajdonos (Owner) adhat hozzá.

Claude Desktop supports remote MCP servers via its configuration file.Claude Desktop podporuje vzdálené MCP servery přes konfigurační soubor.Claude Desktop podporuje vzdialené MCP servery cez konfiguračný súbor.A Claude Desktop konfigurációs fájlon keresztül támogatja a távoli MCP szervereket.

  1. Open Claude Desktop -> Settings -> Developer -> Edit ConfigOtevřete Claude Desktop -> Settings -> Developer -> Edit ConfigOtvorte Claude Desktop -> Settings -> Developer -> Edit ConfigNyissa meg a Claude Desktopot -> Settings -> Developer -> Edit Config
  2. Edit the file claude_desktop_config.json:Upravte soubor claude_desktop_config.json:Upravte súbor claude_desktop_config.json:Szerkessze a claude_desktop_config.json fájlt:
    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.jsonmacOS: ~/Library/Application Support/Claude/claude_desktop_config.jsonmacOS: ~/Library/Application Support/Claude/claude_desktop_config.jsonmacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%\Claude\claude_desktop_config.jsonWindows: %APPDATA%\Claude\claude_desktop_config.jsonWindows: %APPDATA%\Claude\claude_desktop_config.jsonWindows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "mergado": {
      "url": "https://mcp.mergado.com",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

If your Claude Desktop version doesn't support remote HTTP MCP servers directly, use the mcp-remote bridge via npx (requires Node.js):Pokud vaše verze Claude Desktop nepodporuje vzdálené HTTP MCP servery přímo, použijte mcp-remote bridge přes npx (vyžaduje Node.js):Ak vaša verzia Claude Desktop nepodporuje vzdialené HTTP MCP servery priamo, použite mcp-remote bridge cez npx (vyžaduje Node.js):Ha az Ön Claude Desktop verziója nem támogatja közvetlenül a távoli HTTP MCP szervereket, használja az mcp-remote bridge-et npx-en keresztül (Node.js szükséges hozzá):

{
  "mcpServers": {
    "mergado-npx": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.mergado.com",
        "--header",
        "Authorization: Bearer YOUR_TOKEN"
      ]
    }
  }
}
After saving, fully quit and relaunch Claude Desktop. Closing the window isn't enough - on Windows and macOS it keeps running in the system tray. Right-click the tray icon and choose Quit (or Cmd + Q on macOS) before launching again.Po uložení Claude Desktop zcela ukončete a znovu spusťte. Zavření okna nestačí - na Windows a macOS běží na pozadí v systémové liště. Klikněte pravým tlačítkem na ikonu v liště a zvolte Quit (nebo Cmd + Q na macOS).Po uložení Claude Desktop úplne ukončite a znova spustite. Zatvorenie okna nestačí - na Windows a macOS beží na pozadí v systémovej lište. Kliknite pravým tlačidlom na ikonu v lište a zvoľte Quit (alebo Cmd + Q na macOS).Mentés után teljesen lépjen ki a Claude Desktopból, majd indítsa újra. Az ablak bezárása nem elég - Windowson és macOS-en a háttérben, a tálcán tovább fut. Kattintson jobb gombbal a tálcaikonra, és válassza a Quit lehetőséget (vagy Cmd + Q macOS-en).

Add an MCP server using the claude mcp add command:Přidejte MCP server příkazem claude mcp add:Pridajte MCP server príkazom claude mcp add:Adja hozzá az MCP szervert a claude mcp add paranccsal:

claude mcp add mergado \
  --transport http \
  https://mcp.mergado.com \
  --header "Authorization: Bearer YOUR_TOKEN"

Or add it to the .mcp.json file in your project root:Nebo jej přidejte do souboru .mcp.json v kořenovém adresáři projektu:Alebo ho pridajte do súboru .mcp.json v koreňovom adresári projektu:Vagy adja hozzá a projekt gyökerében lévő .mcp.json fájlhoz:

{
  "mcpServers": {
    "mergado": {
      "type": "http",
      "url": "https://mcp.mergado.com",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

Cursor supports remote MCP servers via its settings.Cursor podporuje vzdálené MCP servery přes nastavení.Cursor podporuje vzdialené MCP servery cez nastavenia.A Cursor a beállításokon keresztül támogatja a távoli MCP szervereket.

  1. Open Cursor -> Settings -> MCPOtevřete Cursor -> Settings -> MCPOtvorte Cursor -> Settings -> MCPNyissa meg a Cursor -> Settings -> MCP menüpontot
  2. Click Add new MCP serverKlikněte na Add new MCP serverKliknite na Add new MCP serverKattintson az Add new MCP server gombra
  3. Select type HTTP and enter the server URLVyberte typ HTTP a zadejte URL serveruVyberte typ HTTP a zadajte URL serveraVálassza a HTTP típust, és adja meg a szerver URL-jét

Or add it to .cursor/mcp.json in your project:Nebo jej přidejte do .cursor/mcp.json ve vašem projektu:Alebo ho pridajte do .cursor/mcp.json vo vašom projekte:Vagy adja hozzá a projektjében lévő .cursor/mcp.json fájlhoz:

{
  "mcpServers": {
    "mergado": {
      "url": "https://mcp.mergado.com",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

Windsurf supports MCP servers via its configuration file.Windsurf podporuje MCP servery přes konfigurační soubor.Windsurf podporuje MCP servery cez konfiguračný súbor.A Windsurf konfigurációs fájlon keresztül támogatja az MCP szervereket.

  1. Open Windsurf -> Settings -> search for MCPOtevřete Windsurf -> Settings -> vyhledejte MCPOtvorte Windsurf -> Settings -> vyhľadajte MCPNyissa meg a Windsurf -> Settings menüt -> keressen rá az MCP kifejezésre
  2. Click Add Server or edit ~/.codeium/windsurf/mcp_config.jsonKlikněte na Add Server nebo upravte ~/.codeium/windsurf/mcp_config.jsonKliknite na Add Server alebo upravte ~/.codeium/windsurf/mcp_config.jsonKattintson az Add Server gombra, vagy szerkessze a ~/.codeium/windsurf/mcp_config.json fájlt
{
  "mcpServers": {
    "mergado": {
      "serverUrl": "https://mcp.mergado.com",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

VS Code supports MCP servers through GitHub Copilot's agent mode.VS Code podporuje MCP servery prostřednictvím agent módu GitHub Copilotu.VS Code podporuje MCP servery prostredníctvom agent módu GitHub Copilotu.A VS Code a GitHub Copilot agent módján keresztül támogatja az MCP szervereket.

  1. Make sure you have the GitHub Copilot extension installedUjistěte se, že máte nainstalované rozšíření GitHub CopilotUistite sa, že máte nainštalované rozšírenie GitHub CopilotGyőződjön meg róla, hogy telepítve van a GitHub Copilot bővítmény
  2. Create a .vscode/mcp.json file in your projectVytvořte soubor .vscode/mcp.json ve svém projektuVytvorte súbor .vscode/mcp.json vo svojom projekteHozza létre a .vscode/mcp.json fájlt a projektjében
{
  "servers": {
    "mergado": {
      "type": "http",
      "url": "https://mcp.mergado.com",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

Alternatively, add it to your VS Code settings.json under the "mcp" key.Případně jej přidejte do settings.json VS Code pod klíč "mcp".Prípadne ho pridajte do settings.json VS Code pod kľúč "mcp".Vagy adja hozzá a VS Code settings.json fájljához az "mcp" kulcs alatt.

OpenWebUI supports MCP servers at two levels - globally for all users (admin), or per-user.OpenWebUI podporuje MCP servery na dvou úrovních - globálně pro všechny uživatele (admin), nebo pro jednotlivé uživatele.OpenWebUI podporuje MCP servery na dvoch úrovniach - globálne pre všetkých používateľov (admin), alebo pre jednotlivých používateľov.Az OpenWebUI két szinten támogatja az MCP szervereket - globálisan, minden felhasználó számára (admin), vagy az egyes felhasználók számára külön.

Admin-level (shared with all users)Admin úroveň (sdíleno se všemi uživateli)Admin úroveň (zdieľané so všetkými používateľmi)Admin szint (minden felhasználóval megosztva)

  1. Open Admin Panel -> Settings -> External ToolsOtevřete Admin Panel -> Settings -> External ToolsOtvorte Admin Panel -> Settings -> External ToolsNyissa meg az Admin Panel -> Settings -> External Tools menüpontot
  2. Click Add Connection, then click OpenAPI (it should switch to MCP Streamable HTTP)Klikněte na Add Connection, pak na OpenAPI (přepne se na MCP Streamable HTTP)Kliknite na Add Connection, potom na OpenAPI (prepne sa na MCP Streamable HTTP)Kattintson az Add Connection, majd az OpenAPI gombra (átvált MCP Streamable HTTP módra)
  3. Fill in URL, ID, and NameVyplňte URL, ID a NameVyplňte URL, ID a NameTöltse ki az URL, ID és Name mezőket
  4. For Bearer token auth, enter Bearer YOUR_TOKEN in the API Key fieldPro Bearer token zadejte Bearer YOUR_TOKEN do pole API KeyPre Bearer token zadajte Bearer YOUR_TOKEN do poľa API KeyBearer token esetén írja be a Bearer YOUR_TOKEN értéket az API Key mezőbe
  5. For OAuth, switch from Bearer to OAuth 2.1 and click Register ClientPro OAuth přepněte z Bearer na OAuth 2.1 a klikněte na Register ClientPre OAuth prepnite z Bearer na OAuth 2.1 a kliknite na Register ClientOAuth esetén váltson Bearerről OAuth 2.1-re, és kattintson a Register Client gombra

User-level (personal tools)Uživatelská úroveň (osobní nástroje)Používateľská úroveň (osobné nástroje)Felhasználói szint (személyes eszközök)

  1. Click your profile icon (bottom-left) -> Settings -> External ToolsKlikněte na ikonu profilu (vlevo dole) -> Settings -> External ToolsKliknite na ikonu profilu (vľavo dole) -> Settings -> External ToolsKattintson a profilikonra (bal alul) -> Settings -> External Tools
  2. Click Add ConnectionKlikněte na Add ConnectionKliknite na Add ConnectionKattintson az Add Connection gombra
  3. Fill in API Base URL with the MCP server URLDo pole API Base URL zadejte URL MCP serveruDo poľa API Base URL zadajte URL MCP serveraAz API Base URL mezőbe írja be az MCP szerver URL-jét
  4. Fill in the API Key field with your Personal Access Token (PAT)Do pole API Key zadejte váš Personal Access Token (PAT)Do poľa API Key zadajte váš Personal Access Token (PAT)Az API Key mezőbe írja be a Personal Access Tokenjét (PAT)
The admin must enable User MCP Connections in Admin Panel -> Settings -> External Tools for user-level connections to work.Admin musí povolit User MCP Connections v Admin Panel -> Settings -> External Tools, aby uživatelská připojení fungovala.Admin musí povoliť User MCP Connections v Admin Panel -> Settings -> External Tools, aby používateľské pripojenia fungovali.Az adminnak engedélyeznie kell a User MCP Connections beállítást az Admin Panel -> Settings -> External Tools menüben, hogy a felhasználói kapcsolatok működjenek.

Any MCP-compatible client can connect to Mergado MCP servers. The servers use the HTTP Streaming transport (Streamable HTTP). To connect, your client needs:Jakýkoli MCP-kompatibilní klient se může připojit k Mergado MCP serverům. Servery používají transport HTTP Streaming (Streamable HTTP). Pro připojení váš klient potřebuje:Akýkoľvek MCP-kompatibilný klient sa môže pripojiť k Mergado MCP serverom. Servery používajú transport HTTP Streaming (Streamable HTTP). Na pripojenie váš klient potrebuje:Bármely MCP-kompatibilis kliens csatlakozhat a Mergado MCP szerverekhez. A szerverek HTTP Streaming (Streamable HTTP) transzportot használnak. A csatlakozáshoz a kliensének a következőkre van szüksége:

  1. Server URL - e.g. https://mcp.mergado.comURL serveru - např. https://mcp.mergado.comURL servera - napr. https://mcp.mergado.comA szerver URL-je - például https://mcp.mergado.com
  2. Transport - HTTP Streaming (Streamable HTTP, sometimes listed as http or streamable-http)Transport - HTTP Streaming (Streamable HTTP, někdy označovaný jako http nebo streamable-http)Transport - HTTP Streaming (Streamable HTTP, niekedy označovaný ako http alebo streamable-http)Transzport - HTTP Streaming (Streamable HTTP, néha http vagy streamable-http néven szerepel)
  3. Authentication - Authorization: Bearer YOUR_TOKEN header, or sign in through MCP if the client supports itAutentizace - hlavička Authorization: Bearer YOUR_TOKEN, případně přihlášení přes MCP, pokud ho klient podporujeAutentifikácia - hlavička Authorization: Bearer YOUR_TOKEN, prípadne prihlásenie cez MCP, ak ho klient podporujeHitelesítés - Authorization: Bearer YOUR_TOKEN fejléc, vagy MCP-n keresztüli bejelentkezés, ha a kliens támogatja

For a list of known MCP clients and their capabilities, see the official MCP client list.Seznam známých MCP klientů a jejich možností najdete na oficiálním seznamu MCP klientů.Zoznam známych MCP klientov a ich možností nájdete na oficiálnom zozname MCP klientov.Az ismert MCP kliensek és képességeik listáját a hivatalos MCP kliens-listán találja.

MCP InspectorMCP InspectorMCP InspectorMCP Inspector

MCP Inspector is a tool for testing MCP servers interactively from your browser - handy when you want to try the server out without setting up a client.MCP Inspector je nástroj pro interaktivní testování MCP serverů přímo z prohlížeče - hodí se, pokud si chcete server vyzkoušet bez nastavování klienta.MCP Inspector je nástroj na interaktívne testovanie MCP serverov priamo z prehliadača - hodí sa, ak si chcete server vyskúšať bez nastavovania klienta.Az MCP Inspector egy eszköz az MCP szerverek interaktív teszteléséhez, közvetlenül a böngészőből - jól jön, ha kliens beállítása nélkül szeretné kipróbálni a szervert.

PrerequisitesPožadavkyPožiadavkyKövetelmények

How to useJak používatAko používaťHasználata

  1. Run in your terminal:Ve svém terminálu spusťte:Vo svojom termináli spustite:Futtassa a termináljában: 
    npx @modelcontextprotocol/inspector
  2. The Inspector UI will open in your browserV prohlížeči se otevře rozhraní InspectoruV prehliadači sa otvorí rozhranie InspectoraA böngészőben megnyílik az Inspector felülete
  3. Set Transport Type to Streamable HTTPJako Transport Type zvolte Streamable HTTPAko Transport Type zvoľte Streamable HTTPTransport Type értéknek válassza a Streamable HTTP lehetőséget
  4. Enter https://mcp.mergado.com in the URL fieldDo pole URL vložte https://mcp.mergado.comDo poľa URL vložte https://mcp.mergado.comAz URL mezőbe illessze be ezt: https://mcp.mergado.com
  5. For authentication, add an Authorization header with the value Bearer YOUR_TOKEN (your Personal Access Token)Pro autentizaci přidejte hlavičku Authorization s hodnotou Bearer YOUR_TOKEN (váš Personal Access Token)Pre autentifikáciu pridajte hlavičku Authorization s hodnotou Bearer YOUR_TOKEN (váš Personal Access Token)A hitelesítéshez adjon hozzá egy Authorization fejlécet Bearer YOUR_TOKEN értékkel (ez az Ön Personal Access Tokenje)
  6. Click ConnectKlikněte na ConnectKliknite na ConnectKattintson a Connect gombra

Official Inspector documentation ->Oficiální dokumentace Inspectoru ->Oficiálna dokumentácia Inspectora ->Az Inspector hivatalos dokumentációja ->

Available toolsDostupné nástrojeDostupné nástrojeElérhető eszközök

109

Below is the full list of tools this MCP server provides to connected AI assistants. Select a tool to see what it does, its input parameters, and whether it only reads or also writes data.Níže je úplný seznam nástrojů, které tento MCP server poskytuje připojeným AI asistentům. Rozkliknutím nástroje zobrazíte, co dělá, jeho vstupní parametry a zda data pouze čte, nebo také zapisuje.Nižšie je úplný zoznam nástrojov, ktoré tento MCP server poskytuje pripojeným AI asistentom. Rozkliknutím nástroja zobrazíte, čo robí, jeho vstupné parametre a či dáta iba číta, alebo aj zapisuje.Az alábbiakban a teljes lista látható azokról az eszközökről, amelyeket ez az MCP szerver a csatlakoztatott AI asszisztensek rendelkezésére bocsát. Egy eszközre kattintva megjelenik, hogy mit csinál, milyen bemeneti paramétereket vár, és hogy csak olvassa vagy írja is az adatokat.

assign_query_to_rule Writes dataZapisuje dataZapisuje dátaAdatot ír
Attaches an existing query to a rule, adding to its scope (the rule applies to the UNION of all attached queries). Use to scope a rule down after creating it, or to add another query. The query must already exist - create it first with `create_project_query`, then attach it here.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • query_id string requiredpovinnépovinnékötelező
    ID of existing query to assign. Query must exist or 400 is returned.
  • rule_id string requiredpovinnépovinnékötelező
    ID of the rule to assign query to
create_batch_copy_values_rule Writes dataZapisuje dataZapisuje dátaAdatot ír
Create a 'Batch Copy Values' rule in a project. Copy the content of a source element into a target element for matching products. Multiple source -> target mappings can be specified in a single rule. Provide this rule type's parameters in the typed `data` object (its fields are fixed by the schema). At least one query is required in `queries` (objects `[{"id": "..."}]`) use the ♥ALLPRODUCTS♥ query to target every product. Mergado applies the rule automatically on the next rebuild — do not force recalculation. After creating, read the rule back with `get_rule` and verify its effect on a sample once the rebuild runs. Use when the user wants to copy values from one element to another in bulk (also swaps via a temporary element).
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • data object requiredpovinnépovinnékötelező
    Rule-type-specific configuration payload. Its fields are fixed by this rule type's schema (see the nested object's properties) the backend validates them authoritatively. Example: `{"rows":[{"source_element_path":"g:title","target_element_path":"g:custom_label_0","position":0}]}`
  • project_id string requiredpovinnépovinnékötelező
    ID of the project the rule is created in. Obtain it from `list_shop_projects`.
  • queries array requiredpovinnépovinnékötelező
    Queries selecting which products the rule applies to, as a list of objects `[{"id": "<query_id>"}]` (NOT strings). At least one query is required for this rule type. To target every product, pass the system ♥ALLPRODUCTS♥ query whose ID is each project's `all_products_query_id` in `list_shop_projects`.
  • applies boolean optionalvolitelnévoliteľnéválasztható
    Whether the rule is active (vs. paused).
  • element_path string optionalvolitelnévoliteľnéválasztható
    Target element path must already exist in the project.
  • is_deletable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_editable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_movable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_pausable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • name string optionalvolitelnévoliteľnéválasztható
    Human-readable rule name (max 100 chars).
  • placement object optionalvolitelnévoliteľnéválasztható
    Relative placement using `before`/`after` rule IDs takes precedence over `priority`.
  • priority string optionalvolitelnévoliteľnéválasztható
    Numeric string controlling rule order (lower priority runs earlier). Required in practice: omitting it returns 400 "Failed to determine rule priority". Pass e.g. "100" to append at the end; use `list_project_rules` to see existing priorities.
create_batch_delivery_rule Writes dataZapisuje dataZapisuje dátaAdatot ír
Create a 'Batch Delivery' rule in a project. Add delivery information (courier company, price, cash-on-delivery price) to products. Multiple delivery options can be specified in a single rule. Provide this rule type's parameters in the typed `data` object (its fields are fixed by the schema). At least one query is required in `queries` (objects `[{"id": "..."}]`) use the ♥ALLPRODUCTS♥ query to target every product. Mergado applies the rule automatically on the next rebuild — do not force recalculation. After creating, read the rule back with `get_rule` and verify its effect on a sample once the rebuild runs. Use when the user wants shipping/delivery prices composed per carrier.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • data object requiredpovinnépovinnékötelező
    Rule-type-specific configuration payload. Its fields are fixed by this rule type's schema (see the nested object's properties) the backend validates them authoritatively. Example: `{"rows":[{"type":"CESKA_POSTA","price":"99","price_cod":"129"}]}`
  • project_id string requiredpovinnépovinnékötelező
    ID of the project the rule is created in. Obtain it from `list_shop_projects`.
  • queries array requiredpovinnépovinnékötelező
    Queries selecting which products the rule applies to, as a list of objects `[{"id": "<query_id>"}]` (NOT strings). At least one query is required for this rule type. To target every product, pass the system ♥ALLPRODUCTS♥ query whose ID is each project's `all_products_query_id` in `list_shop_projects`.
  • applies boolean optionalvolitelnévoliteľnéválasztható
    Whether the rule is active (vs. paused).
  • element_path string optionalvolitelnévoliteľnéválasztható
    Target element path must already exist in the project.
  • is_deletable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_editable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_movable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_pausable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • name string optionalvolitelnévoliteľnéválasztható
    Human-readable rule name (max 100 chars).
  • placement object optionalvolitelnévoliteľnéválasztható
    Relative placement using `before`/`after` rule IDs takes precedence over `priority`.
  • priority string optionalvolitelnévoliteľnéválasztható
    Numeric string controlling rule order (lower priority runs earlier). Required in practice: omitting it returns 400 "Failed to determine rule priority". Pass e.g. "100" to append at the end; use `list_project_rules` to see existing priorities.
create_batch_param_rule Writes dataZapisuje dataZapisuje dátaAdatot ír
Create a 'Batch Param' rule in a project. Add product parameters (name/value/unit triples) in bulk. This is used for shopping feed PARAM elements such as those on Heureka. Provide this rule type's parameters in the typed `data` object (its fields are fixed by the schema). At least one query is required in `queries` (objects `[{"id": "..."}]`) use the ♥ALLPRODUCTS♥ query to target every product. Mergado applies the rule automatically on the next rebuild — do not force recalculation. After creating, read the rule back with `get_rule` and verify its effect on a sample once the rebuild runs. Use when the user wants product parameters added per query; the `ep_*` settings must be full nested element paths.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • data object requiredpovinnépovinnékötelező
    Rule-type-specific configuration payload. Its fields are fixed by this rule type's schema (see the nested object's properties) the backend validates them authoritatively. Example: `{"settings":{"ep_param":"g:product_detail","ep_param_name":"g:product_detail | g:attribute_name","ep_param_value":"g:product_detail | g:attribute_value"},"rows":[{"queries":["<query_id>"],"params":[{"param_name":"Material","value":"Cotton"}]}]}`
  • project_id string requiredpovinnépovinnékötelező
    ID of the project the rule is created in. Obtain it from `list_shop_projects`.
  • queries array requiredpovinnépovinnékötelező
    Queries selecting which products the rule applies to, as a list of objects `[{"id": "<query_id>"}]` (NOT strings). At least one query is required for this rule type. To target every product, pass the system ♥ALLPRODUCTS♥ query whose ID is each project's `all_products_query_id` in `list_shop_projects`.
  • applies boolean optionalvolitelnévoliteľnéválasztható
    Whether the rule is active (vs. paused).
  • element_path string optionalvolitelnévoliteľnéválasztható
    Target element path must already exist in the project.
  • is_deletable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_editable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_movable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_pausable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • name string optionalvolitelnévoliteľnéválasztható
    Human-readable rule name (max 100 chars).
  • placement object optionalvolitelnévoliteľnéválasztható
    Relative placement using `before`/`after` rule IDs takes precedence over `priority`.
  • priority string optionalvolitelnévoliteľnéválasztható
    Numeric string controlling rule order (lower priority runs earlier). Required in practice: omitting it returns 400 "Failed to determine rule priority". Pass e.g. "100" to append at the end; use `list_project_rules` to see existing priorities.
create_batch_rewriting_rule Writes dataZapisuje dataZapisuje dátaAdatot ír
Create a 'Batch Rewriting' rule in a project. Rewrite an element's content per query condition. Each row associates a query (filter) with the replacement value. Products matching the query receive the specified value. Provide this rule type's parameters in the typed `data` object (its fields are fixed by the schema). At least one query is required in `queries` (objects `[{"id": "..."}]`) use the ♥ALLPRODUCTS♥ query to target every product. Mergado applies the rule automatically on the next rebuild — do not force recalculation. After creating, read the rule back with `get_rule` and verify its effect on a sample once the rebuild runs. Use when the user wants a different value written per query (per-product or per-segment writes in one rule).
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • data object requiredpovinnépovinnékötelező
    Rule-type-specific configuration payload. Its fields are fixed by this rule type's schema (see the nested object's properties) the backend validates them authoritatively. Example: `{"rows":[{"query_id":123456,"value":"New value","position":0}]}`
  • project_id string requiredpovinnépovinnékötelező
    ID of the project the rule is created in. Obtain it from `list_shop_projects`.
  • queries array requiredpovinnépovinnékötelező
    Queries selecting which products the rule applies to, as a list of objects `[{"id": "<query_id>"}]` (NOT strings). At least one query is required for this rule type. To target every product, pass the system ♥ALLPRODUCTS♥ query whose ID is each project's `all_products_query_id` in `list_shop_projects`.
  • applies boolean optionalvolitelnévoliteľnéválasztható
    Whether the rule is active (vs. paused).
  • element_path string optionalvolitelnévoliteľnéválasztható
    Target element path must already exist in the project.
  • is_deletable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_editable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_movable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_pausable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • name string optionalvolitelnévoliteľnéválasztható
    Human-readable rule name (max 100 chars).
  • placement object optionalvolitelnévoliteľnéválasztható
    Relative placement using `before`/`after` rule IDs takes precedence over `priority`.
  • priority string optionalvolitelnévoliteľnéválasztható
    Numeric string controlling rule order (lower priority runs earlier). Required in practice: omitting it returns 400 "Failed to determine rule priority". Pass e.g. "100" to append at the end; use `list_project_rules` to see existing priorities.
create_batch_rewriting_values_rule Writes dataZapisuje dataZapisuje dátaAdatot ír
Create a 'Bulk Rewriting by Values' rule in a project. Looks up each product's value in a SOURCE element and, when it matches a row's input_value, writes the row's output_value into a DESTINATION element — a lookup/mapping table (e.g. map source categories to target names). CAUTION — the two element-path fields are counter-intuitive: the top-level `element_path` is the DESTINATION (written into), while `data.target_element_path` is the SOURCE (searched); swapping them silently writes into the wrong element. Provide this rule type's parameters in the typed `data` object. At least one query is required in `queries` (objects [{"id": "..."}]); use the ♥ALLPRODUCTS♥ query to target every product. Mergado applies the rule automatically on the next rebuild — do not force recalculation. After creating, read the rule back with `get_rule` and verify its effect on a sample once the rebuild runs. Use when the user wants a lookup/mapping table (source value → output value).
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • data object requiredpovinnépovinnékötelező
    Rule-type-specific configuration payload. Its fields are fixed by this rule type's schema (see the nested object's properties) the backend validates them authoritatively. Example: `{"regex":false,"target_element_path":"CATEGORYTEXT","rows":[{"input_value":"Old","output_value":"New","position":0}]}`
  • project_id string requiredpovinnépovinnékötelező
    ID of the project the rule is created in. Obtain it from `list_shop_projects`.
  • queries array requiredpovinnépovinnékötelező
    Queries selecting which products the rule applies to, as a list of objects `[{"id": "<query_id>"}]` (NOT strings). At least one query is required for this rule type. To target every product, pass the system ♥ALLPRODUCTS♥ query whose ID is each project's `all_products_query_id` in `list_shop_projects`.
  • applies boolean optionalvolitelnévoliteľnéválasztható
    Whether the rule is active (vs. paused).
  • element_path string optionalvolitelnévoliteľnéválasztható
    Target element path must already exist in the project.
  • is_deletable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_editable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_movable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_pausable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • name string optionalvolitelnévoliteľnéválasztható
    Human-readable rule name (max 100 chars).
  • placement object optionalvolitelnévoliteľnéválasztható
    Relative placement using `before`/`after` rule IDs takes precedence over `priority`.
  • priority string optionalvolitelnévoliteľnéválasztható
    Numeric string controlling rule order (lower priority runs earlier). Required in practice: omitting it returns 400 "Failed to determine rule priority". Pass e.g. "100" to append at the end; use `list_project_rules` to see existing priorities.
create_batch_set_datetime_rule Writes dataZapisuje dataZapisuje dátaAdatot ír
Create a 'Batch Set Datetime' rule in a project. Set a date element to today's date plus a configurable number of days, formatted using a strftime-style format string. Each row targets products matching the listed queries. Provide this rule type's parameters in the typed `data` object (its fields are fixed by the schema). At least one query is required in `queries` (objects `[{"id": "..."}]`) use the ♥ALLPRODUCTS♥ query to target every product. Mergado applies the rule automatically on the next rebuild — do not force recalculation. After creating, read the rule back with `get_rule` and verify its effect on a sample once the rebuild runs. Use when the user wants a date (now + N days) written per query.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • data object requiredpovinnépovinnékötelező
    Rule-type-specific configuration payload. Its fields are fixed by this rule type's schema (see the nested object's properties) the backend validates them authoritatively. Example: `{"date_format":"Y-m-d","rows":[{"query_ids":["<query_id>"],"number_of_days":7}]}`
  • project_id string requiredpovinnépovinnékötelező
    ID of the project the rule is created in. Obtain it from `list_shop_projects`.
  • queries array requiredpovinnépovinnékötelező
    Queries selecting which products the rule applies to, as a list of objects `[{"id": "<query_id>"}]` (NOT strings). At least one query is required for this rule type. To target every product, pass the system ♥ALLPRODUCTS♥ query whose ID is each project's `all_products_query_id` in `list_shop_projects`.
  • applies boolean optionalvolitelnévoliteľnéválasztható
    Whether the rule is active (vs. paused).
  • element_path string optionalvolitelnévoliteľnéválasztható
    Target element path must already exist in the project.
  • is_deletable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_editable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_movable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_pausable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • name string optionalvolitelnévoliteľnéválasztható
    Human-readable rule name (max 100 chars).
  • placement object optionalvolitelnévoliteľnéválasztható
    Relative placement using `before`/`after` rule IDs takes precedence over `priority`.
  • priority string optionalvolitelnévoliteľnéválasztható
    Numeric string controlling rule order (lower priority runs earlier). Required in practice: omitting it returns 400 "Failed to determine rule priority". Pass e.g. "100" to append at the end; use `list_project_rules` to see existing priorities.
create_bidding_rule Writes dataZapisuje dataZapisuje dátaAdatot ír
Create a 'Bidding' rule in a project. Adjust a CPC element's value based on product price. Specify an absolute increment, a percentage factor, or both. At least one field must be non-null. Provide this rule type's parameters in the typed `data` object (its fields are fixed by the schema). At least one query is required in `queries` (objects `[{"id": "..."}]`) use the ♥ALLPRODUCTS♥ query to target every product. Mergado applies the rule automatically on the next rebuild — do not force recalculation. After creating, read the rule back with `get_rule` and verify its effect on a sample once the rebuild runs. Use when the user wants CPC bidding values set.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • data object requiredpovinnépovinnékötelező
    Rule-type-specific configuration payload. Its fields are fixed by this rule type's schema (see the nested object's properties) the backend validates them authoritatively. Example: `{"bidding_strategy":"pricePercentage","price_percentage":10}`
  • project_id string requiredpovinnépovinnékötelező
    ID of the project the rule is created in. Obtain it from `list_shop_projects`.
  • queries array requiredpovinnépovinnékötelező
    Queries selecting which products the rule applies to, as a list of objects `[{"id": "<query_id>"}]` (NOT strings). At least one query is required for this rule type. To target every product, pass the system ♥ALLPRODUCTS♥ query whose ID is each project's `all_products_query_id` in `list_shop_projects`.
  • applies boolean optionalvolitelnévoliteľnéválasztható
    Whether the rule is active (vs. paused).
  • element_path string optionalvolitelnévoliteľnéválasztható
    Target element path must already exist in the project.
  • is_deletable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_editable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_movable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_pausable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • name string optionalvolitelnévoliteľnéválasztható
    Human-readable rule name (max 100 chars).
  • placement object optionalvolitelnévoliteľnéválasztható
    Relative placement using `before`/`after` rule IDs takes precedence over `priority`.
  • priority string optionalvolitelnévoliteľnéválasztható
    Numeric string controlling rule order (lower priority runs earlier). Required in practice: omitting it returns 400 "Failed to determine rule priority". Pass e.g. "100" to append at the end; use `list_project_rules` to see existing priorities.
create_calc_rule Writes dataZapisuje dataZapisuje dátaAdatot ír
Create a 'Calc' rule in a project. Evaluate a mathematical expression and write the result into an element. Supports the four basic arithmetic operations. Mergado variable expressions (e.g. `%PRICE_VAT%`) are resolved at runtime. Provide this rule type's parameters in the typed `data` object (its fields are fixed by the schema). At least one query is required in `queries` (objects `[{"id": "..."}]`) use the ♥ALLPRODUCTS♥ query to target every product. Mergado applies the rule automatically on the next rebuild — do not force recalculation. After creating, read the rule back with `get_rule` and verify its effect on a sample once the rebuild runs. Use when the user wants a computed numeric value (margins, VAT, price adjustments).
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • data object requiredpovinnépovinnékötelező
    Rule-type-specific configuration payload. Its fields are fixed by this rule type's schema (see the nested object's properties) the backend validates them authoritatively. Example: `{"expression":"%PRICE_VAT% * 1.21","rounding_type":"mathematical"}`
  • project_id string requiredpovinnépovinnékötelező
    ID of the project the rule is created in. Obtain it from `list_shop_projects`.
  • queries array requiredpovinnépovinnékötelező
    Queries selecting which products the rule applies to, as a list of objects `[{"id": "<query_id>"}]` (NOT strings). At least one query is required for this rule type. To target every product, pass the system ♥ALLPRODUCTS♥ query whose ID is each project's `all_products_query_id` in `list_shop_projects`.
  • applies boolean optionalvolitelnévoliteľnéválasztható
    Whether the rule is active (vs. paused).
  • element_path string optionalvolitelnévoliteľnéválasztható
    Target element path must already exist in the project.
  • is_deletable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_editable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_movable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_pausable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • name string optionalvolitelnévoliteľnéválasztható
    Human-readable rule name (max 100 chars).
  • placement object optionalvolitelnévoliteľnéválasztható
    Relative placement using `before`/`after` rule IDs takes precedence over `priority`.
  • priority string optionalvolitelnévoliteľnéválasztható
    Numeric string controlling rule order (lower priority runs earlier). Required in practice: omitting it returns 400 "Failed to determine rule priority". Pass e.g. "100" to append at the end; use `list_project_rules` to see existing priorities.
create_casechanging_rule Writes dataZapisuje dataZapisuje dátaAdatot ír
Create a 'Case Changing' rule in a project. Transform the capitalisation of text in an element. Supported modes: `lower`, `upper`, `sentence`, `word`, `firstletter`, `titlelongwords`. Provide this rule type's parameters in the typed `data` object (its fields are fixed by the schema). At least one query is required in `queries` (objects `[{"id": "..."}]`) use the ♥ALLPRODUCTS♥ query to target every product. Mergado applies the rule automatically on the next rebuild — do not force recalculation. After creating, read the rule back with `get_rule` and verify its effect on a sample once the rebuild runs. Use when the user wants to change the letter case of a value.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • data object requiredpovinnépovinnékötelező
    Rule-type-specific configuration payload. Its fields are fixed by this rule type's schema (see the nested object's properties) the backend validates them authoritatively. Example: `{"case_type":"lower"}`
  • project_id string requiredpovinnépovinnékötelező
    ID of the project the rule is created in. Obtain it from `list_shop_projects`.
  • queries array requiredpovinnépovinnékötelező
    Queries selecting which products the rule applies to, as a list of objects `[{"id": "<query_id>"}]` (NOT strings). At least one query is required for this rule type. To target every product, pass the system ♥ALLPRODUCTS♥ query whose ID is each project's `all_products_query_id` in `list_shop_projects`.
  • applies boolean optionalvolitelnévoliteľnéválasztható
    Whether the rule is active (vs. paused).
  • element_path string optionalvolitelnévoliteľnéválasztható
    Target element path must already exist in the project.
  • is_deletable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_editable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_movable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_pausable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • name string optionalvolitelnévoliteľnéválasztható
    Human-readable rule name (max 100 chars).
  • placement object optionalvolitelnévoliteľnéválasztható
    Relative placement using `before`/`after` rule IDs takes precedence over `priority`.
  • priority string optionalvolitelnévoliteľnéválasztható
    Numeric string controlling rule order (lower priority runs earlier). Required in practice: omitting it returns 400 "Failed to determine rule priority". Pass e.g. "100" to append at the end; use `list_project_rules` to see existing priorities.
create_categories_rule Writes dataZapisuje dataZapisuje dátaAdatot ír
Create a 'Categories' rule in a project. Rename product categories by partial (or exact) match. Each row maps an input pattern to an output replacement. Provide this rule type's parameters in the typed `data` object (its fields are fixed by the schema). At least one query is required in `queries` (objects `[{"id": "..."}]`) use the ♥ALLPRODUCTS♥ query to target every product. Mergado applies the rule automatically on the next rebuild — do not force recalculation. After creating, read the rule back with `get_rule` and verify its effect on a sample once the rebuild runs. Use when the user wants to bulk-rename categories into the format's category element (it ignores a custom `element_path`).
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • data object requiredpovinnépovinnékötelező
    Rule-type-specific configuration payload. Its fields are fixed by this rule type's schema (see the nested object's properties) the backend validates them authoritatively. Example: `{"rows":[{"input":"Shop > Shoes","output":"Apparel & Accessories > Shoes","position":0}]}`
  • project_id string requiredpovinnépovinnékötelező
    ID of the project the rule is created in. Obtain it from `list_shop_projects`.
  • queries array requiredpovinnépovinnékötelező
    Queries selecting which products the rule applies to, as a list of objects `[{"id": "<query_id>"}]` (NOT strings). At least one query is required for this rule type. To target every product, pass the system ♥ALLPRODUCTS♥ query whose ID is each project's `all_products_query_id` in `list_shop_projects`.
  • applies boolean optionalvolitelnévoliteľnéválasztható
    Whether the rule is active (vs. paused).
  • element_path string optionalvolitelnévoliteľnéválasztható
    Target element path must already exist in the project.
  • is_deletable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_editable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_movable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_pausable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • name string optionalvolitelnévoliteľnéválasztható
    Human-readable rule name (max 100 chars).
  • placement object optionalvolitelnévoliteľnéválasztható
    Relative placement using `before`/`after` rule IDs takes precedence over `priority`.
  • priority string optionalvolitelnévoliteľnéválasztható
    Numeric string controlling rule order (lower priority runs earlier). Required in practice: omitting it returns 400 "Failed to determine rule priority". Pass e.g. "100" to append at the end; use `list_project_rules` to see existing priorities.
create_create_product_value_rule Writes dataZapisuje dataZapisuje dátaAdatot ír
Create an 'Add a Value to a Multi-Value Element' rule in a project. Appends a NEW value to an element that can hold multiple values (e.g. `g:additional_image_link`, categories, PARAM, alternative URLs) WITHOUT overwriting existing values — it writes to the next free position (equivalent to a Rewriting rule with element path `ELEMENT {@@POSITION = @@MAX_POSITION + 1}`). Use when the user wants to append an additional value to a multi-value element (e.g. add a second image or an extra category) without replacing what is already there. On an empty element it creates the first value; on an element that already has values it adds one more. Mergado variable expressions (e.g. `%element%`) are supported. Provide this rule type's parameters in the typed `data` object. At least one query is required in `queries` (objects `[{"id": "..."}]`); use the ♥ALLPRODUCTS♥ query to target every product. Mergado applies the rule automatically on the next rebuild — do not force recalculation. After creating, read the rule back with `get_rule` and verify its effect on a sample once the rebuild runs.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • project_id string requiredpovinnépovinnékötelező
    ID of the project the rule is created in. Obtain it from `list_shop_projects`.
  • queries array requiredpovinnépovinnékötelező
    Queries selecting which products the rule applies to, as a list of objects `[{"id": "<query_id>"}]` (NOT strings). At least one query is required for this rule type. To target every product, pass the system ♥ALLPRODUCTS♥ query whose ID is each project's `all_products_query_id` in `list_shop_projects`.
  • applies boolean optionalvolitelnévoliteľnéválasztható
    Whether the rule is active (vs. paused).
  • data object optionalvolitelnévoliteľnéválasztható
    Rule-type-specific configuration payload. Its fields are fixed by this rule type's schema (see the nested object's properties) the backend validates them authoritatively. Example: `{"value":"summer_2026"}`
  • element_path string optionalvolitelnévoliteľnéválasztható
    Target element path must already exist in the project.
  • is_deletable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_editable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_movable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_pausable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • name string optionalvolitelnévoliteľnéválasztható
    Human-readable rule name (max 100 chars).
  • placement object optionalvolitelnévoliteľnéválasztható
    Relative placement using `before`/`after` rule IDs takes precedence over `priority`.
  • priority string optionalvolitelnévoliteľnéválasztható
    Numeric string controlling rule order (lower priority runs earlier). Required in practice: omitting it returns 400 "Failed to determine rule priority". Pass e.g. "100" to append at the end; use `list_project_rules` to see existing priorities.
create_data_import_rule Writes dataZapisuje dataZapisuje dátaAdatot ír
Create a 'Data Import' rule in a project. Import product data from an external CSV or XML file (via URL) or from a previously uploaded file. The imported data is matched against products and applied as additional element values. Provide this rule type's parameters in the typed `data` object (its fields are fixed by the schema). At least one query is required in `queries` (objects `[{"id": "..."}]`) use the ♥ALLPRODUCTS♥ query to target every product. Mergado applies the rule automatically on the next rebuild — do not force recalculation. After creating, read the rule back with `get_rule` and verify its effect on a sample once the rebuild runs. Use when the user wants to enrich products from an external CSV/XML file matched by a key (use a public source URL; base64 upload is a silent no-op).
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • data object requiredpovinnépovinnékötelező
    Rule-type-specific configuration payload. Its fields are fixed by this rule type's schema (see the nested object's properties) the backend validates them authoritatively. Example: `{"file_type":"csv","data_source_type":"url","source_url":"https://docs.example.com/data.csv","matching_mode":"exact"}`
  • project_id string requiredpovinnépovinnékötelező
    ID of the project the rule is created in. Obtain it from `list_shop_projects`.
  • queries array requiredpovinnépovinnékötelező
    Queries selecting which products the rule applies to, as a list of objects `[{"id": "<query_id>"}]` (NOT strings). At least one query is required for this rule type. To target every product, pass the system ♥ALLPRODUCTS♥ query whose ID is each project's `all_products_query_id` in `list_shop_projects`.
  • applies boolean optionalvolitelnévoliteľnéválasztható
    Whether the rule is active (vs. paused).
  • element_path string optionalvolitelnévoliteľnéválasztható
    Target element path must already exist in the project.
  • is_deletable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_editable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_movable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_pausable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • name string optionalvolitelnévoliteľnéválasztható
    Human-readable rule name (max 100 chars).
  • placement object optionalvolitelnévoliteľnéválasztható
    Relative placement using `before`/`after` rule IDs takes precedence over `priority`.
  • priority string optionalvolitelnévoliteľnéválasztható
    Numeric string controlling rule order (lower priority runs earlier). Required in practice: omitting it returns 400 "Failed to determine rule priority". Pass e.g. "100" to append at the end; use `list_project_rules` to see existing priorities.
create_element Writes dataZapisuje dataZapisuje dátaAdatot ír
Creates a new element in a project. You can pass a `parent_id` to nest it under an existing element, or omit it to create a top-level element. Use this tool when you need to add an output element that is required by a target format (e.g., `g:gtin` for Google Shopping) but does not yet exist in the project's element tree. After creating the element, use a rule tool (such as a `create_<type>_rule` tool) to fill it with values.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • name string requiredpovinnépovinnékötelező
    Element name/tag (e.g. "CUSTOM_FIELD", "BRAND"). Must be valid XML tag name.
  • project_id string requiredpovinnépovinnékötelező
    ID of the project where element will be created
  • hidden boolean optionalvolitelnévoliteľnéválasztható
    Whether the element is hidden from UI
  • parent_id string optionalvolitelnévoliteľnéválasztható
    Optional ID of the parent element to nest this element under (creates a child element). Get the parent ID from `list_project_elements`. Omit to create a top-level element.
create_feedaudit Writes dataZapisuje dataZapisuje dátaAdatot ír
Creates and starts a new feed audit for a project. KNOWN ISSUE: this endpoint currently fails (400 without `feed_url` despite the schema marking it optional; HTTP 500 with a valid one) — if it fails, do not retry blindly; direct the user to Product Data Audit in the Mergado UI and read EXISTING audits instead (`list_project_feedaudits` → `get_feedaudit` → `list_feedaudit_issues`). When functional, the audit runs asynchronously: poll `get_feedaudit` until `status` is `done`.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • feed_url string requiredpovinnépovinnékötelező
    Source feed URL to audit. Required: the endpoint rejects a request without it (`400 Field 'feed_url' is not in required format`) despite the API docs implying otherwise. To audit the project's own feed, take the URL from `get_project`.
  • project_id string requiredpovinnépovinnékötelező
    ID of the project to audit. Get it from `list_shop_projects`.
  • feed_types array optionalvolitelnévoliteľnéválasztható
    Comparison-shopping formats to validate the feed against, e.g. ["heureka.cz", "zbozi.cz"]. Optional - the project default is used when omitted.
  • parser_type string optionalvolitelnévoliteľnéválasztható
    Input-feed parser type, e.g. "heureka.cz". Optional - auto-detected when omitted.
  • webhook_url string optionalvolitelnévoliteľnéválasztható
    URL pinged once the audit finishes. Optional.
create_hiding_rule Writes dataZapisuje dataZapisuje dátaAdatot ír
Create a 'Hiding' rule in a project. Hide (remove from output) all products that match the rule's queries. No additional data fields are required. Provide this rule type's parameters in the typed `data` object (its fields are fixed by the schema). At least one query is required in `queries` (objects `[{"id": "..."}]`) use the ♥ALLPRODUCTS♥ query to target every product. Mergado applies the rule automatically on the next rebuild — do not force recalculation. After creating, read the rule back with `get_rule` and verify its effect on a sample once the rebuild runs. Use when the user wants to remove whole products from the output feed.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • project_id string requiredpovinnépovinnékötelező
    ID of the project the rule is created in. Obtain it from `list_shop_projects`.
  • queries array requiredpovinnépovinnékötelező
    Queries selecting which products the rule applies to, as a list of objects `[{"id": "<query_id>"}]` (NOT strings). At least one query is required for this rule type. To target every product, pass the system ♥ALLPRODUCTS♥ query whose ID is each project's `all_products_query_id` in `list_shop_projects`.
  • applies boolean optionalvolitelnévoliteľnéválasztható
    Whether the rule is active (vs. paused).
  • data object optionalvolitelnévoliteľnéválasztható
    Rule-type-specific configuration payload. Its fields are fixed by this rule type's schema (see the nested object's properties) the backend validates them authoritatively. Example: `{}`
  • element_path string optionalvolitelnévoliteľnéválasztható
    Target element path must already exist in the project.
  • is_deletable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_editable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_movable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_pausable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • name string optionalvolitelnévoliteľnéválasztható
    Human-readable rule name (max 100 chars).
  • placement object optionalvolitelnévoliteľnéválasztható
    Relative placement using `before`/`after` rule IDs takes precedence over `priority`.
  • priority string optionalvolitelnévoliteľnéválasztható
    Numeric string controlling rule order (lower priority runs earlier). Required in practice: omitting it returns 400 "Failed to determine rule priority". Pass e.g. "100" to append at the end; use `list_project_rules` to see existing priorities.
create_params_remove_by_value_rule Writes dataZapisuje dataZapisuje dátaAdatot ír
Create a 'Params Remove By Value' rule in a project. Hide specific parameter values (or entire parameters) from the output. Each row specifies a parameter name and the list of values to remove. An empty `values` list removes all values for that parameter. Provide this rule type's parameters in the typed `data` object (its fields are fixed by the schema). At least one query is required in `queries` (objects `[{"id": "..."}]`) use the ♥ALLPRODUCTS♥ query to target every product. Mergado applies the rule automatically on the next rebuild — do not force recalculation. After creating, read the rule back with `get_rule` and verify its effect on a sample once the rebuild runs. Use when the user wants specific parameter values removed from a PARAM-style structure.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • data object requiredpovinnépovinnékötelező
    Rule-type-specific configuration payload. Its fields are fixed by this rule type's schema (see the nested object's properties) the backend validates them authoritatively. Example: `{"ep_param":"PARAM","ep_param_name":"PARAM_NAME","ep_param_value":"VAL","rows":[{"param_name":"Color","values":["Red"]}]}`
  • project_id string requiredpovinnépovinnékötelező
    ID of the project the rule is created in. Obtain it from `list_shop_projects`.
  • queries array requiredpovinnépovinnékötelező
    Queries selecting which products the rule applies to, as a list of objects `[{"id": "<query_id>"}]` (NOT strings). At least one query is required for this rule type. To target every product, pass the system ♥ALLPRODUCTS♥ query whose ID is each project's `all_products_query_id` in `list_shop_projects`.
  • applies boolean optionalvolitelnévoliteľnéválasztható
    Whether the rule is active (vs. paused).
  • element_path string optionalvolitelnévoliteľnéválasztható
    Target element path must already exist in the project.
  • is_deletable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_editable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_movable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_pausable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • name string optionalvolitelnévoliteľnéválasztható
    Human-readable rule name (max 100 chars).
  • placement object optionalvolitelnévoliteľnéválasztható
    Relative placement using `before`/`after` rule IDs takes precedence over `priority`.
  • priority string optionalvolitelnévoliteľnéválasztható
    Numeric string controlling rule order (lower priority runs earlier). Required in practice: omitting it returns 400 "Failed to determine rule priority". Pass e.g. "100" to append at the end; use `list_project_rules` to see existing priorities.
create_product_grouping_rule Writes dataZapisuje dataZapisuje dátaAdatot ír
Create a 'Product Grouping' rule in a project. Group variant products together into a single product with multiple variants. Specify which elements identify products and groups, and define per-element MERGE or EXTRACT actions. Provide this rule type's parameters in the typed `data` object (its fields are fixed by the schema). This rule type does not require any queries. Mergado applies the rule automatically on the next rebuild — do not force recalculation. After creating, read the rule back with `get_rule` and verify its effect on a sample once the rebuild runs. Use when the user wants product variants merged (a whole-feed rule).
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • data object requiredpovinnépovinnékötelező
    Rule-type-specific configuration payload. Its fields are fixed by this rule type's schema (see the nested object's properties) the backend validates them authoritatively. Example: `{"product_key_element_path":"g:id","group_key_element_path":"g:item_group_id"}`
  • project_id string requiredpovinnépovinnékötelező
    ID of the project the rule is created in. Obtain it from `list_shop_projects`.
  • applies boolean optionalvolitelnévoliteľnéválasztható
    Whether the rule is active (vs. paused).
  • element_path string optionalvolitelnévoliteľnéválasztható
    Target element path must already exist in the project.
  • is_deletable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_editable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_movable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_pausable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • name string optionalvolitelnévoliteľnéválasztható
    Human-readable rule name (max 100 chars).
  • placement object optionalvolitelnévoliteľnéválasztható
    Relative placement using `before`/`after` rule IDs takes precedence over `priority`.
  • priority string optionalvolitelnévoliteľnéválasztható
    Numeric string controlling rule order (lower priority runs earlier). Required in practice: omitting it returns 400 "Failed to determine rule priority". Pass e.g. "100" to append at the end; use `list_project_rules` to see existing priorities.
  • queries array optionalvolitelnévoliteľnéválasztható
    Queries selecting which products the rule applies to, as a list of objects `[{"id": "<query_id>"}]` (NOT strings). At least one query is required for this rule type. To target every product, pass the system ♥ALLPRODUCTS♥ query whose ID is each project's `all_products_query_id` in `list_shop_projects`.
create_project Writes dataZapisuje dataZapisuje dátaAdatot ír
Creates a new project (input and output feed) in a specific shop. This creates a billable resource, counts toward tariff limits, and may automatically upgrade the user's tariff. Use this tool only after confirming that the user wants to create the project, and after confirming the shop, intended input URL, and output format.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • input_format string requiredpovinnépovinnékötelező
    Format identifier of the source feed (e.g. "heureka.cz", "zbozi.cz", "google"). Native or custom. Call `list_supported_feed_formats` for the valid IDs and pick the one matching the feed at `url` - a Google Sheets link is "googlesheets.global", which reads the ordinary /edit link as it stands. Where the feed is not a recognisable channel feed, ask the user which format it follows rather than guessing: the wrong format imports nothing.
  • name string requiredpovinnépovinnékötelező
    Project name. Max 100 characters, must be unique within the shop. Shown in the Mergado UI and helps identify the project purpose (e.g. "Google Shopping Feed", "Heureka Export").
  • output_format string requiredpovinnépovinnékötelező
    Format the transformed feed is exported in (e.g. "heureka.cz", "billiger.de", "google"). Native or custom, discover valid IDs via `list_supported_feed_formats`. Ask the user which advertising channel this project is for if they have not said - it decides the shape of everything the project produces.
  • pairing_elements string requiredpovinnépovinnékötelező
    Element that identifies a product across synchronisations, e.g. "ITEM_ID", "EAN" or "URL". Mergado matches every re-import on it, so a project created without one imports no products at all. Name an element that actually exists in the source feed: read the feed to find its identifier column, and if there is no obvious one - or more than one candidate - ask the user which to pair on rather than guessing. Several elements are given separated by a comma.
  • shop_id string requiredpovinnépovinnékötelező
    ID of the shop (eshop) where this project will be created. Must be an existing shop ID from your account, get it from `list_user_eshops`.
  • url string requiredpovinnépovinnékötelező
    Source feed URL. Must use an http, https, or sftp scheme. This feed is fetched and transformed by Mergado (e.g. "https://example.com/products.xml"). Mergado also downloads it during creation, so it has to be reachable.
  • autohide_new_products boolean optionalvolitelnévoliteľnéválasztható
    Optional. When true, products newly appearing after a synchronisation are automatically hidden until reviewed. Defaults to false.
create_project_query Writes dataZapisuje dataZapisuje dátaAdatot ír
Creates a standalone, reusable query in a project (a saved MQL product selection) that can be attached to one or more rules with `assign_query_to_rule`. Even a query used by a single rule is created here first, then attached via `assign_query_to_rule`. Use to define which products a rule should target, or to verify a hypothesis about the data (check the match via `list_project_products` with the same `mql`).
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • name string requiredpovinnépovinnékötelező
    Descriptive name for the query (e.g. "Products under $10", "Items without images"). Helps identify query purpose.
  • project_id string requiredpovinnépovinnékötelező
    ID of the project where this query will be created
  • query string requiredpovinnépovinnékötelező
    Query expression using MQL (Mergado Query Language). Can filter, aggregate, or transform data (e.g. "PRICE < 10", "CATEGORY = Electronics").
  • read_only boolean optionalvolitelnévoliteľnéválasztható
    Whether this query is read-only (cannot be modified)
  • search_output boolean optionalvolitelnévoliteľnéválasztható
    True to query output data (after rules), False to query input data
create_remove_diacritics_rule Writes dataZapisuje dataZapisuje dátaAdatot ír
Create a 'Remove Diacritics' rule in a project. Remove diacritical marks (accents) from the content of the targeted element. Useful for generating URL-safe or ASCII-only values (e.g. image URLs). No additional configuration is required. Provide this rule type's parameters in the typed `data` object (its fields are fixed by the schema). At least one query is required in `queries` (objects `[{"id": "..."}]`) use the ♥ALLPRODUCTS♥ query to target every product. Mergado applies the rule automatically on the next rebuild — do not force recalculation. After creating, read the rule back with `get_rule` and verify its effect on a sample once the rebuild runs. Use when the user wants accents/diacritics removed from a value.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • project_id string requiredpovinnépovinnékötelező
    ID of the project the rule is created in. Obtain it from `list_shop_projects`.
  • queries array requiredpovinnépovinnékötelező
    Queries selecting which products the rule applies to, as a list of objects `[{"id": "<query_id>"}]` (NOT strings). At least one query is required for this rule type. To target every product, pass the system ♥ALLPRODUCTS♥ query whose ID is each project's `all_products_query_id` in `list_shop_projects`.
  • applies boolean optionalvolitelnévoliteľnéválasztható
    Whether the rule is active (vs. paused).
  • data object optionalvolitelnévoliteľnéválasztható
    Rule-type-specific configuration payload. Its fields are fixed by this rule type's schema (see the nested object's properties) the backend validates them authoritatively. Example: `{}`
  • element_path string optionalvolitelnévoliteľnéválasztható
    Target element path must already exist in the project.
  • is_deletable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_editable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_movable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_pausable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • name string optionalvolitelnévoliteľnéválasztható
    Human-readable rule name (max 100 chars).
  • placement object optionalvolitelnévoliteľnéválasztható
    Relative placement using `before`/`after` rule IDs takes precedence over `priority`.
  • priority string optionalvolitelnévoliteľnéválasztható
    Numeric string controlling rule order (lower priority runs earlier). Required in practice: omitting it returns 400 "Failed to determine rule priority". Pass e.g. "100" to append at the end; use `list_project_rules` to see existing priorities.
create_replacing_rule Writes dataZapisuje dataZapisuje dátaAdatot ír
Create a 'Replacing' rule in a project. Find and replace content within element values. Supports plain text and regular expressions. Multiple search/replacement pairs can be specified in `rows`. Provide this rule type's parameters in the typed `data` object (its fields are fixed by the schema). At least one query is required in `queries` (objects `[{"id": "..."}]`) use the ♥ALLPRODUCTS♥ query to target every product. Mergado applies the rule automatically on the next rebuild — do not force recalculation. After creating, read the rule back with `get_rule` and verify its effect on a sample once the rebuild runs. Use when the user wants find-and-replace inside values (plain text or regex with `\1` group references).
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • data object requiredpovinnépovinnékötelező
    Rule-type-specific configuration payload. Its fields are fixed by this rule type's schema (see the nested object's properties) the backend validates them authoritatively. Example: `{"regex":false,"case_sensitive":false,"rows":[{"search":"old","replacement":"new","position":0}]}`
  • project_id string requiredpovinnépovinnékötelező
    ID of the project the rule is created in. Obtain it from `list_shop_projects`.
  • queries array requiredpovinnépovinnékötelező
    Queries selecting which products the rule applies to, as a list of objects `[{"id": "<query_id>"}]` (NOT strings). At least one query is required for this rule type. To target every product, pass the system ♥ALLPRODUCTS♥ query whose ID is each project's `all_products_query_id` in `list_shop_projects`.
  • applies boolean optionalvolitelnévoliteľnéválasztható
    Whether the rule is active (vs. paused).
  • element_path string optionalvolitelnévoliteľnéválasztható
    Target element path must already exist in the project.
  • is_deletable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_editable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_movable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_pausable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • name string optionalvolitelnévoliteľnéválasztható
    Human-readable rule name (max 100 chars).
  • placement object optionalvolitelnévoliteľnéválasztható
    Relative placement using `before`/`after` rule IDs takes precedence over `priority`.
  • priority string optionalvolitelnévoliteľnéválasztható
    Numeric string controlling rule order (lower priority runs earlier). Required in practice: omitting it returns 400 "Failed to determine rule priority". Pass e.g. "100" to append at the end; use `list_project_rules` to see existing priorities.
create_rewriting_rule Writes dataZapisuje dataZapisuje dátaAdatot ír
Create a 'Rewriting' rule in a project. Replace the content of one or more product elements with a new value. Mergado variable expressions (e.g. `%ITEM_ID%`) are supported in `new_content`. Provide this rule type's parameters in the typed `data` object (its fields are fixed by the schema). At least one query is required in `queries` (objects `[{"id": "..."}]`) use the ♥ALLPRODUCTS♥ query to target every product. Mergado applies the rule automatically on the next rebuild — do not force recalculation. After creating, read the rule back with `get_rule` and verify its effect on a sample once the rebuild runs. Use when the user wants to overwrite an element's content (supports `%element%` references).
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • data object requiredpovinnépovinnékötelező
    Rule-type-specific configuration payload. Its fields are fixed by this rule type's schema (see the nested object's properties) the backend validates them authoritatively. Example: `{"rows":[{"element_path":"g:title","new_content":"%MANUFACTURER% %g:title%"}]}`
  • project_id string requiredpovinnépovinnékötelező
    ID of the project the rule is created in. Obtain it from `list_shop_projects`.
  • queries array requiredpovinnépovinnékötelező
    Queries selecting which products the rule applies to, as a list of objects `[{"id": "<query_id>"}]` (NOT strings). At least one query is required for this rule type. To target every product, pass the system ♥ALLPRODUCTS♥ query whose ID is each project's `all_products_query_id` in `list_shop_projects`.
  • applies boolean optionalvolitelnévoliteľnéválasztható
    Whether the rule is active (vs. paused).
  • element_path string optionalvolitelnévoliteľnéválasztható
    Target element path must already exist in the project.
  • is_deletable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_editable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_movable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_pausable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • name string optionalvolitelnévoliteľnéválasztható
    Human-readable rule name (max 100 chars).
  • placement object optionalvolitelnévoliteľnéválasztható
    Relative placement using `before`/`after` rule IDs takes precedence over `priority`.
  • priority string optionalvolitelnévoliteľnéválasztható
    Numeric string controlling rule order (lower priority runs earlier). Required in practice: omitting it returns 400 "Failed to determine rule priority". Pass e.g. "100" to append at the end; use `list_project_rules` to see existing priorities.
create_rounding_rule Writes dataZapisuje dataZapisuje dátaAdatot ír
Create a 'Rounding' rule in a project. Round a numeric element value to a fixed number of decimal places. The separators control how the formatted output looks. Provide this rule type's parameters in the typed `data` object (its fields are fixed by the schema). At least one query is required in `queries` (objects `[{"id": "..."}]`) use the ♥ALLPRODUCTS♥ query to target every product. Mergado applies the rule automatically on the next rebuild — do not force recalculation. After creating, read the rule back with `get_rule` and verify its effect on a sample once the rebuild runs. Use when the user wants prices rounded. NOTE: this endpoint currently returns HTTP 500.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • data object requiredpovinnépovinnékötelező
    Rule-type-specific configuration payload. Its fields are fixed by this rule type's schema (see the nested object's properties) the backend validates them authoritatively. Example: `{"rounding_type":"mathematical","decimal_places":0}`
  • project_id string requiredpovinnépovinnékötelező
    ID of the project the rule is created in. Obtain it from `list_shop_projects`.
  • queries array requiredpovinnépovinnékötelező
    Queries selecting which products the rule applies to, as a list of objects `[{"id": "<query_id>"}]` (NOT strings). At least one query is required for this rule type. To target every product, pass the system ♥ALLPRODUCTS♥ query whose ID is each project's `all_products_query_id` in `list_shop_projects`.
  • applies boolean optionalvolitelnévoliteľnéválasztható
    Whether the rule is active (vs. paused).
  • element_path string optionalvolitelnévoliteľnéválasztható
    Target element path must already exist in the project.
  • is_deletable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_editable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_movable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_pausable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • name string optionalvolitelnévoliteľnéválasztható
    Human-readable rule name (max 100 chars).
  • placement object optionalvolitelnévoliteľnéválasztható
    Relative placement using `before`/`after` rule IDs takes precedence over `priority`.
  • priority string optionalvolitelnévoliteľnéválasztható
    Numeric string controlling rule order (lower priority runs earlier). Required in practice: omitting it returns 400 "Failed to determine rule priority". Pass e.g. "100" to append at the end; use `list_project_rules` to see existing priorities.
create_shop Writes dataZapisuje dataZapisuje dátaAdatot ír
Creates a new eshop (the top-level container that owns projects/feeds) for the current account. Only a `name` is required, Mergado trims it and converts it to title case. Use this during onboarding before creating any project, the returned `id` is the `shop_id` you pass to `create_project`. To configure the eshop's website or XML domain afterwards, use `update_shop`.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • name string requiredpovinnépovinnékötelező
    E-shop name. Max 100 characters. The value is trimmed and converted to title case by Mergado (e.g. "example.com").
create_tagstripping_rule Writes dataZapisuje dataZapisuje dátaAdatot ír
Create a 'Tag Stripping' rule in a project. Remove all HTML tags from the content of the targeted element. No additional configuration is required. Provide this rule type's parameters in the typed `data` object (its fields are fixed by the schema). At least one query is required in `queries` (objects `[{"id": "..."}]`) use the ♥ALLPRODUCTS♥ query to target every product. Mergado applies the rule automatically on the next rebuild — do not force recalculation. After creating, read the rule back with `get_rule` and verify its effect on a sample once the rebuild runs. Use when the user wants HTML tags stripped from a value.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • project_id string requiredpovinnépovinnékötelező
    ID of the project the rule is created in. Obtain it from `list_shop_projects`.
  • queries array requiredpovinnépovinnékötelező
    Queries selecting which products the rule applies to, as a list of objects `[{"id": "<query_id>"}]` (NOT strings). At least one query is required for this rule type. To target every product, pass the system ♥ALLPRODUCTS♥ query whose ID is each project's `all_products_query_id` in `list_shop_projects`.
  • applies boolean optionalvolitelnévoliteľnéválasztható
    Whether the rule is active (vs. paused).
  • data object optionalvolitelnévoliteľnéválasztható
    Rule-type-specific configuration payload. Its fields are fixed by this rule type's schema (see the nested object's properties) the backend validates them authoritatively. Example: `{}`
  • element_path string optionalvolitelnévoliteľnéválasztható
    Target element path must already exist in the project.
  • is_deletable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_editable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_movable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_pausable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • name string optionalvolitelnévoliteľnéválasztható
    Human-readable rule name (max 100 chars).
  • placement object optionalvolitelnévoliteľnéválasztható
    Relative placement using `before`/`after` rule IDs takes precedence over `priority`.
  • priority string optionalvolitelnévoliteľnéválasztható
    Numeric string controlling rule order (lower priority runs earlier). Required in practice: omitting it returns 400 "Failed to determine rule priority". Pass e.g. "100" to append at the end; use `list_project_rules` to see existing priorities.
create_truncating_rule Writes dataZapisuje dataZapisuje dátaAdatot ír
Create a 'Truncating' rule in a project. Shorten the content of an element to a specified maximum length. The intelligent flag attempts to truncate at a word boundary. The *append* string (e.g. `...`) is appended after the truncated text. Provide this rule type's parameters in the typed `data` object (its fields are fixed by the schema). At least one query is required in `queries` (objects `[{"id": "..."}]`) use the ♥ALLPRODUCTS♥ query to target every product. Mergado applies the rule automatically on the next rebuild — do not force recalculation. After creating, read the rule back with `get_rule` and verify its effect on a sample once the rebuild runs. Use when the user wants values shortened to a length limit.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • data object requiredpovinnépovinnékötelező
    Rule-type-specific configuration payload. Its fields are fixed by this rule type's schema (see the nested object's properties) the backend validates them authoritatively. Example: `{"max_length":150,"intelligent":true,"append":"…"}`
  • project_id string requiredpovinnépovinnékötelező
    ID of the project the rule is created in. Obtain it from `list_shop_projects`.
  • queries array requiredpovinnépovinnékötelező
    Queries selecting which products the rule applies to, as a list of objects `[{"id": "<query_id>"}]` (NOT strings). At least one query is required for this rule type. To target every product, pass the system ♥ALLPRODUCTS♥ query whose ID is each project's `all_products_query_id` in `list_shop_projects`.
  • applies boolean optionalvolitelnévoliteľnéválasztható
    Whether the rule is active (vs. paused).
  • element_path string optionalvolitelnévoliteľnéválasztható
    Target element path must already exist in the project.
  • is_deletable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_editable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_movable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_pausable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • name string optionalvolitelnévoliteľnéválasztható
    Human-readable rule name (max 100 chars).
  • placement object optionalvolitelnévoliteľnéválasztható
    Relative placement using `before`/`after` rule IDs takes precedence over `priority`.
  • priority string optionalvolitelnévoliteľnéválasztható
    Numeric string controlling rule order (lower priority runs earlier). Required in practice: omitting it returns 400 "Failed to determine rule priority". Pass e.g. "100" to append at the end; use `list_project_rules` to see existing priorities.
create_utm_rule Writes dataZapisuje dataZapisuje dátaAdatot ír
Create a 'UTM Parameters' rule in a project. Append UTM tracking parameters to product URLs. Mergado variable expressions (e.g. `%ITEM_ID%`) are supported in all text fields. Provide this rule type's parameters in the typed `data` object (its fields are fixed by the schema). At least one query is required in `queries` (objects `[{"id": "..."}]`) use the ♥ALLPRODUCTS♥ query to target every product. Mergado applies the rule automatically on the next rebuild — do not force recalculation. After creating, read the rule back with `get_rule` and verify its effect on a sample once the rebuild runs. Use when the user wants UTM tracking parameters appended to product URLs.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • project_id string requiredpovinnépovinnékötelező
    ID of the project the rule is created in. Obtain it from `list_shop_projects`.
  • queries array requiredpovinnépovinnékötelező
    Queries selecting which products the rule applies to, as a list of objects `[{"id": "<query_id>"}]` (NOT strings). At least one query is required for this rule type. To target every product, pass the system ♥ALLPRODUCTS♥ query whose ID is each project's `all_products_query_id` in `list_shop_projects`.
  • applies boolean optionalvolitelnévoliteľnéválasztható
    Whether the rule is active (vs. paused).
  • data object optionalvolitelnévoliteľnéválasztható
    Rule-type-specific configuration payload. Its fields are fixed by this rule type's schema (see the nested object's properties) the backend validates them authoritatively. Example: `{"utm_source":"mergado","utm_medium":"cpc","utm_campaign":"summer_2026"}`
  • element_path string optionalvolitelnévoliteľnéválasztható
    Target element path must already exist in the project.
  • is_deletable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_editable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_movable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • is_pausable boolean optionalvolitelnévoliteľnéválasztható
    System flag controlling how the rule behaves in the Mergado editor. Leave unset — intended for system-generated rules only.
  • name string optionalvolitelnévoliteľnéválasztható
    Human-readable rule name (max 100 chars).
  • placement object optionalvolitelnévoliteľnéválasztható
    Relative placement using `before`/`after` rule IDs takes precedence over `priority`.
  • priority string optionalvolitelnévoliteľnéválasztható
    Numeric string controlling rule order (lower priority runs earlier). Required in practice: omitting it returns 400 "Failed to determine rule priority". Pass e.g. "100" to append at the end; use `list_project_rules` to see existing priorities.
create_variable Writes dataZapisuje dataZapisuje dátaAdatot ír
Creates a variable in a project. Use this tool for: (a) named constants used by multiple rules (`shipping_cost`, `vat_rate`), (b) regex extraction (define the regex once, reference it in rules), or (c) computed values. Variables are referenced in rules as `{name}`.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • element_path string requiredpovinnépovinnékötelező
    Element path from which the variable value is extracted (e.g. "ITEM | PRICE", "PARAM { NAME = 'color' } | VALUE")
  • name string requiredpovinnépovinnékötelező
    Variable name/identifier. Use clear, descriptive names (e.g. "shipping_cost", "vat_rate"). This will be referenced in rules and queries.
  • project_id string requiredpovinnépovinnékötelező
    ID of the project where this variable will be created and available for use
  • fragment_number integer optionalvolitelnévoliteľnéválasztható
    Optional regex group/fragment number to extract (used with regular_expression)
  • regular_expression string optionalvolitelnévoliteľnéválasztható
    Optional regex pattern to extract part of the element value
  • sample_text string optionalvolitelnévoliteľnéválasztható
    Optional sample text for UI/testing purposes
delete_element Writes dataZapisuje dataZapisuje dátaAdatot ír
Deletes an element and all of its child elements. This action is destructive and irreversible. Any rules referencing this element or its children will break. Use this tool only after getting the user's explicit confirmation. When asking for confirmation, list any affected child elements, especially when deleting parent elements such as `PARAM` or `g:shipping`.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    Element ID to delete. Get from `list_project_elements`. Deletes all child elements too.
delete_query Writes dataZapisuje dataZapisuje dátaAdatot ír
Deletes a query. This action is destructive and irreversible. If the query is attached to a rule, that rule will be left with one less scope query (or fail if it was the only one). You cannot delete system queries (`read_only=true`). Use this tool only after confirming which rules use the query.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    Query ID to delete. Get from `list_project_queries` or `list_rule_queries`. System queries (`read_only=true`) cannot be deleted.
delete_rule Writes dataZapisuje dataZapisuje dátaAdatot ír
Deletes a rule and all of its rule-level queries (project-level queries persist). Products previously affected by this rule revert to their pre-rule values on the next rebuild. Get the user's explicit confirmation first, especially for high-priority rules (applied first) or `format_converter` rules (essential for output). Rules with `is_deletable=false` cannot be deleted. Use to remove a rule after user confirmation, or to replace one (there is no `update_rule` — delete + recreate).
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    Rule ID to delete. Get from `list_project_rules`. Rules with `is_deletable=false` (system rules) cannot be deleted.
delete_variable Writes dataZapisuje dataZapisuje dátaAdatot ír
Deletes a variable. This action is destructive and irreversible. Rules referencing this variable will no longer be able to resolve it on the next rebuild. Use this tool only after confirming which rules contain `{var_name}` references.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    Variable ID to delete. Get from `list_project_variables`.
get_access_log Read-onlyPouze čteníIba čítanieCsak olvasás
Returns details of a single access record. The tool returns HTTP 410 if the related project has been deleted (the log is preserved but the linked resource is gone). Use this tool rarely; `get_access_logs` is typically sufficient.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    ID of the access log to fetch. Get it from `get_access_logs`.
get_access_logs Read-onlyPouze čteníIba čítanieCsak olvasás
Returns the history of HTTP access to the project's output feed URL, including which advertising channels (such as GMC or Heureka) fetched the feed, when they fetched it, and the response status. Use this tool to verify that ad channels are consuming the feed regularly.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • project_id string requiredpovinnépovinnékötelező
    ID of the project whose access logs to retrieve
  • limit integer optionalvolitelnévoliteľnéválasztható
    Pagination: maximum number of items to return in one response (Mergado default is 10). Combine with `offset` to page through large result sets.
  • offset integer optionalvolitelnévoliteľnéválasztható
    Pagination: number of items to skip from the start of the result set (default 0). For the next page set offset to the previous offset plus limit the response's `total_results` tells you when to stop.
get_app_by_name Read-onlyPouze čteníIba čítanieCsak olvasás
Returns metadata for a specific app from the global catalog by its slug name (e.g., `biddingfoxelements`, `feedimageeditor`, `mergadoaudit`). Use this tool to look up an app's description, latest release date, or capabilities.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • name string requiredpovinnépovinnékötelező
    Name (ID) of the application
get_apply_log Read-onlyPouze čteníIba čítanieCsak olvasás
Returns details of a single apply run. Use this tool after `get_apply_logs` to inspect granular per-rule diagnostics for a specific run.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    ID of the apply log to fetch. Get it from `get_apply_logs`.
get_apply_logs Read-onlyPouze čteníIba čítanieCsak olvasás
Returns the history of rule-application runs for a project. Each entry includes a timestamp, duration, item count, and per-rule processed counts. An apply run transforms data internally but does not publish changes to the output feed. Publishing happens during a rebuild. Use this tool to find out when rules were last applied or to diagnose unexpected rule behavior.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • project_id string requiredpovinnépovinnékötelező
    ID of the project whose apply logs to retrieve
  • limit integer optionalvolitelnévoliteľnéválasztható
    Pagination: maximum number of items to return in one response (Mergado default is 10). Combine with `offset` to page through large result sets.
  • offset integer optionalvolitelnévoliteľnéválasztható
    Pagination: number of items to skip from the start of the result set (default 0). For the next page set offset to the previous offset plus limit the response's `total_results` tells you when to stop.
get_current_user Read-onlyPouze čteníIba čítanieCsak olvasás
Returns the user account that the current OAuth token belongs to. Use as the first call in any user-scoped workflow to confirm identity. Requires a user-bound (ONLINE) token (an OAuth token tied to a specific Mergado user, not a server-to-server token). If you encounter a schema validation error, a 401 error, or a 'token scope not valid' error, ask the user to (re)authorize Mergado MCP.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek

This tool takes no input parameters.Tento nástroj nemá žádné vstupní parametry.Tento nástroj nemá žiadne vstupné parametre.Ennek az eszköznek nincsenek bemeneti paraméterei.

get_element Read-onlyPouze čteníIba čítanieCsak olvasás
Returns details of a single element (path, type, `is_attribute`, origin, and hidden flag). Use this tool to verify an element's properties before updating or deleting it. Get the element ID from `list_project_elements`.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    Element ID to fetch. Get from `list_project_elements`.
get_export_log Read-onlyPouze čteníIba čítanieCsak olvasás
Returns details of a single export run. Use this tool after `get_export_logs` to inspect a specific export.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    ID of the export log to fetch. Get it from `get_export_logs`.
get_export_logs Read-onlyPouze čteníIba čítanieCsak olvasás
Returns the history of output-feed exports for a project. Each export publishes the current project data to the output feed. Each entry includes a timestamp, items exported, `exported_product_group_count`, and duration. Use this tool to confirm the last successful publish and to diagnose stale outputs.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • project_id string requiredpovinnépovinnékötelező
    ID of the project whose export logs to retrieve
  • limit integer optionalvolitelnévoliteľnéválasztható
    Pagination: maximum number of items to return in one response (Mergado default is 10). Combine with `offset` to page through large result sets.
  • offset integer optionalvolitelnévoliteľnéválasztható
    Pagination: number of items to skip from the start of the result set (default 0). For the next page set offset to the previous offset plus limit the response's `total_results` tells you when to stop.
get_feedaudit Read-onlyPouze čteníIba čítanieCsak olvasás
Returns a single feed audit: its status, progress, product count, timings, and any error. Use to poll a running audit to completion before listing its issues or products.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    ID of the feed audit. Get from `list_project_feedaudits`.
get_feedaudit_issue Read-onlyPouze čteníIba čítanieCsak olvasás
Returns a single audit issue by ID, including the validator, verdict, severity, and validator-specific context (`info`). Use to inspect one issue surfaced by `list_feedaudit_issues`.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    ID of the audit issue. Get from `list_feedaudit_issues`.
get_feedaudit_product Read-onlyPouze čteníIba čítanieCsak olvasás
Returns a single audited product with all its parsed elements (tag/value pairs). Use to inspect the exact feed content the audit saw for one product.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    ID of the audited product. Get from `list_feedaudit_products`.
get_format Read-onlyPouze čteníIba čítanieCsak olvasás
Returns basic metadata about a feed format (name, country, and source channels). For the full element specification, use `get_format_specification` instead.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • format_id string requiredpovinnépovinnékötelező
    Format ID (e.g. 'heureka.cz', 'zbozi.cz')
get_format_specification Read-onlyPouze čteníIba čítanieCsak olvasás
Returns the full element specification of a format (required and optional elements and their types). For basic metadata only, use `get_format` instead.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • format_id string requiredpovinnépovinnékötelező
    Format ID (e.g. 'heureka.cz', 'zbozi.cz')
get_import_log Read-onlyPouze čteníIba čítanieCsak olvasás
Returns details of a single import run, including the error message if it failed. Use this tool after `get_import_logs` to inspect the details of a specific failure (the error message usually contains the HTTP status, parse error line, or timeout reason).
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    ID of the import log to fetch. Get it from `get_import_logs`.
get_import_logs Read-onlyPouze čteníIba čítanieCsak olvasás
Returns the history of input-feed fetches for a project. Each entry includes items received versus processed, created/updated/removed, duration, and status. Use this tool to diagnose failed feed downloads or missing products by comparing items received with items processed.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • project_id string requiredpovinnépovinnékötelező
    ID of the project whose import logs to retrieve
  • limit integer optionalvolitelnévoliteľnéválasztható
    Pagination: maximum number of items to return in one response (Mergado default is 10). Combine with `offset` to page through large result sets.
  • offset integer optionalvolitelnévoliteľnéválasztható
    Pagination: number of items to skip from the start of the result set (default 0). For the next page set offset to the previous offset plus limit the response's `total_results` tells you when to stop.
get_notification Read-onlyPouze čteníIba čítanieCsak olvasás
Returns a single notification by ID. Use this tool after `get_user_notifications` to read the full body of a specific notification. Access restricted to user-bound (ONLINE) tokens; server tokens get 403.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    Notification ID to retrieve. Get it from `get_user_notifications`.
get_pairing Read-onlyPouze čteníIba čítanieCsak olvasás
Returns details of a single pairing record (input item identifier, matched output item ID, and the matching elements used). Use this tool after `list_pairings` to inspect a specific pairing.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    ID of the pairing to fetch. Get it from `list_pairings`.
get_product Read-onlyPouze čteníIba čítanieCsak olvasás
Returns a single product (input and output data) by its product ID. Use this tool to inspect one product in full detail. Get the product ID from `list_project_products` or `query_products`.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    Product ID to retrieve. Get it from `list_project_products` or `query_products`.
get_project Read-onlyPouze čteníIba čítanieCsak olvasás
Returns core project fields (URL, formats, status, and timestamps). Use this tool when you need a project's core configuration.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    Project ID to fetch. Get from `list_shop_projects`.
get_project_app Read-onlyPouze čteníIba čítanieCsak olvasás
Fetches subscription details (`free_until`, `paid_until`) for a project-level app. Use this tool after `list_project_apps` to inspect a specific subscription.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • app_name string requiredpovinnépovinnékötelező
    Name (ID) of the application
  • project_id string requiredpovinnépovinnékötelező
    ID of the project
get_query Read-onlyPouze čteníIba čítanieCsak olvasás
Returns details of a single query (MQL expression, matching product count, and `read_only` flag). Use this tool to inspect a query before reusing it or before `update_query`. To get the actual products matching the query, use `query_products` instead. Get the query ID from `list_project_queries` or `list_rule_queries`.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    Query ID to fetch. Get from `list_project_queries` or `list_rule_queries`.
get_rule Read-onlyPouze čteníIba čítanieCsak olvasás
Returns details of a single rule instance - type, priority, `applies` (active), queries (scope), and the rule-type-specific `data` field. Use before `delete_rule`, or to read the current state before changing a rule. There is no update tool to change a rule, `delete_rule` it and recreate it with the matching `create_<type>_rule` tool.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    Rule ID to fetch. Get from `list_project_rules`.
get_shop Read-onlyPouze čteníIba čítanieCsak olvasás
Returns core shop fields (name, owner, tariff). For shop statistics and keychain (ad channel auth) connections, use `get_shop_info` instead. Use this tool when you need basic shop information such as its identity or tariff before working with its projects.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    Shop ID to fetch. Get from `list_user_eshops`.
get_shop_app Read-onlyPouze čteníIba čítanieCsak olvasás
Fetches subscription details (free_until, paid_until) for a shop-level app. Use this tool after `list_shop_apps` to inspect a specific subscription.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • app_name string requiredpovinnépovinnékötelező
    Name (ID) of the application
  • shop_id string requiredpovinnépovinnékötelező
    ID of the shop
get_shop_event_logs Read-onlyPouze čteníIba čítanieCsak olvasás
Retrieves the audit log of significant events at the shop level. This includes tariff changes, project creation or deletion, user permission changes, and payment events. Use this tool to investigate who changed what and when at the shop level.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • shop_id string requiredpovinnépovinnékötelező
    ID of the shop whose event logs to retrieve
  • limit integer optionalvolitelnévoliteľnéválasztható
    Pagination: maximum number of items to return in one response (Mergado default is 10). Combine with `offset` to page through large result sets.
  • offset integer optionalvolitelnévoliteľnéválasztható
    Pagination: number of items to skip from the start of the result set (default 0). For the next page set offset to the previous offset plus limit the response's `total_results` tells you when to stop.
get_shop_info Read-onlyPouze čteníIba čítanieCsak olvasás
Returns enriched shop information, including shop statistics and Keychain (ad channel authentication) connections. Use this tool when you need shop statistics or information about ad channel integrations. For core shop fields (name, owner, tariff), use `get_shop` instead.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    Shop ID whose info to retrieve. Get it from `list_user_eshops`.
get_stats_audit Read-onlyPouze čteníIba čítanieCsak olvasás
Returns a single shop statistics audit: its date, status, product count, and a per-validator issue summary (ok/wrong/missing counts with item totals). The `id` is the composite `{m3shop_id}-{date_id}` (e.g. `1276-260625`) taken from `list_shop_stats_audits`. This is the stats-side audit, distinct from a project feed audit - use `get_feedaudit` for the latter. Use to read one stats audit found via `list_shop_stats_audits`.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    Composite statistics-audit ID of the form `{m3shop_id}-{date_id}` (e.g. `1276-260625`). Get it from `list_shop_stats_audits`.
get_tariff Read-onlyPouze čteníIba čítanieCsak olvasás
Returns details of a specific tariff (name, prices in all currencies, included limits). Use this tool after identifying `tariff_id` from `list_user_eshops` or `get_shop`.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    Tariff ID to fetch. Get it from `list_available_tariffs`.
get_user Read-onlyPouze čteníIba čítanieCsak olvasás
Returns details of a specific user by their ID. Use only for users that share an eshop with the current user (visible via `list_users`). For the current user's identity, prefer `get_current_user`.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    User ID to retrieve. Get it from `get_current_user` or `list_users`.
get_user_app Read-onlyPouze čteníIba čítanieCsak olvasás
Fetches a specific user-level app subscription (free_until, paid_until). Use this tool after `list_user_apps` to check expiration of a specific app.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • app_name string requiredpovinnépovinnékötelező
    Name (ID) of the application
  • user_id string requiredpovinnépovinnékötelező
    ID of the user
get_user_custom_formats Read-onlyPouze čteníIba čítanieCsak olvasás
Returns user-defined feed formats (e.g. `custom.cz.36562`). Custom formats are user-created alternatives to built-in formats (e.g. Google, Heureka, Zboží) and can be used as either input or output formats. Use this tool when a project's `input_format` or `output_format` starts with `custom.` and you need the format specification.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • format_id string requiredpovinnépovinnékötelező
    Custom format ID to retrieve (e.g. 'custom.cz.36562'). Get it from a project's `input_format` / `output_format` when it starts with `custom.*`.
  • id string requiredpovinnépovinnékötelező
    User ID who owns the custom formats. Get it from `get_current_user`.
get_user_eshop_permissions Read-onlyPouze čteníIba čítanieCsak olvasás
Returns the role (writer / admin / owner) a specific user has in a specific eshop. Use to check whether a user can perform an action on a shop before suggesting it. Returns 404 if no permission exists.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • shop_id string requiredpovinnépovinnékötelező
    ID of the shop
  • user_id string requiredpovinnépovinnékötelező
    ID of the user
get_user_notifications Read-onlyPouze čteníIba čítanieCsak olvasás
Returns all notifications for a user (system messages, billing reminders, and app updates). Use this tool when the user asks if they have any new notifications in their account.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • user_id string requiredpovinnépovinnékötelező
    ID of the user whose notifications to retrieve
  • limit integer optionalvolitelnévoliteľnéválasztható
    Pagination: maximum number of items to return in one response (Mergado default is 10). Combine with `offset` to page through large result sets.
  • offset integer optionalvolitelnévoliteľnéválasztható
    Pagination: number of items to skip from the start of the result set (default 0). For the next page set offset to the previous offset plus limit the response's `total_results` tells you when to stop.
get_user_permissions Read-onlyPouze čteníIba čítanieCsak olvasás
Lists eshop access roles (writer / admin / owner) of a user across all their shops. Use to answer 'what can this user do' or to verify access before suggesting an action on a specific shop.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    User ID whose permissions to retrieve. Get it from `get_current_user`.
get_user_project_permissions Read-onlyPouze čteníIba čítanieCsak olvasás
Returns the role a specific user has in a specific project. Project permissions usually inherit from the eshop permission. Use this tool only for projects with a permission override; otherwise, get_user_eshop_permissions is sufficient. Use it when an operation fails with a 403 error to check the user's role on the project.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • project_id string requiredpovinnépovinnékötelező
    ID of the project
  • user_id string requiredpovinnépovinnékötelező
    ID of the user
get_variable Read-onlyPouze čteníIba čítanieCsak olvasás
Returns details of a variable - name, type, element path, regex. Get the variable ID from `list_project_variables`. Use to read a variable's definition (element path, regex, fragment) before referencing it as `%NAME%` in a rule.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    Variable ID to fetch. Get from `list_project_variables`.
list_apps Read-onlyPouze čteníIba čítanieCsak olvasás
Lists the global catalog of all available Mergado apps (Audit, FIE, Translator, Bidding Fox, Pricing Fox, ...). This is the catalog of installable apps; to see apps currently enabled by a user, shop, or project, use `list_user_apps`, `list_shop_apps`, or `list_project_apps` respectively.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • limit integer optionalvolitelnévoliteľnéválasztható
    Pagination: maximum number of items to return in one response (Mergado default is 10). Combine with `offset` to page through large result sets.
  • offset integer optionalvolitelnévoliteľnéválasztható
    Pagination: number of items to skip from the start of the result set (default 0). For the next page set offset to the previous offset plus limit the response's `total_results` tells you when to stop.
list_available_tariffs Read-onlyPouze čteníIba čítanieCsak olvasás
Returns the catalog of all available Mergado tariffs (e.g. Basic, Standard, Advanced, Special 300–900) with prices in CZK, EUR, PLN, GBP, USD, and HUF. Tariffs are automatically assigned based on the number of products in the project. Use this tool when the user asks what a tariff costs or when explaining an automatic tariff upgrade.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • limit integer optionalvolitelnévoliteľnéválasztható
    Pagination: maximum number of items to return in one response (Mergado default is 10). Combine with `offset` to page through large result sets.
  • offset integer optionalvolitelnévoliteľnéválasztható
    Pagination: number of items to skip from the start of the result set (default 0). For the next page set offset to the previous offset plus limit the response's `total_results` tells you when to stop.
list_defined_rules Read-onlyPouze čteníIba čítanieCsak olvasás
Lists the available rule-type definitions and the data fields each type accepts. Each type is also exposed as its own dedicated `create_<type>_rule` tool. Use this tool to inspect the data shape a given rule type expects before creating a rule.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek

This tool takes no input parameters.Tento nástroj nemá žádné vstupní parametry.Tento nástroj nemá žiadne vstupné parametre.Ennek az eszköznek nincsenek bemeneti paraméterei.

list_feedaudit_issues Read-onlyPouze čteníIba čítanieCsak olvasás
Lists all issues (failed/recommended validations) found by a feed audit - each with the validator, verdict, severity level, and the related product. This is the main "what's wrong with my feed" answer use it after an audit's `status` is `done`.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    ID of the feed audit whose issues to list. Get from `list_project_feedaudits`.
  • fields array optionalvolitelnévoliteľnéválasztható
    Optional. Return only these keys per issue, e.g. `["id", "level", "verdict", "validator", "product_id"]`. Worth using on any real audit: every issue otherwise repeats the full `feed_types` list, which is 875 of the row's 1156 bytes, and an audit with ~600 issues comes to 1.4 MB - large enough for a client to time out reading it. Trimming to the five keys above took the same audit from 737 kB to 90 kB. Valid keys: id, audit_id, product_id, validator, verdict, level, checked_at, info, feed_types. Keys you leave out still appear in the result as null - that is this server filling in its response model, not the audit reporting an empty value. Read a trimmed row only for the keys you asked for.
  • limit integer optionalvolitelnévoliteľnéválasztható
    Pagination: maximum number of items to return in one response (Mergado default is 10). Combine with `offset` to page through large result sets.
  • offset integer optionalvolitelnévoliteľnéválasztható
    Pagination: number of items to skip from the start of the result set (default 0). For the next page set offset to the previous offset plus limit the response's `total_results` tells you when to stop.
list_feedaudit_product_issues Read-onlyPouze čteníIba čítanieCsak olvasás
Lists the issues found for a single audited product - the per-product slice of the audit's validations. Use to answer "what's wrong with this specific product" after `list_feedaudit_products`.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    ID of the audited product whose issues to list. Get from `list_feedaudit_products`.
  • limit integer optionalvolitelnévoliteľnéválasztható
    Pagination: maximum number of items to return in one response (Mergado default is 10). Combine with `offset` to page through large result sets.
  • offset integer optionalvolitelnévoliteľnéválasztható
    Pagination: number of items to skip from the start of the result set (default 0). For the next page set offset to the previous offset plus limit the response's `total_results` tells you when to stop.
list_feedaudit_products Read-onlyPouze čteníIba čítanieCsak olvasás
Lists the products captured by a feed audit, each with its parsed elements (tag/value pairs as they appeared in the feed at audit time). Use to see exactly what the audit read for each product.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    ID of the feed audit whose products to list. Get from `list_project_feedaudits`.
  • fields array optionalvolitelnévoliteľnéválasztható
    Optional. Return only these keys per product. Valid keys: id, audit_id, elements - though `elements` is always null upstream, so there is rarely anything to trim here.
  • limit integer optionalvolitelnévoliteľnéválasztható
    Pagination: maximum number of items to return in one response (Mergado default is 10). Combine with `offset` to page through large result sets.
  • offset integer optionalvolitelnévoliteľnéválasztható
    Pagination: number of items to skip from the start of the result set (default 0). For the next page set offset to the previous offset plus limit the response's `total_results` tells you when to stop.
list_pairings Read-onlyPouze čteníIba čítanieCsak olvasás
Returns product pairings for a project. A 'pairing' is Mergado's internal identification of which input feed item corresponds to which output feed item across feed reloads, so that user-applied changes (hide/show, manual values) persist when the input feed is re-imported. The matching key elements are defined in the project's `pairing_elements` (typically ITEM_ID, EAN, PRODUCTNAME_EXACT, IMAGE). Use to inspect or troubleshoot product identity tracking across imports. Supports `limit`/`offset` pagination (handled automatically).
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    Project ID whose pairings to list. Get it from `list_shop_projects`.
  • limit integer optionalvolitelnévoliteľnéválasztható
    Pagination: maximum number of items to return in one response (Mergado default is 10). Combine with `offset` to page through large result sets.
  • offset integer optionalvolitelnévoliteľnéválasztható
    Pagination: number of items to skip from the start of the result set (default 0). For the next page set offset to the previous offset plus limit the response's `total_results` tells you when to stop.
list_project_apps Read-onlyPouze čteníIba čítanieCsak olvasás
Lists Mergado apps enabled for a specific project. Project-level apps apply only to this project. Use this tool when diagnosing behavior that might come from an installed app on the project. For shop-level apps, use `list_shop_apps` instead.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    Project ID whose installed apps to list. Get it from `list_shop_projects`.
  • limit integer optionalvolitelnévoliteľnéválasztható
    Pagination: maximum number of items to return in one response (Mergado default is 10). Combine with `offset` to page through large result sets.
  • offset integer optionalvolitelnévoliteľnéválasztható
    Pagination: number of items to skip from the start of the result set (default 0). For the next page set offset to the previous offset plus limit the response's `total_results` tells you when to stop.
list_project_elements Read-onlyPouze čteníIba čítanieCsak olvasás
Lists all XML elements within a project as a hierarchical tree. Each element includes an `origin` (`input`, `from_rule`, or `manual`) and a `hidden` flag (meaning the element exists internally but not in the output XML). Use this tool to plan rule changes by checking whether a target element exists, or to discover what is available in the feed.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    Project ID whose elements to list. Get from `list_shop_projects`.
list_project_feedaudits Read-onlyPouze čteníIba čítanieCsak olvasás
Lists feed audits run for a project (newest first), each with its status, progress, product count, and the comparison-shopping formats it validated against. Use to find an audit's ID before drilling into its issues or audited products, or to check whether an audit you started has finished (`status` / `progress`).
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    Project ID whose feed audits to list. Get from `list_shop_projects`.
  • limit integer optionalvolitelnévoliteľnéválasztható
    Pagination: maximum number of items to return in one response (Mergado default is 10). Combine with `offset` to page through large result sets.
  • offset integer optionalvolitelnévoliteľnéválasztható
    Pagination: number of items to skip from the start of the result set (default 0). For the next page set offset to the previous offset plus limit the response's `total_results` tells you when to stop.
list_project_products Read-onlyPouze čteníIba čítanieCsak olvasás
Lists products in a project, with an optional MQL filter (e.g. `PRICE_VAT < 50`) sent in the request body via POST (so even long or hard-to-encode MQL works). Pass `values_to_extract` to return only specific elements per product. Note: MQL filtering works server-side, but ORDER BY / LIMIT are not supported server-side, so ranking ("10 most expensive") must be done by the caller. Supports `limit`/`offset` pagination (handled automatically, sent as query params). For products of an existing saved query, use `query_products` instead. Use to inspect real product data or count products matching an `mql` filter (read `total_results`); prefer `limit` — responses are large.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    Project ID whose products to list (named `id` here for legacy reasons; create/write tools call it `project_id`). Get it from `list_shop_projects`.
  • is_hidden boolean optionalvolitelnévoliteľnéválasztható
    Filter by visibility: true=only hidden, false=only visible, null/omitted=all products
  • limit integer optionalvolitelnévoliteľnéválasztható
    Pagination: maximum number of items to return in one response (Mergado default is 10). Combine with `offset` to page through large result sets.
  • mql string optionalvolitelnévoliteľnéválasztható
    Optional MQL query string to filter products (e.g. "PRICE > 100"). Can be used in GET or POST request body.
  • offset integer optionalvolitelnévoliteľnéválasztható
    Pagination: number of items to skip from the start of the result set (default 0). For the next page set offset to the previous offset plus limit the response's `total_results` tells you when to stop.
  • values_to_extract array optionalvolitelnévoliteľnéválasztható
    CURRENTLY NOT FUNCTIONAL: the server ignores this field and returns the full product tree (`extracted_values` comes back null). Do not rely on it — use `limit` to bound the response and filter fields client-side. (Kept for forward compatibility.)
list_project_queries Read-onlyPouze čteníIba čítanieCsak olvasás
Lists all standalone queries within a project (project-level and rule-level). Each query includes a `query` (MQL expression), `product_count`, and `read_only` flag. System queries like `♥ALLPRODUCTS♥` are included (their `read_only=true`). Use this tool before creating a query to check if an equivalent saved query already exists, or to find query IDs for rules.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    Project ID whose queries to list. Get from `list_shop_projects`.
  • limit integer optionalvolitelnévoliteľnéválasztható
    Pagination: maximum number of items to return in one response (Mergado default is 10). Combine with `offset` to page through large result sets.
  • offset integer optionalvolitelnévoliteľnéválasztható
    Pagination: number of items to skip from the start of the result set (default 0). For the next page set offset to the previous offset plus limit the response's `total_results` tells you when to stop.
list_project_rules Read-onlyPouze čteníIba čítanieCsak olvasás
Lists all rules in a project, ordered by application priority (lower priority = applied first). Each rule includes its `type` (rewriting, hiding, replacing, format_converter, app, ...), `applies` (active), and attached `queries` (which products it targets). Use this tool as the first step to inspect a project's rule chain.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    Project ID whose rules to list. Get from `list_shop_projects`.
  • limit integer optionalvolitelnévoliteľnéválasztható
    Pagination: maximum number of items to return in one response (Mergado default is 10). Combine with `offset` to page through large result sets.
  • offset integer optionalvolitelnévoliteľnéválasztható
    Pagination: number of items to skip from the start of the result set (default 0). For the next page set offset to the previous offset plus limit the response's `total_results` tells you when to stop.
list_project_variables Read-onlyPouze čteníIba čítanieCsak olvasás
Lists all variables defined in a project. Variables are named, reusable values referenced from rules and other variables (e.g., `{shipping_cost}` in rule expressions). Use before `create_variable` to avoid duplicates.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    Project ID whose variables to list. Get from `list_shop_projects`.
  • limit integer optionalvolitelnévoliteľnéválasztható
    Pagination: maximum number of items to return in one response (Mergado default is 10). Combine with `offset` to page through large result sets.
  • offset integer optionalvolitelnévoliteľnéválasztható
    Pagination: number of items to skip from the start of the result set (default 0). For the next page set offset to the previous offset plus limit the response's `total_results` tells you when to stop.
list_rule_queries Read-onlyPouze čteníIba čítanieCsak olvasás
Lists queries attached to a specific rule (= scope of that rule). The union of these queries defines the products affected by the rule. Use this tool before changing a rule's scope to see the current state.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    Rule ID whose queries to list. Get from `list_project_rules`.
  • limit integer optionalvolitelnévoliteľnéválasztható
    Pagination: maximum number of items to return in one response (Mergado default is 10). Combine with `offset` to page through large result sets.
  • offset integer optionalvolitelnévoliteľnéválasztható
    Pagination: number of items to skip from the start of the result set (default 0). For the next page set offset to the previous offset plus limit the response's `total_results` tells you when to stop.
list_shop_apps Read-onlyPouze čteníIba čítanieCsak olvasás
Lists Mergado apps enabled at the eshop level (shared across all projects in the shop). Use this tool to check which shop-level apps are available before suggesting features that depend on them. For project-level apps, use `list_project_apps` instead. For user-level apps, use `list_user_apps`.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    Shop ID whose installed apps to list. Get it from `list_user_eshops`.
  • limit integer optionalvolitelnévoliteľnéválasztható
    Pagination: maximum number of items to return in one response (Mergado default is 10). Combine with `offset` to page through large result sets.
  • offset integer optionalvolitelnévoliteľnéválasztható
    Pagination: number of items to skip from the start of the result set (default 0). For the next page set offset to the previous offset plus limit the response's `total_results` tells you when to stop.
list_shop_projects Read-onlyPouze čteníIba čítanieCsak olvasás
Returns all projects (input and output feeds) within a specific eshop. Each project includes an `input_format` and `output_format`. Use this tool to understand which feeds the eshop already has before suggesting or creating new projects.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    Shop ID whose projects to list. Get from `list_user_eshops`.
  • limit integer optionalvolitelnévoliteľnéválasztható
    Pagination: maximum number of items to return in one response (Mergado default is 10). Combine with `offset` to page through large result sets.
  • offset integer optionalvolitelnévoliteľnéválasztható
    Pagination: number of items to skip from the start of the result set (default 0). For the next page set offset to the previous offset plus limit the response's `total_results` tells you when to stop.
list_shop_stats_audits Read-onlyPouze čteníIba čítanieCsak olvasás
Lists a shop's statistics audits (newest first), each with its date, status, and timings. This is the stats-side audit, distinct from a project feed audit - use `list_project_feedaudits` for the latter. Requires the `shop.stats.read` scope. Use when the user asks about stats audits of a shop. Note: currently returns empty even when audits exist in the UI — tell the user to check the Mergado UI.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    ID of the shop whose statistics audits to list. Get from `list_user_eshops`.
  • limit integer optionalvolitelnévoliteľnéválasztható
    Pagination: maximum number of items to return in one response (Mergado default is 10). Combine with `offset` to page through large result sets.
  • offset integer optionalvolitelnévoliteľnéválasztható
    Pagination: number of items to skip from the start of the result set (default 0). For the next page set offset to the previous offset plus limit the response's `total_results` tells you when to stop.
list_stats_audit_issues Read-onlyPouze čteníIba čítanieCsak olvasás
Lists the individual issues of a shop statistics audit, each with its validator, verdict, and affected item. The `id` is the composite `{m3shop_id}-{date_id}` (e.g. `1276-260625`) from `list_shop_stats_audits`. Optionally narrow or sort the result with `filter_by` / `order_by`. Use after `get_stats_audit` to drill from the per-validator summary into concrete failing items.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    Composite statistics-audit ID of the form `{m3shop_id}-{date_id}` (e.g. `1276-260625`). Get it from `list_shop_stats_audits`.
  • limit integer optionalvolitelnévoliteľnéválasztható
    Pagination: maximum number of items to return in one response (Mergado default is 10). Combine with `offset` to page through large result sets.
  • offset integer optionalvolitelnévoliteľnéválasztható
    Pagination: number of items to skip from the start of the result set (default 0). For the next page set offset to the previous offset plus limit the response's `total_results` tells you when to stop.
list_supported_feed_formats Read-onlyPouze čteníIba čítanieCsak olvasás
Lists all built-in feed formats supported by Mergado (input and output). Each format includes its country, sourcing ad channels (`ga_sources`), and flags (`is_importable` and `is_exportable`). Use this tool during onboarding to discover what is possible (e.g., available Google Shopping country variants, Heureka SK versus CZ). Use one of the returned format IDs with `get_format` or `get_format_specification` for more details.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek

This tool takes no input parameters.Tento nástroj nemá žádné vstupní parametry.Tento nástroj nemá žiadne vstupné parametre.Ennek az eszköznek nincsenek bemeneti paraméterei.

list_unique_element_values Read-onlyPouze čteníIba čítanieCsak olvasás
Returns the unique values (with counts) of an element. Set `is_output` to distinguish input (pre-rules) vs output (post-rules) values. Works for both simple and complex element paths. Use as the first step of any data analysis — real values of an element across products (e.g. categories, availability values) without reading whole products.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • element_path string requiredpovinnépovinnékötelező
    XPath to the element (e.g. "SHOP/SHOPITEM/PRICE")
  • project_id string requiredpovinnépovinnékötelező
    Project ID from which to retrieve values
  • is_output boolean optionalvolitelnévoliteľnéválasztható
    True=output values (after rules), False=input values (before rules), null=output
  • limit integer optionalvolitelnévoliteľnéválasztható
    Pagination: maximum number of items to return in one response (Mergado default is 10). Combine with `offset` to page through large result sets.
  • offset integer optionalvolitelnévoliteľnéválasztható
    Pagination: number of items to skip from the start of the result set (default 0). For the next page set offset to the previous offset plus limit the response's `total_results` tells you when to stop.
list_user_apps Read-onlyPouze čteníIba čítanieCsak olvasás
Lists Mergado apps (e.g. Audit, FIE, Translator, Bidding Fox) enabled at the user level (not eshop/project level). Use to answer "what apps does this user have?" or "what am I paying for?" and before suggesting features that depend on a specific app.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    User ID whose installed apps to list. Get it from `get_current_user`.
  • limit integer optionalvolitelnévoliteľnéválasztható
    Pagination: maximum number of items to return in one response (Mergado default is 10). Combine with `offset` to page through large result sets.
  • offset integer optionalvolitelnévoliteľnéválasztható
    Pagination: number of items to skip from the start of the result set (default 0). For the next page set offset to the previous offset plus limit the response's `total_results` tells you when to stop.
list_user_eshops Read-onlyPouze čteníIba čítanieCsak olvasás
Returns all eshops a user has access to, with their roles. Use as the second call after `get_current_user` to map the user's scope. Each eshop has `tariff_id`, `exported_items` useful for tariff/billing questions. (There is no global "list all shops" endpoint, for the current user this listing is the equivalent.)
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    User ID whose shops to retrieve. Get it from `get_current_user`.
  • limit integer optionalvolitelnévoliteľnéválasztható
    Pagination: maximum number of items to return in one response (Mergado default is 10). Combine with `offset` to page through large result sets.
  • offset integer optionalvolitelnévoliteľnéválasztható
    Pagination: number of items to skip from the start of the result set (default 0). For the next page set offset to the previous offset plus limit the response's `total_results` tells you when to stop.
list_users Read-onlyPouze čteníIba čítanieCsak olvasás
Lists users that share at least one eshop with the authenticated user (= users you can collaborate with). Does NOT list all Mergado users globally — that would be a privacy leak. Use when resolving an e-mail or name mentioned by the user to a Mergado user ID.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • limit integer optionalvolitelnévoliteľnéválasztható
    Pagination: maximum number of items to return in one response (Mergado default is 10). Combine with `offset` to page through large result sets.
  • offset integer optionalvolitelnévoliteľnéválasztható
    Pagination: number of items to skip from the start of the result set (default 0). For the next page set offset to the previous offset plus limit the response's `total_results` tells you when to stop.
query_products Read-onlyPouze čteníIba čítanieCsak olvasás
Returns products matching a saved query. Use this tool after `create_project_query` to fetch the matching set. For ad-hoc filters, use `list_project_products` with the `mql` parameter directly. Pass `values_to_extract` to return only specific elements per product.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • query_id string requiredpovinnépovinnékötelező
    ID of the query to execute
  • is_hidden boolean optionalvolitelnévoliteľnéválasztható
    Filter by visibility: true=only hidden, false=only visible, null=all
  • limit integer optionalvolitelnévoliteľnéválasztható
    Pagination: maximum number of items to return in one response (Mergado default is 10). Combine with `offset` to page through large result sets.
  • offset integer optionalvolitelnévoliteľnéválasztható
    Pagination: number of items to skip from the start of the result set (default 0). For the next page set offset to the previous offset plus limit the response's `total_results` tells you when to stop.
  • values_to_extract array optionalvolitelnévoliteľnéválasztható
    CURRENTLY NOT FUNCTIONAL: the server ignores this field and returns the full product tree (`extracted_values` comes back null). Do not rely on it — use `limit` to bound the response and filter fields client-side. (Kept for forward compatibility.)
retract_query_from_rule Writes dataZapisuje dataZapisuje dátaAdatot ír
Removes a query from a rule's scope. It does not delete the query itself (for that, use `delete_query`). A rule must have ≥ 1 query; if you remove the last query, the rule will be left without scope and the next apply will fail. Use this tool to swap scope queries on an existing rule.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • query_id string requiredpovinnépovinnékötelező
    ID of query to unassign from the rule
  • rule_id string requiredpovinnépovinnékötelező
    ID of the rule to remove query from
show_maintenance_info Read-onlyPouze čteníIba čítanieCsak olvasás
Returns current and historical maintenance windows for the Mergado platform. Filter historical windows with the `from` timestamp if needed. Use this tool proactively when a user reports an unusual outage to check whether a maintenance window explains it.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • limit integer optionalvolitelnévoliteľnéválasztható
    Pagination: maximum number of items to return in one response (Mergado default is 10). Combine with `offset` to page through large result sets.
  • offset integer optionalvolitelnévoliteľnéválasztható
    Pagination: number of items to skip from the start of the result set (default 0). For the next page set offset to the previous offset plus limit the response's `total_results` tells you when to stop.
update_project_app Writes dataZapisuje dataZapisuje dátaAdatot ír
Updates billing details (`free_until`, `paid_until`) of a project-level app subscription. This operation is primarily intended for internal systems. Use this tool only when explicitly requested by a user with admin scope.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • app_name string requiredpovinnépovinnékötelező
    Name (ID) of the application
  • project_id string requiredpovinnépovinnékötelező
    ID of the project
  • free_until string optionalvolitelnévoliteľnéválasztható
    Trial expiration date (ISO 8601 format)
  • paid_until string optionalvolitelnévoliteľnéválasztható
    Paid subscription expiration date (ISO 8601 format)
update_query Writes dataZapisuje dataZapisuje dátaAdatot ír
Updates a query's name or MQL expression. Changing the expression affects all rules using this query (they will apply to a different product set on the next rebuild). Use this tool only after identifying which rules use the query.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    Query ID to update (named `id` here for legacy reasons; other tools call it `query_id`). Get it from `list_project_queries`.
  • name string optionalvolitelnévoliteľnéválasztható
    New name for the query
  • query string optionalvolitelnévoliteľnéválasztható
    New MQL query expression replacing the existing one
update_shop Writes dataZapisuje dataZapisuje dátaAdatot ír
Updates an eshop's display name or website URL. It only updates these fields and cannot change the tariff, owner, or permissions. Use this tool only when the user explicitly asks to rename an eshop or update its website URL.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    Shop ID to update. Get it from `list_user_eshops`.
  • name string optionalvolitelnévoliteľnéválasztható
    New name for the shop
  • web string optionalvolitelnévoliteľnéválasztható
    New website URL for the shop
  • xml_domain string optionalvolitelnévoliteľnéválasztható
    XML domain for the shop
update_shop_app Writes dataZapisuje dataZapisuje dátaAdatot ír
Updates billing details (`free_until`, `paid_until`) of a shop-level app subscription. This operation is primarily intended for internal systems. Use this tool only when explicitly requested by a user with admin scope.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • app_name string requiredpovinnépovinnékötelező
    Name (ID) of the application
  • shop_id string requiredpovinnépovinnékötelező
    ID of the shop
  • free_until string optionalvolitelnévoliteľnéválasztható
    Trial expiration date (ISO 8601 format)
  • paid_until string optionalvolitelnévoliteľnéválasztható
    Paid subscription expiration date (ISO 8601 format)
update_user_app Writes dataZapisuje dataZapisuje dátaAdatot ír
Updates billing details (free_until, paid_until) of a user-level app subscription. This operation is primarily intended for internal systems. Use this tool only when explicitly requested by a user with admin scope.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • app_name string requiredpovinnépovinnékötelező
    Name (ID) of the application
  • user_id string requiredpovinnépovinnékötelező
    ID of the user
  • free_until string optionalvolitelnévoliteľnéválasztható
    Trial expiration date (ISO 8601 format)
  • paid_until string optionalvolitelnévoliteľnéválasztható
    Paid subscription expiration date (ISO 8601 format)
update_variable Writes dataZapisuje dataZapisuje dátaAdatot ír
Updates a variable's name. Renaming may break rules that hardcode the old `{name}` token check `list_project_rules` and `list_project_queries` for references before renaming. (The API currently only supports updating the name field.)
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek
  • id string requiredpovinnépovinnékötelező
    Variable ID to update. Get it from `list_project_variables`.
  • name string optionalvolitelnévoliteľnéválasztható
    New name for the variable. Will affect all references in rules and queries.
workflow_element_paths_and_mql WorkflowWorkflowWorkflowWorkflow Read-onlyPouze čteníIba čítanieCsak olvasás
Call this before writing an element path, a product query, or a regular expression: how element paths work (nesting with |, conditions in { }, attributes, occurrences), MQL operators and syntax (it is not SQL) with examples, input vs. output element names, PCRE regex notes (capture groups & \1 references, use in Find and Replace, incl. the Czech-diacritics \b caveat), and query gotchas from real sessions (values_to_extract ignored, 500 on a fresh query, diacritics in NOT CONTAINS).
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek

This tool takes no input parameters.Tento nástroj nemá žádné vstupní parametry.Tento nástroj nemá žiadne vstupné parametre.Ennek az eszköznek nincsenek bemeneti paraméterei.

workflow_feed_diagnostics WorkflowWorkflowWorkflowWorkflow Read-onlyPouze čteníIba čítanieCsak olvasás
Call this when something is wrong with a feed: zero imported products, a data import that matched nothing, swapped element values (e.g. prices), wrong availability values, missing descriptions/images, stale data on the platform, Google Merchant Center rejections (e.g. missing GTIN), empty parameter tags, Meta category overwrites, missing shipping — plus how to read a Product Data Audit.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek

This tool takes no input parameters.Tento nástroj nemá žádné vstupní parametry.Tento nástroj nemá žiadne vstupné parametre.Ennek az eszköznek nincsenek bemeneti paraméterei.

workflow_getting_oriented WorkflowWorkflowWorkflowWorkflow Read-onlyPouze čteníIba čítanieCsak olvasás
Call this at the start of a task, before proposing any change, to understand a project: editing vs. format conversion, detecting the source platform, finding real element paths and values already in the feed, input vs. output element names, stable identifiers for pairing, related projects in the same shop (and 403 = wrong id), backing up the structure before larger changes, and avoiding duplicate Google projects.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek

This tool takes no input parameters.Tento nástroj nemá žádné vstupní parametry.Tento nástroj nemá žiadne vstupné parametre.Ennek az eszköznek nincsenek bemeneti paraméterei.

workflow_known_limitations WorkflowWorkflowWorkflowWorkflow Read-onlyPouze čteníIba čítanieCsak olvasás
Call this before relying on rounding, feed-audit, data-import, app, or stats-audit tools, and whenever a tool behaves oddly — times out, returns "Unknown tool", HTTP 500, or a suspiciously huge/empty response. Covers tools that currently fail, silent no-ops (values_to_extract ignored; data-import CSV matching/upload), fresh-query quirks, reliability & dynamic-loading cold-start, MCP-backend data gaps, and schema gotchas (no update_rule; create_element returns no id; matching_mode enum).
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek

This tool takes no input parameters.Tento nástroj nemá žádné vstupní parametry.Tento nástroj nemá žiadne vstupné parametre.Ennek az eszköznek nincsenek bemeneti paraméterei.

workflow_platform_specs WorkflowWorkflowWorkflowWorkflow Read-onlyPouze čteníIba čítanieCsak olvasás
Call this when the user asks about a specific advertising channel or comparison engine (Google, Heureka, Zboží, GLAMI, Meta/Instagram, TikTok, Pinterest, Bing, Kelkoo, idealo, Ceneo, Skroutz, Árukereső, Favi, Biano) to get the link to its current official feed specification
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek

This tool takes no input parameters.Tento nástroj nemá žádné vstupní parametry.Tento nástroj nemá žiadne vstupné parametre.Ennek az eszköznek nincsenek bemeneti paraméterei.

workflow_rules_cookbook WorkflowWorkflowWorkflowWorkflow Read-onlyPouze čteníIba čítanieCsak olvasás
Call this before creating or editing any rule (whenever the user wants to change how products are transformed): the full list of rule types (name → tool), the required parameters (element_path, priority, queries, applies), the Set Product Parameters path gotcha, common recipes, and the destructive Data File Import checklist.
Input parametersVstupní parametryVstupné parametreBemeneti paraméterek

This tool takes no input parameters.Tento nástroj nemá žádné vstupní parametry.Tento nástroj nemá žiadne vstupné parametre.Ennek az eszköznek nincsenek bemeneti paraméterei.