Mercado Libre MCP Server is a developer tool provided by Mercado Libre, based on the Model Context Protocol (MCP). MCP is an open protocol used to standardize the connection between artificial intelligence models and different data sources and tools. The server provides developers with practical tools that enable them to easily interact with Mercado Libre APIs and resources using natural language, thereby simplifying tasks and product integration.
In terms of main capabilities, Mercado Libre MCP Server exposes tools for facilitating integration and querying relevant information, specifically including: search_documentation, used to search for specific terms or key concepts in Mercado Libre developer technical documentation, with parameters including query (the keyword to search in the documentation, required), language (the documentation language to query, such as en_us, es_ar, pt_br, required), siteId (the country/region ID used to filter results, such as MLA, MLB, MLM, etc., optional), limit (the maximum number of results to return, optional), offset (the number of results to skip, optional); get_documentation_page, used to retrieve the complete content of a specific documentation page, making it easy to access detailed specifications or use cases, with parameters including path (the path of the page to retrieve, required).
In terms of usage, these tools are not used directly by users or developers, but are called by Agentic IDEs. For example, the search_documentation tool allows an Agentic IDE to search for key terms across all official Mercado Libre documentation and retrieve the most relevant endpoints or routes for the query context; then, through the get_documentation_page tool, the Agentic IDE can access the complete content of the route identified in the previous step, thereby obtaining specific information and specific use cases directly from the documentation. In this way, the IDE can automatically complete documentation querying and navigation, allowing developers to obtain contextually relevant and precise answers without manual searching.
In addition to querying documentation, MCP tools are also used by Agentic IDEs to generate code and assist with product integration in projects. For example, the assistant can be asked to review the documentation of the product to be integrated and determine the steps required to complete the integration. MCP Server provides relevant context (including code examples and technical documentation), and Agentic IDE Based on this, it suggests or even directly applies the required changes to the project. In this way, the IDE automatically completes the integrated querying, analysis, and implementation, simplifying the developer's work and accelerating the development process. Developers can also request implementation suggestions for a specific integration.
Regarding installation and configuration, the documentation provides instructions for connecting to different clients. When connecting to Mercado Libre DevSite MCP from Claude, the corresponding command can be run; it can also be configured manually locally or in a project configuration file by adding the specified JSON block. When connecting from Codex, add the specified block in the global or project config.toml file. When connecting from Cursor, you can click a button or do it manually, view and configure the available MCP servers in the configuration, and include the specified JSON block to connect to the MCP server. When connecting from Windsurf, follow the corresponding steps. When connecting from Gemini, add the specified block in the global or project settings.json file. In addition, you can open the IDE settings and find the JSON file related to the MCP server.
When connecting to the MCP server, you need to establish a remote connection from your preferred client (for example, Cursor). On the first connection, the OAuth authentication flow automatically opens in the browser, where you log in with your Mercado Libre account and authorize access. Then ensure that the MCP server is available and correctly configured in the client; if it does not appear, check the configuration and reload the MCP server list.
Authentication and authorization use OAuth 2.0, comply with industry standards, and eliminate the need to manually manage Access Tokens. Before use, make sure the prerequisites have been met.
Regarding errors and solutions, if the application remains in the "Loading Tools" state indefinitely when connecting or cannot establish a connection to the server, there may be a problem with the authentication flow. Possible causes include: the OAuth flow was not completed correctly (the browser window was closed before authorization), the session credentials have expired, the MCP client does not support the required OAuth flow (make sure you are using an updated version of the client), or the MCP server URL is configured incorrectly. Recommended solutions include: disconnect and reconnect the MCP server to restart the authentication flow; ensure that the authorization flow in the browser is completed before closing the window; verify that the configured URL is exactly https://mcp.mercadolibre.com/devsite/v1/mcp；将 Update the MCP client to the latest available version.
Other information: Mercado Libre uses cookies to improve the user experience; more details can be found in its privacy center. The remaining details are not provided for now.
