Mercado Livre Vendedor
Mercado Livre (Latin America's largest marketplace) via the official API, seller profile and reputat
Should I use this
Quality & Safety
Findings (1)
- LOWTool 'connect' description lacks action verbin connect
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"mercadolivre-mcp": {
"url": "https://api.mcp.ai/p_mercadolivre"
}
}
}Remote endpoints
https://api.mcp.ai/p_mercadolivrestreamable-httpWhat it can do
Tool inventory
Tools (20)
🟢mercadolivre_list_accounts(account)
Lista as contas Mercado Livre conectadas a este install — id, label, seller_id.
Input Schema
{
"type": "object",
"properties": {
"account": {
"type": "string"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢mercadolivre_me(account)
Dados da conta do vendedor conectado (GET /users/me): perfil, reputação, site, tipo de conta, status de vendedor.
Input Schema
{
"type": "object",
"properties": {
"account": {
"type": "string"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢mercadolivre_get_user(id, account, ids)
Detalha um usuário público por id (GET /users/{id}). Bulk support: accepts ids for batched execution.
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "string"
},
"account": {
"type": "string"
},
"ids": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢mercadolivre_list_items(offset, limit, status, account)
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.
Input Schema
{
"type": "object",
"properties": {
"offset": {
"type": "number"
},
"limit": {
"type": "number"
},
"status": {
"type": "string"
},
"account": {
"type": "string"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢mercadolivre_get_items(ids, attributes, account)
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).
Input Schema
{
"type": "object",
"properties": {
"ids": {
"type": "array",
"items": {
"type": "string"
}
},
"attributes": {
"type": "string"
},
"account": {
"type": "string"
}
},
"required": [
"ids"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢mercadolivre_search_items(offset, limit, site, q, category, ...)
Busca anúncios do vendedor já com detalhes (GET /sites/{site}/search?seller_id=). Paginado. `site` default MLB (Brasil). Filtro opcional `q` (texto), `category`.
Input Schema
{
"type": "object",
"properties": {
"offset": {
"type": "number"
},
"limit": {
"type": "number"
},
"site": {
"type": "string"
},
"q": {
"type": "string"
},
"category": {
"type": "string"
},
"account": {
"type": "string"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢mercadolivre_list_orders(offset, limit, status, sort, q, ...)
Lista pedidos do vendedor conectado (GET /orders/search?seller=). Paginado. Filtros opcionais: `order.status` (paid, confirmed, cancelled...), `sort` (date_asc/date_desc), `q` (busca).
Input Schema
{
"type": "object",
"properties": {
"offset": {
"type": "number"
},
"limit": {
"type": "number"
},
"status": {
"type": "string"
},
"sort": {
"type": "string"
},
"q": {
"type": "string"
},
"account": {
"type": "string"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢mercadolivre_get_order(id, account, ids)
Detalha um pedido por id (GET /orders/{id}): itens, comprador, pagamento, envio. Bulk support: accepts ids for batched execution.
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "string"
},
"account": {
"type": "string"
},
"ids": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢mercadolivre_list_questions(offset, limit, status, item, account)
Lista perguntas recebidas pelo vendedor (GET /questions/search?seller_id=). Paginado. Filtros opcionais: `status` (UNANSWERED, ANSWERED), `item` (id do anúncio).
Input Schema
{
"type": "object",
"properties": {
"offset": {
"type": "number"
},
"limit": {
"type": "number"
},
"status": {
"type": "string"
},
"item": {
"type": "string"
},
"account": {
"type": "string"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢mercadolivre_get_question(id, account, ids)
Detalha uma pergunta por id (GET /questions/{id}). Bulk support: accepts ids for batched execution.
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "string"
},
"account": {
"type": "string"
},
"ids": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢mercadolivre_get_shipment(id, account, ids)
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.
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "string"
},
"account": {
"type": "string"
},
"ids": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢mercadolivre_list_categories(site, account)
Lista as categorias raiz de um site (GET /sites/{site}/categories). `site` default MLB.
Input Schema
{
"type": "object",
"properties": {
"site": {
"type": "string"
},
"account": {
"type": "string"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢mercadolivre_get_category(id, account, ids)
Detalha uma categoria por id (GET /categories/{id}): caminho, atributos, settings. Bulk support: accepts ids for batched execution.
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "string"
},
"account": {
"type": "string"
},
"ids": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢mercadolivre_item_visits(id, last, unit, account, ids)
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.
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "string"
},
"last": {
"type": "number"
},
"unit": {
"type": "string"
},
"account": {
"type": "string"
},
"ids": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢show_version
Show the current MCP platform and adapter versions.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡report_bug(message, context, conversation)
Report a bug, missing feature, or send feedback. Include the conversation array with recent messages for reproduction.
Input Schema
{
"type": "object",
"properties": {
"message": {
"type": "string"
},
"context": {
"default": "",
"type": "string"
},
"conversation": {
"default": "[]",
"type": "string"
}
},
"required": [
"message"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢connect
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.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢toolkit_info
Returns the current toolkit state: installed MCPs, their connection status, the accounts connected to each one, and how many catalog tools each exposes.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡marketplace(action, query, mcp_id, limit, tier_slug, ...)
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.
Input Schema
{
"type": "object",
"properties": {
"action": {
"default": "search",
"type": "string",
"enum": [
"search",
"describe",
"install",
"uninstall",
"subscribe",
"cancel",
"resume",
"report_bug",
"request_mcp",
"list_tools",
"invoke",
"search_prompts",
"get_prompt",
"publish_prompt"
]
},
"query": {
"default": "",
"type": "string"
},
"mcp_id": {
"default": "",
"type": "string"
},
"limit": {
"default": 10,
"type": "number"
},
"tier_slug": {
"default": "",
"type": "string"
},
"immediate": {
"default": false,
"type": "boolean"
},
"cancel_reason": {
"type": "string",
"enum": [
"too_expensive",
"missing_features",
"switched_service",
"unused",
"customer_service",
"too_complex",
"low_quality",
"other"
]
},
"cancel_comment": {
"default": "",
"type": "string"
},
"message": {
"default": "",
"type": "string"
},
"report_context": {
"default": "",
"type": "string"
},
"conversation": {
"default": "[]",
"type": "string"
},
"request_name": {
"default": "",
"type": "string"
},
"request_details": {
"default": "",
"type": "string"
},
"tool_id": {
"default": "",
"type": "string"
},
"arguments": {
"default": "{}",
"type": "string"
},
"prompt_slug": {
"default": "",
"type": "string"
},
"prompt_vars": {
"default": "{}",
"type": "string"
},
"prompt_category": {
"default": "",
"type": "string"
},
"prompt_tool": {
"default": "",
"type": "string"
},
"prompt_title": {
"default": "",
"type": "string"
},
"prompt_description": {
"default": "",
"type": "string"
},
"prompt_body": {
"default": "",
"type": "string"
},
"prompt_targets": {
"default": [],
"type": "array",
"items": {
"type": "string",
"enum": [
"claude",
"chatgpt",
"cursor",
"lovable"
]
}
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡authenticate(token)
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.
Input Schema
{
"type": "object",
"properties": {
"token": {
"type": "string"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}Community
Evidence