Mercado Livre Vendedor

io.github.mcp-dirPublished by GitHub account mcp-dirv0.1.0Updated Oct 24, 2026

Mercado Livre (Latin America's largest marketplace) via the official API, seller profile and reputat

VerifiedStreamable HTTPWeb executableData & AnalyticsBusiness & Commerce

Overview

AI-generated overview

Mercado Livre seller toolkit: lets an assistant read a connected seller's listings, orders, questions, shipments and reputation through the official API.

What you can do
  • List connected seller accounts and read the seller's own profile, reputation and account status
  • Browse and search the seller's listings, fetch listing details in batches, and check item visits over a time window
  • List and detail orders, including items, buyer, payment and shipping information
  • List and detail buyer questions, and look up shipments with status, tracking, address and cost
  • Explore site categories and root categories, and look up public user profiles
  • Platform helpers: connection status, toolkit info, version, bug reporting and a marketplace search for other MCPs
When to use it
Useful when an assistant should help run a Mercado Livre seller operation: reviewing listings and their performance, tracking orders and shipments, or triaging unanswered buyer questions without switching to the seller dashboard.
Requirements
Runs as a remote streamable HTTP endpoint, so no local runtime or package is needed. A Mercado Livre seller account must be connected to the platform; the connect tool returns per-install URLs when credentials are missing. The authenticate tool describes logging in through the browser and supplying an access token, either as an Authorization Bearer header in the server config or pasted for a session-only login.
Before you install
The server reads seller business data such as orders, buyer details, shipping addresses and revenue-related figures, which is sent to the remote endpoint and the model. The authenticate flow asks for an access token; treat it as a secret and prefer the header configuration over pasting it into a conversation. The report_bug tool sends recent conversation messages for reproduction, so review what is included. Tools here appear read-only, but confirm before relying on that.

Installation

In SourceWeft

  1. Open Mercado Livre Vendedor in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.mcp-dir%2Fmercadolivre-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "mercado-livre-vendedor": {
      "type": "http",
      "url": "https://api.mcp.ai/p_mercadolivre"
    }
  }
}

README

This repository has no README.

Tools

20

mercadolivre_list_accounts

Lista as contas Mercado Livre conectadas a este install — id, label, seller_id.

Parametersaccount

mercadolivre_me

Dados da conta do vendedor conectado (GET /users/me): perfil, reputação, site, tipo de conta, status de vendedor.

Parametersaccount

mercadolivre_get_user

Detalha um usuário público por id (GET /users/{id}). Bulk support: accepts ids for batched execution.

Parametersidrequiredidsaccount

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_get_items pra detalhar.

Parameterslimitoffsetstatusaccount

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).

Parametersidsrequiredaccountattributes

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`.

Parametersqsitelimitoffsetaccountcategory

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).

Parametersqsortlimitoffsetstatusaccount

mercadolivre_get_order

Detalha um pedido por id (GET /orders/{id}): itens, comprador, pagamento, envio. Bulk support: accepts ids for batched execution.

Parametersidrequiredidsaccount

mercadolivre_list_questions

Lista perguntas recebidas pelo vendedor (GET /questions/search?seller_id=). Paginado. Filtros opcionais: `status` (UNANSWERED, ANSWERED), `item` (id do anúncio).

Parametersitemlimitoffsetstatusaccount

mercadolivre_get_question

Detalha uma pergunta por id (GET /questions/{id}). Bulk support: accepts ids for batched execution.

Parametersidrequiredidsaccount

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). Bulk support: accepts ids for batched execution.

Parametersidrequiredidsaccount

mercadolivre_list_categories

Lista as categorias raiz de um site (GET /sites/{site}/categories). `site` default MLB.

Parameterssiteaccount

mercadolivre_get_category

Detalha uma categoria por id (GET /categories/{id}): caminho, atributos, settings. Bulk support: accepts ids for batched execution.

Parametersidrequiredidsaccount

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). Bulk support: accepts ids for batched execution.

Parametersidrequiredidslastunitaccount

show_version

Show Version

Show the current MCP platform and adapter versions.

Takes no parameters.

report_bug

Report Bug

Report a bug, missing feature, or send feedback. Include the conversation array with recent messages for reproduction.

Parameterscontextmessagerequiredconversation

connect

Connection Status

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.

Takes no parameters.

toolkit_info

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.

Takes no parameters.

marketplace

Marketplace

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.

Parameterslimitqueryactionmcp_idmessagetool_idargumentsimmediatetier_slugprompt_bodyprompt_slugprompt_tool+11 more

authenticate

Authenticate

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.

Parameterstoken

Version history

1
  1. v0.1.0LatestSep 16, 2026

Score

75% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts

    Declare a GitHub repository with a README, or serve resource_documentation in the OAuth protected-resource metadata.

  • License10 pts

    Declare a license in the repository or the registry entry.