# Mercado Livre Vendedor — how to use (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.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_mercadolivre?ms=1781750880000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `mercadolivre_get_category`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/mercadolivre`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/mercadolivre/_endpoints`

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

## 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"

## More
- Page: https://mcp.ai/mercadolivre
- Agent spec (llms.txt): https://mcp.ai/mercadolivre/llms.txt
- Postman collection: https://mcp.ai/mercadolivre/postman.json