{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_4tnzvq9e2gx2","handle":"mercadolibre-mcp","url":"https://wellknown.network/agents/mercadolibre-mcp","links":{"self":"https://wellknown.network/agents/mercadolibre-mcp/record.json","html":"https://wellknown.network/agents/mercadolibre-mcp","markdown":"https://wellknown.network/agents/mercadolibre-mcp/record.md","api":"https://wellknown.network/api/v1/agents/mercadolibre-mcp","status":"https://wellknown.network/api/v1/agents/mercadolibre-mcp/status","claim":"https://wellknown.network/agents/mercadolibre-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/mercadolibre-mcp/claim.json","badge":"https://wellknown.network/agents/mercadolibre-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/mercadolibre-mcp/history","tools":"https://wellknown.network/api/v1/agents/mercadolibre-mcp/tools"},"ard":{"identifier":"urn:air::server:mercadolibre-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"mercadolibre-mcp","summary":"MCP server for MercadoLibre's REST API β full CRUD for listings, orders, shipping, ads, and more across 18 countries","description":"# MercadoLibre MCP Server\n\n[πΊπΈ English](README.md) | [πͺπΈ EspaΓ±ol](README.es.md)\n\nA [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server that wraps the [MercadoLibre REST API](https://developers.mercadolibre.com) β giving AI assistants the ability to search, create, update, delete, and manage product listings, orders, shipping, questions, advertising campaigns, and more across **18 countries** in Latin America.\n\n## Why?\n\nMercadoLibre already publishes an [official MCP server](https://developers.mercadolibre.com.uy/es_ar/mcp-server), but it only exposes **documentation search tools** β it cannot interact with the API on your behalf. This server fills that gap by wrapping **130+ REST API endpoints** as MCP tools that an AI assistant can call directly.\n\nCredentials and tokens are loaded from environment variables **never** passed through the LLM prompt, so your API keys stay secure.\n\n## Features\n\n- **Listings (CRUD)** β search, get, create, update, close, relist items\n- **Multi-country** β 18 sites: Argentina (MLA), Uruguay (MLU), Brazil (MLB), Mexico (MLM), Chile (MLC), and more\n- **Orders** β search and view seller orders\n- **Shipping** β get shipping methods, track shipments\n- **Categories** β browse, get details, predict the best category for a product\n- **Questions** β list and answer buyer questions\n- **Advertising** β list Mercado Ads campaigns\n- **Metrics** β get item visits and analytics\n- **User profiles** β get seller/buyer reputation\n\n## How it works\n\nIn plain terms: you talk to an AI assistant, the assistant calls this MCP server, and the server talks to MercadoLibre using your authorized seller account. Your API keys and tokens stay on your machine β the AI never sees them.\n\n```mermaid\nflowchart LR\n You([You]) -->|\"plain-language request\"| AI[\"AI assistant
(OpenCode, Claude, Cursor...)\"]\n AI -->|\"MCP protocol (stdio)\"| MCP[\"MercadoLibre MCP server
(local process)\"]\n MCP -->|\"HTTPS + access token\"| ML[(\"MercadoLibre Aβ¦","publisher":null,"homepage":null,"repository":null,"version":"0.3.2","license":"MIT","protocols":["mcp"],"tags":["ecommerce","mcp","mercadolibre","mercadolibre-api","model-context-protocol"],"pricing":null,"endpoints":[{"url":"pypi:mercadolibre-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","summary":"pypi","version":"pypi","description":"pypi"}},"derived":{"capabilities":[{"slug":"content.marketing","name":"Marketing","confidence":1,"provenance":"derived"},{"slug":"commerce.ecommerce","name":"E-commerce Operations","confidence":1,"provenance":"declared"},{"slug":"code.documentation","name":"Code Documentation","confidence":0.848,"provenance":"derived"}],"categories":["code","commerce","content"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"mercadolibre-mcp","registry":"pypi","observedAt":"2026-11-05T22:26:23.101Z","publishedAt":"2026-10-29T08:32:59.729671Z","latestVersion":"0.3.2"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"mercadolibre-mcp","url":"https://pypi.org/project/mercadolibre-mcp/","firstSeenAt":"2026-10-30T20:21:48.309Z","fetchedAt":"2026-11-05T22:24:38.760Z","normalizedAt":"2026-11-05T22:24:38.760Z"}]},"firstSeenAt":"2026-10-30T20:21:48.309Z","updatedAt":"2026-11-05T22:26:23.101Z"}