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:
| Area | What you can query |
|---|---|
| Products | list, look up by SKU, view details and sales history |
| SKUs and variations | check sizes, colors, versions and registered attributes |
| Stock | see balance per SKU, look up warehouses and movements |
| Prices | check the current prices of items |
| Orders | list, view details, track status and messages |
| Categories, brands and tags | browse how the catalog is organized |
| Images | list the photos linked to each product |
| Marketplaces | see what's published on each channel (Mercado Livre, Shopee, Amazon, etc.) |
| Callbacks (webhooks) | list automated notifications already configured |
| Suggestions, characteristics and origins | look 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).
Option 1 β Directly in Claude Desktop (recommended)β
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:
- Open Claude Desktop.
- Go to Settings β Connectors.
- Click Add custom connector.
- Fill in:
- Name:
ANYMARKET - URL:
https://mcp.anymarket.com.br/mcp
- Name:
- 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 happens | Likely cause | What to do |
|---|---|---|
| The assistant doesn't recognize ANYMARKET commands | Configuration wasn't saved or the assistant wasn't restarted | Check the configuration file and restart the assistant |
| "Unauthorized" error appears | Your session expired | Log in again in the assistant when it asks |
| Permission error on some resource | Your organization doesn't have access to that query | Ask your ANYMARKET account administrator to review your permissions |
| "Too many requests" message | You made a lot of requests in a short time | Wait a few seconds and try again with a smaller volume |
| Login doesn't open in the browser | Your assistant is out of date | Update your assistant to the latest version |
| You asked to change/create something and the assistant didn't do it | MCP today is read-only | Make 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.