Skip to main content

ANYMARKET MCP

ANYMARKET MCP is a bridge that lets you talk to ANYMARKET using natural language inside your favorite AI assistant (Claude, ChatGPT, Gemini, and others). Instead of opening the panel and clicking through several menus to look up information, you just ask β€” in plain English β€” and the AI fetches the answer for you.

Important: for now, ANYMARKET MCP offers read-only commands. You can ask, list, search, and inspect information, but you can't yet create, change, or delete data through the assistant. Write actions will be released in future versions.

Some examples of what you can ask today:

  • "List the 10 most recent ANYMARKET products."
  • "How many orders came in today?"
  • "Show me the products that are out of stock."
  • "What's the current price of this SKU?"
  • "Which listings are published on Mercado Livre?"
  • "Bring me the details of order number 12345."

You don't need to know how to program or understand APIs β€” the assistant handles that. This guide shows how to connect each assistant to ANYMARKET MCP.

Before you start​

You'll need:

  • An ANYMARKET account with permission to access the resources you want to query (products, orders, stock, etc.).
  • An AI assistant that supports MCP already installed on your computer β€” for example Claude Code, Claude Desktop, Codex CLI, ChatGPT (via Connectors) or Gemini CLI.
  • MCP server address: https://mcp.anymarket.com.br/mcp β€” it's the same for everyone, you just paste this URL into your assistant's configuration.

The first time you use it, the assistant will open the browser so you can log in to ANYMARKET. After that, it remembers you until you close the session.

What you can query​

ANYMARKET MCP covers virtually every area of the panel β€” always read-only:

AreaWhat you can query
Productslist, look up by SKU, view details and sales history
SKUs and variationscheck sizes, colors, versions and registered attributes
Stocksee balance per SKU, look up warehouses and movements
Pricescheck the current prices of items
Orderslist, view details, track status and messages
Categories, brands and tagsbrowse how the catalog is organized
Imageslist the photos linked to each product
Marketplacessee what's published on each channel (Mercado Livre, Shopee, Amazon, etc.)
Callbacks (webhooks)list automated notifications already configured
Suggestions, characteristics and originslook up catalog support data

There are 100+ query commands available in total β€” but you don't need to memorize anything. Just ask in natural language and the assistant picks the right command.

How to connect from each assistant​

Every configuration below uses the same address: https://mcp.anymarket.com.br/mcp

Claude Code​

Open the terminal and run one of these commands:

To make it available across all your projects:

claude mcp add --scope user --transport http anymarket https://mcp.anymarket.com.br/mcp

To make it available only in the current project:

claude mcp add --scope project --transport http anymarket https://mcp.anymarket.com.br/mcp

Close and reopen Claude Code. The first time you ask something related to ANYMARKET, the browser will open for you to log in.

Claude Desktop​

There are two ways to connect β€” through the Claude Desktop UI itself (simpler, recommended) or by editing the configuration file (for those who prefer it).

If you use Claude Desktop with a personal account, or if your organization's administrator (if any) has enabled it, you can add ANYMARKET without touching any file:

  1. Open Claude Desktop.
  2. Go to Settings β†’ Connectors.
  3. Click Add custom connector.
  4. Fill in:
    • Name: ANYMARKET
    • URL: https://mcp.anymarket.com.br/mcp
  5. Save and enable the connector.

That's it β€” ANYMARKET is now available in your conversations. The first time you ask something, Claude will open the browser for you to log in.

Don't see the "Add custom connector" option? That means your organization's administrator hasn't enabled custom connectors yet. Ask them to enable it or use Option 2 below.

Option 2 β€” Editing the configuration file​

Open the Claude Desktop configuration file:

  • Windows: %APPDATA%\Claude\claude_desktop_config.json
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Linux: ~/.config/Claude/claude_desktop_config.json

Paste (or merge with what's already there):

{
"mcpServers": {
"anymarket": {
"type": "http",
"url": "https://mcp.anymarket.com.br/mcp"
}
}
}

Fully close and reopen Claude Desktop. Log in the first time you use ANYMARKET in a conversation.

Codex CLI (OpenAI)​

Open the file ~/.codex/config.toml (on Windows: %USERPROFILE%\.codex\config.toml) and add:

[mcp_servers.anymarket]
url = "https://mcp.anymarket.com.br/mcp"

Restart Codex CLI. Once connected, use /mcp to confirm that ANYMARKET appears in the list.

ChatGPT (Connectors)​

In ChatGPT desktop, go to Settings β†’ Beta features β†’ Connectors β†’ Add custom connector and fill in:

  • Name: ANYMARKET
  • URL: https://mcp.anymarket.com.br/mcp
  • Auth: OAuth (follow the on-screen instructions β€” authorization is handled by ANYMARKET itself)

Save, mark the connector as active, and choose Agent mode in the conversation.

Gemini CLI (Google)​

Open the file ~/.gemini/settings.json (on Windows: %USERPROFILE%\.gemini\settings.json) and add:

{
"mcpServers": {
"anymarket": {
"httpUrl": "https://mcp.anymarket.com.br/mcp",
"timeout": 30000,
"trust": false
}
}
}

Restart Gemini CLI and list available commands with /tools.

Testing that it worked​

Once connected, ask the assistant:

"List the 5 most recent ANYMARKET products."

If the list appears, everything is set up. If you want to check which account you're logged into, ask:

"Show me which ANYMARKET organization I'm connected to."

Best practices​

  • Be clear in your wording. The more specific the request (SKU, product name, time frame), the better the result.
  • Start with a small number of items. When asking for listings, request a small number first (e.g. "the first 5") to see the format before asking for larger volumes.
  • Need to change something? Since MCP today is read-only, any change (creating, editing, publishing, adjusting price or stock) still has to be done directly in the ANYMARKET panel.

Common issues​

What happensLikely causeWhat to do
The assistant doesn't recognize ANYMARKET commandsConfiguration wasn't saved or the assistant wasn't restartedCheck the configuration file and restart the assistant
"Unauthorized" error appearsYour session expiredLog in again in the assistant when it asks
Permission error on some resourceYour organization doesn't have access to that queryAsk your ANYMARKET account administrator to review your permissions
"Too many requests" messageYou made a lot of requests in a short timeWait a few seconds and try again with a smaller volume
Login doesn't open in the browserYour assistant is out of dateUpdate your assistant to the latest version
You asked to change/create something and the assistant didn't do itMCP today is read-onlyMake the change in the ANYMARKET panel; write actions will be released in future versions

Need help?​

If something isn't working, get in touch with the team responsible for ANYMARKET at your company β€” they have access to the server and can check whether everything is running correctly.