Documentación Mercado Libre

Descubre toda la información que debes conocer sobre las APIs de Mercado Libre.
circulos azuis em degrade

Documentación

Última actualización 30/06/2025

1. Introduction

The Model Context Protocol (MCP) is an open protocol that standardizes the connection of artificial intelligence models with different data sources and tools. In this context, the MCP Server from Mercado Libre offers utilities so that developers can easily interact with Mercado Libre’s APIs and resources using natural language, simplifying tasks and product integrations.

2. Prerequisites

Before starting, make sure you have the following environment:

Requirement Description
NodeJS Version 20 or higher.
NPM Version 6 or higher.
MCP Client A compatible client (for example, Cursor, Windsurf, Cline, Claude Desktop, ChatGPT, etc).
Credentials Access Token from your application in Mercado Libre.

3. Installation and configuration

3.1 Cursor

To connect to our MCP from Mercado Libre, you must first connect with the client that best fits your integration. Check the step-by-step according to the client type.

In Cursor, you can click the button below or follow the steps manually.


Note:
Replace <Access_Token> with your Access Token. More information on how to obtain it.

To connect to the MCP server of Mercado Libre from Cursor manually, follow these steps:

Cursor Settings > Tools & Integrations > New MCP Server

This will open a tab where you can view and configure the available MCP servers.
In the configuration, be sure to include the following JSON block to connect to the Mercado Libre MCP server

JSON:

{
  "mcpServers": {
    "mercadolibre-mcp-server": {
      "url": "https://mcp.mercadolibre.com/mcp",
      "headers": {
        "Authorization": "Bearer "
      }
    }
  }
}
Note:
Replace <Access_Token> with your Access Token. More information on how to obtain it.

3.2 Other IDEs

Open the IDE settings and look for the JSON file related to MCP servers.
Then, fill the “Authorization” fields with your Access Token.

JSON:

{
  "mcpServers": {
    "mercadolibre-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.mercadolibre.com/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer "
      }
    }
  }
}


Note:
Replace <Access_Token> with your Access Token.

4. MCP Server connection

  1. Establish the remote connection from your preferred client (e.g. Cursor).
  2. Make sure the MCP server is available and correctly configured in your client.
  3. If it doesn't appear, check the configuration and reload the MCP servers list.


5. Available tools

The MCP Server from Mercado Libre offers tools to make integration and information queries easier.

Tool Description Main parameters Required Detail
search_documentation Enables searching for specific terms or key concepts throughout the technical documentation for Mercado Libre developers. query Required Keywords to search within the documentation
language Required Documentation language to consult (e.g.: en_us, es_ar, pt_br)
siteId Optional Country ID to filter results (e.g.: MLA, MLB, MLM, etc)
limit Optional Maximum number of results to return
offset Optional Number of results to skip
get_documentation_page Retrieves the full content of a specific documentation page, useful for accessing specifications or detailed use cases. path Required Page route to retrieve
language Required Documentation language to consult (e.g.: en_us, es_ar, pt_br)
siteId Optional Country ID to filter results (e.g.: MLA, MLB, MLM, etc)


6. Use cases

MCP Server ensures that common developer activities are optimized easily and quickly. Below, find some use cases to implement in your integration.

Important:
The examples in this section use Cursor as the MCP client, but you can use any MCP client you prefer.

6.1 Search documentation from your IDE

The search_documentation tool performs keyword searches in the entire official Mercado Libre documentation from your environment, returning the most relevant endpoints or routes based on context.
With the most relevant routes, use the get_documentation_page tool to get the content of the previously identified routes and documentation, allowing you to get specific responses with use cases.

Prompt example:

Search Mercado Libre documentation on how to receive product notifications.




6.2 Generate integration code

In addition to consulting documentation, MCP tools also allow you to generate code for your projects.
You can ask the assistant to review the documentation for the product you want to integrate and tell you the steps required to complete the integration. MCP Server provides the relevant context including code and documentation so the IDE can suggest or directly apply the required changes to your project.

You can request recommendations to implement specific integrations, for example:

Using the Mercado Libre MCP Server configured in Cursor, generate a Node.js webhook that receives Mercado Libre notifications, consulting the official notification documentation through MCP.




7. Errors and solutions

7.1 Invalid or missing token

If when trying to connect, the application remains in "Loading Tools" state indefinitely or fails to connect to the server, there may be a problem with the authentication token.

Possible causes:

  • No authentication token was provided in the request.
  • The provided token has expired or is incorrect.
  • The token format is invalid (e.g., missing or incorrectly copied characters).
  • The token does not have the necessary permissions to access the requested resource.

Suggested solutions:

  • Check that the token is present in the request header (in Authorization: Bearer <AccessToken>).
  • Make sure the token has not expired. If so, request a new one.
  • Copy the full token, with no additional spaces or missing characters.