# Mercado Livre Vendedor — MCP server on mcp.ai
> Mercado Livre (Latin America's largest marketplace) via the official API, seller profile and reputation, listings, orders, questions, shipping (Mercado Envios), categories and visits, over OAuth 2.0. Read-only. The platform provides the OAuth app, just click Authorize and log into your Mercado Livre account.

By: mcp.ai · official
Page: https://mcp.ai/mercadolivre

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_mercadolivre?ms=1781750940000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/mercadolivre/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/mercadolivre/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/mercadolivre/skill.md
Postman collection (v2.1): https://mcp.ai/mercadolivre/postman.json

## Tools
- mercadolivre_get_category(id: string, account?: string, ids?: string[]) — Detalha uma categoria por id (GET /categories/{id}): caminho, atributos, settings.
- mercadolivre_get_items(ids: string[], attributes?: string, account?: string) — 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).
- mercadolivre_get_order(id: string, account?: string, ids?: string[]) — Detalha um pedido por id (GET /orders/{id}): itens, comprador, pagamento, envio.
- mercadolivre_get_question(id: string, account?: string, ids?: string[]) — Detalha uma pergunta por id (GET /questions/{id}).
- mercadolivre_get_shipment(id: string, account?: string, ids?: string[]) — Detalha um envio por id (GET /shipments/{id}): status, rastreio, endereço, custo. Pegue o shipping.id no detalhe do pedido (mercadolivre_get_order).
- mercadolivre_get_user(id: string, account?: string, ids?: string[]) — Detalha um usuário público por id (GET /users/{id}).
- mercadolivre_item_visits(id: string, last?: integer, unit?: string, account?: string, ids?: string[]) — Visitas de um anúncio numa janela de tempo (GET /items/{id}/visits/time_window). Informe `last` (quantidade) e `unit` (day, week, month).
- mercadolivre_list_accounts(account?: string) — Lista as contas Mercado Livre conectadas a este install — id, label, seller_id.
- mercadolivre_list_categories(site?: string, account?: string) — Lista as categorias raiz de um site (GET /sites/{site}/categories). `site` default MLB.
- mercadolivre_list_items(offset?: integer, limit?: integer, status?: string, account?: string) — 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_g
- mercadolivre_list_orders(offset?: integer, limit?: integer, status?: string, sort?: string, q?: string, account?: string) — Lista pedidos do vendedor conectado (GET /orders/search?seller=). Paginado. Filtros opcionais: `order.status` (paid, confirmed, cancelled...), `sort` (date_asc/date_desc), `q` (busca).
- mercadolivre_list_questions(offset?: integer, limit?: integer, status?: string, item?: string, account?: string) — Lista perguntas recebidas pelo vendedor (GET /questions/search?seller_id=). Paginado. Filtros opcionais: `status` (UNANSWERED, ANSWERED), `item` (id do anúncio).
- mercadolivre_me(account?: string) — Dados da conta do vendedor conectado (GET /users/me): perfil, reputação, site, tipo de conta, status de vendedor.
- mercadolivre_search_items(offset?: integer, limit?: integer, site?: string, q?: string, category?: string, account?: string) — Busca anúncios do vendedor já com detalhes (GET /sites/{site}/search?seller_id=). Paginado. `site` default MLB (Brasil). Filtro opcional `q` (texto), `category`.

## Example prompts
- "List my paid orders from the last 7 days"
- "Which questions on my listings are unanswered?"
- "Show visits for listing MLB... in the last 30 days"

## Links
Docs: https://mcp.ai/docs/mcps/mercadolivre
Website: https://mcp.ai/mcps/mercadolivre