Mercado Livre Vendedor
by mcp-dir · remote · no sign-in to list tools · v0.1.0 · published by GitHub user mcp-dir
Mercado Livre (Latin America's largest marketplace) via the official API, seller profile and reputat
20 tools: 5 change things and 15 only read.
Scanned Oct 21, 2026
- Deletes or cancels0Claude Code: deny
- Can't be undone0Claude Code: ask
- Changes things5Claude Code: ask: see these tools
- Only reads15Claude Code: allow: see these tools
2 checks matched something in the tool definitions. No finding is not a safety guarantee. How the checks work.
claude mcp add --transport http mercadolivre https://api.mcp.ai/p_mercadolivreFindings
Matches of fixed checks, with the text they matched.
- Infoconnect
The description mentions "credentials".
What this check looks forMatched text
description: "...nticated:true and empty pending[]. When credentials are missing, returns connect_url for th..."
- Infomarketplace
The description mentions "credential".
What this check looks forMatched text
description: "...ating the tool list. If the MCP needs a credential/login, invoke returns a connect link; i..."
Tools
Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.
20 tools
Changes things 5Claude Code: ask
authenticateMCP.AI for IDE agents (Cursor, etc.): log in in the browser, copy the access token.No findings
Why it is in this group
- Nothing in its name or description says what it does, so it is counted as a write.
Description, as the server wrote it MCP.AI for IDE agents (Cursor, etc.): log in in the browser, copy the access token. Best: add it to this server's config as a header `Authorization: Bearer <token>` for a permanent, non-expiring connection. Or paste it here for a session-only login: call with { token: "<jwt>" } after the user pastes, or with no args to get the link.
Annotations the server declares
- title: Authenticate
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
marketplaceThe official mcp.ai marketplace — the in-platform catalog of every MCP/tool, AND the way to run them.1 finding
Why it is in this group
- Nothing in its name or description says what it does, so it is counted as a write.
Findings
- Info
The description mentions "credential".
What this check looks forMatched text
description: "...ating the tool list. If the MCP needs a credential/login, invoke returns a connect link; i..."
Description, as the server wrote it The official mcp.ai marketplace — the in-platform catalog of every MCP/tool, AND the way to run them. Covers capability requests like "find an MCP that does X", "consulta um CPF", "is there a tool for Y". Core flow: action=search discovers MCPs by intent → describe returns one MCP's full profile (every tool with its id + params, pricing, auth) so you pick the right tool_id → invoke RUNS that tool. KEY: invoke works even when the MCP is NOT installed — it runs the tool pontualmente (one-off), without adding the MCP to the toolkit and without bloating the tool list. If the MCP needs a credential/login, invoke returns a connect link; if it is paid and the wallet is empty, invoke returns a checkout/top-up link (the user opens it, then you retry). Use install only to make an MCP PERMANENT in the active toolkit (its tools then show up natively in future sessions); prefer invoke for a single/occasional use. list_tools lists what is callable right now. subscribe/cancel handle per-MCP billing; report_bug sends feedback; request_mcp asks us to build a NEW MCP when nothing fits. Search/describe flag installed_in_toolkit vs installed_in_workspace. Writes (install/uninstall/subscribe/cancel and the one-off install behind invoke) require workspace owner/admin. It also carries the mcp.ai PROMPT LIBRARY, which is about ready-made prompt TEXT rather than MCPs: search_prompts finds one, get_prompt returns its full text with {{variables}} filled, and publish_prompt saves a prompt and returns a shareable mcp.ai/p/<slug> link that opens without login.
Annotations the server declares
- title: Marketplace
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true
mercadolivre_item_visitsVisitas de um anúncio numa janela de tempo (GET /items/{id}/visits/time_window).No findings
Why it is in this group
- Nothing in its name or description says what it does, so it is counted as a write.
- The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
Description, as the server wrote it Visitas de um anúncio numa janela de tempo (GET /items/{id}/visits/time_window). Informe `last` (quantidade) e `unit` (day, week, month). Bulk support: accepts ids for batched execution.
Annotations the server declares
- title: mercadolivre_item_visits
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
mercadolivre_meDados da conta do vendedor conectado (GET /users/me): perfil, reputação, site, tipo de conta, status de vendedor.No findings
Why it is in this group
- Nothing in its name or description says what it does, so it is counted as a write.
- The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
Description, as the server wrote it Dados da conta do vendedor conectado (GET /users/me): perfil, reputação, site, tipo de conta, status de vendedor.
Annotations the server declares
- title: mercadolivre_me
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
report_bugReport a bug, missing feature, or send feedback.No findings
Why it is in this group
- Nothing in its name or description says what it does, so it is counted as a write.
Description, as the server wrote it Report a bug, missing feature, or send feedback. Include the conversation array with recent messages for reproduction.
Annotations the server declares
- title: Report Bug
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
Only reads 15Claude Code: allow
connectReturns connection status and URLs.1 finding
Why it is in this group
- The description's first verb is "return": a word for reading.
Findings
- Info
The description mentions "credentials".
What this check looks forMatched text
description: "...nticated:true and empty pending[]. When credentials are missing, returns connect_url for th..."
Description, as the server wrote it Returns connection status and URLs. When all providers are connected, returns authenticated:true and empty pending[]. When credentials are missing, returns connect_url for the toolkit and per-install URLs.
Annotations the server declares
- title: Connection Status
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
mercadolivre_get_categoryDetalha uma categoria por id (GET /categories/{id}): caminho, atributos, settings.No findings
Why it is in this group
- The name "mercadolivre_get_category" says "get": a word for reading.
Description, as the server wrote it Detalha uma categoria por id (GET /categories/{id}): caminho, atributos, settings. Bulk support: accepts ids for batched execution.
Annotations the server declares
- title: mercadolivre_get_category
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
mercadolivre_get_itemsDetalha um ou mais anúncios por id (GET /items?ids=).No findings
Why it is in this group
- The name "mercadolivre_get_items" says "get": a word for reading.
Description, as the server wrote it Detalha um ou mais anúncios por id (GET /items?ids=). Informe `ids` (lista, máx 20). Filtro opcional `attributes` (campos a retornar, separados por vírgula).
Annotations the server declares
- title: mercadolivre_get_items
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
mercadolivre_get_orderDetalha um pedido por id (GET /orders/{id}): itens, comprador, pagamento, envio.No findings
Why it is in this group
- The name "mercadolivre_get_order" says "get": a word for reading.
Description, as the server wrote it Detalha um pedido por id (GET /orders/{id}): itens, comprador, pagamento, envio. Bulk support: accepts ids for batched execution.
Annotations the server declares
- title: mercadolivre_get_order
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
mercadolivre_get_questionDetalha uma pergunta por id (GET /questions/{id}).No findings
Why it is in this group
- The name "mercadolivre_get_question" says "get": a word for reading.
Description, as the server wrote it Detalha uma pergunta por id (GET /questions/{id}). Bulk support: accepts ids for batched execution.
Annotations the server declares
- title: mercadolivre_get_question
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
mercadolivre_get_shipmentDetalha um envio por id (GET /shipments/{id}): status, rastreio, endereço, custo.No findings
Why it is in this group
- The name "mercadolivre_get_shipment" says "get": a word for reading.
Description, as the server wrote it Detalha um envio por id (GET /shipments/{id}): status, rastreio, endereço, custo. Pegue o shipping.id no detalhe do pedido (mercadolivre_get_order). Bulk support: accepts ids for batched execution.
Annotations the server declares
- title: mercadolivre_get_shipment
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
mercadolivre_get_userDetalha um usuário público por id (GET /users/{id}).No findings
Why it is in this group
- The name "mercadolivre_get_user" says "get": a word for reading.
Description, as the server wrote it Detalha um usuário público por id (GET /users/{id}). Bulk support: accepts ids for batched execution.
Annotations the server declares
- title: mercadolivre_get_user
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
mercadolivre_list_accountsLista as contas Mercado Livre conectadas a este install — id, label, seller_id.No findings
Why it is in this group
- The name "mercadolivre_list_accounts" says "list": a word for reading.
Description, as the server wrote it Lista as contas Mercado Livre conectadas a este install — id, label, seller_id.
Annotations the server declares
- title: mercadolivre_list_accounts
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
mercadolivre_list_categoriesLista as categorias raiz de um site (GET /sites/{site}/categories).No findings
Why it is in this group
- The name "mercadolivre_list_categories" says "list": a word for reading.
Description, as the server wrote it Lista as categorias raiz de um site (GET /sites/{site}/categories). `site` default MLB.
Annotations the server declares
- title: mercadolivre_list_categories
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
mercadolivre_list_itemsLista os ids dos anúncios do vendedor conectado (GET /users/{seller}/items/search).No findings
Why it is in this group
- The name "mercadolivre_list_items" says "list": a word for reading.
Description, as the server wrote it Lista os ids dos anúncios do vendedor conectado (GET /users/{seller}/items/search). Paginado (offset/limit). Filtro opcional `status` (active, paused, closed). Retorna ids + paging; use mercadolivre_get_items pra detalhar.
Annotations the server declares
- title: mercadolivre_list_items
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
mercadolivre_list_ordersLista pedidos do vendedor conectado (GET /orders/search?seller=).No findings
Why it is in this group
- The name "mercadolivre_list_orders" says "list": a word for reading.
Description, as the server wrote it Lista pedidos do vendedor conectado (GET /orders/search?seller=). Paginado. Filtros opcionais: `order.status` (paid, confirmed, cancelled...), `sort` (date_asc/date_desc), `q` (busca).
Annotations the server declares
- title: mercadolivre_list_orders
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
mercadolivre_list_questionsLista perguntas recebidas pelo vendedor (GET /questions/search?seller_id=).No findings
Why it is in this group
- The name "mercadolivre_list_questions" says "list": a word for reading.
Description, as the server wrote it Lista perguntas recebidas pelo vendedor (GET /questions/search?seller_id=). Paginado. Filtros opcionais: `status` (UNANSWERED, ANSWERED), `item` (id do anúncio).
Annotations the server declares
- title: mercadolivre_list_questions
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
mercadolivre_search_itemsBusca anúncios do vendedor já com detalhes (GET /sites/{site}/search?seller_id=).No findings
Why it is in this group
- The name "mercadolivre_search_items" says "search": a word for reading.
Description, as the server wrote it Busca anúncios do vendedor já com detalhes (GET /sites/{site}/search?seller_id=). Paginado. `site` default MLB (Brasil). Filtro opcional `q` (texto), `category`.
Annotations the server declares
- title: mercadolivre_search_items
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
show_versionShow the current MCP platform and adapter versions.No findings
Why it is in this group
- The name "show_version" says "show": a word for reading.
Description, as the server wrote it Show the current MCP platform and adapter versions.
Annotations the server declares
- title: Show Version
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
toolkit_infoReturns the current toolkit state: installed MCPs, their connection status, the accounts connected to each one, and how many catalog tools each exposes.No findings
Why it is in this group
- The description's first verb is "return": a word for reading.
Description, as the server wrote it Returns the current toolkit state: installed MCPs, their connection status, the accounts connected to each one, and how many catalog tools each exposes.
Annotations the server declares
- title: Toolkit Info
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.
Install
Pinned to version 0.1.0. Values in angle brackets are yours to fill in.
claude mcp add --transport http mercadolivre https://api.mcp.ai/p_mercadolivreRun in a terminal.
Claude Code permissions
Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.
{
"permissions": {
"allow": [
"mcp__mercadolivre__mercadolivre_list_accounts",
"mcp__mercadolivre__mercadolivre_get_user",
"mcp__mercadolivre__mercadolivre_list_items",
"mcp__mercadolivre__mercadolivre_get_items",
"mcp__mercadolivre__mercadolivre_search_items",
"mcp__mercadolivre__mercadolivre_list_orders",
"mcp__mercadolivre__mercadolivre_get_order",
"mcp__mercadolivre__mercadolivre_list_questions",
"mcp__mercadolivre__mercadolivre_get_question",
"mcp__mercadolivre__mercadolivre_get_shipment",
"mcp__mercadolivre__mercadolivre_list_categories",
"mcp__mercadolivre__mercadolivre_get_category",
"mcp__mercadolivre__show_version",
"mcp__mercadolivre__connect",
"mcp__mercadolivre__toolkit_info"
],
"ask": [
"mcp__mercadolivre__mercadolivre_me",
"mcp__mercadolivre__mercadolivre_item_visits",
"mcp__mercadolivre__report_bug",
"mcp__mercadolivre__marketplace",
"mcp__mercadolivre__authenticate"
],
"deny": []
}
}Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. It assumes the server is installed as mercadolivre. Review it before you use it.
