{"_id":"@dan1d/mercadolibre-mcp","_rev":"3-3864ee487389c5e0254a918236646350","name":"@dan1d/mercadolibre-mcp","dist-tags":{"latest":"1.0.2"},"versions":{"1.0.0":{"name":"@dan1d/mercadolibre-mcp","version":"1.0.0","author":{"name":"dan1d"},"license":"MIT","_id":"@dan1d/mercadolibre-mcp@1.0.0","maintainers":[{"name":"dan1d","email":"danielfromarg@gmail.com"}],"homepage":"https://github.com/dan1d/mercadolibre-mcp#readme","bugs":{"url":"https://github.com/dan1d/mercadolibre-mcp/issues"},"bin":{"mercadolibre-mcp":"bin/mcp-server.mjs"},"dist":{"shasum":"527026d57bc804127375b1de7549756d08d90657","tarball":"https://registry.npmjs.org/@dan1d/mercadolibre-mcp/-/mercadolibre-mcp-1.0.0.tgz","fileCount":20,"integrity":"sha512-tMcLb+OllK5hbuhEAsU9SA/usiNDj+GZ7E/du731qB68ycT4Fh0RD02XV6usmqj3/V4Euxycpz4Dv+OHn5Oiuw==","signatures":[{"sig":"MEUCIQDkjzmSw1vGwfc78gWzs1bFCtWhmFRcfGc03HK312nBNAIgdUSfknF4I7EyXXpsii+Tuw+zn6cPv6SI3SI8F6lwTao=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":29904},"main":"dist/index.js","types":"dist/index.d.ts","engines":{"node":">=18"},"exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.js"}},"gitHead":"91511c7efbc776e23a4b8d9cc283641a897b4fa3","scripts":{"test":"vitest run","build":"tsc","test:coverage":"vitest run --coverage"},"_npmUser":{"name":"dan1d","email":"danielfromarg@gmail.com"},"repository":{"url":"git+https://github.com/dan1d/mercadolibre-mcp.git","type":"git"},"_npmVersion":"10.9.4","description":"MercadoLibre MCP server for AI agents. Search products, browse categories, track trends across Latin America.","directories":{},"_nodeVersion":"22.22.1","dependencies":{"zod":"^3.23.0","@modelcontextprotocol/sdk":"^1.27.1"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^1.6.0","typescript":"^5.4.0"},"_npmOperationalInternal":{"tmp":"tmp/mercadolibre-mcp_1.0.0_1773005822807_0.048960836214615666","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@dan1d/mercadolibre-mcp","version":"1.0.1","author":{"name":"dan1d"},"license":"MIT","_id":"@dan1d/mercadolibre-mcp@1.0.1","maintainers":[{"name":"dan1d","email":"danielfromarg@gmail.com"}],"homepage":"https://github.com/dan1d/mercadolibre-mcp#readme","bugs":{"url":"https://github.com/dan1d/mercadolibre-mcp/issues"},"bin":{"mercadolibre-mcp":"bin/mcp-server.mjs"},"dist":{"shasum":"d164555db7a9400af299a31ac7d1054d620d22a4","tarball":"https://registry.npmjs.org/@dan1d/mercadolibre-mcp/-/mercadolibre-mcp-1.0.1.tgz","fileCount":22,"integrity":"sha512-Y5xS6ZbuPPijU9F7w5907Ju5Ek4kX1eDp7qegTtGyl9mBZkC83KT+vMIWqwTiUTAcgSQ1CK45VTdFl/2ne/PuA==","signatures":[{"sig":"MEYCIQDX3lvFSPviTaWSOlrO++EMYsptT+tRrgtS/Jwe0xn/vQIhAO/jUzo/YU0EKr38VoyQj3uzg+9D1ztCe1lvydhxSYVG","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":36153},"main":"dist/index.js","types":"dist/index.d.ts","engines":{"node":">=18"},"exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.js"}},"gitHead":"c48c76779be65ecf4bb8756f6f574225d695caaa","scripts":{"test":"vitest run","build":"tsc","test:coverage":"vitest run --coverage"},"_npmUser":{"name":"dan1d","email":"danielfromarg@gmail.com"},"repository":{"url":"git+https://github.com/dan1d/mercadolibre-mcp.git","type":"git"},"_npmVersion":"10.9.4","description":"MercadoLibre MCP server for AI agents. Search products, browse categories, track trends across Latin America.","directories":{},"_nodeVersion":"22.22.1","dependencies":{"zod":"^3.23.0","@modelcontextprotocol/sdk":"^1.27.1"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^1.6.0","typescript":"^5.4.0"},"_npmOperationalInternal":{"tmp":"tmp/mercadolibre-mcp_1.0.1_1773012632544_0.416120640569694","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@dan1d/mercadolibre-mcp","version":"1.0.2","description":"MercadoLibre MCP server for AI agents. Search products, browse categories, track trends across Latin America.","main":"dist/index.js","types":"dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.js"}},"bin":{"mercadolibre-mcp":"bin/mcp-server.mjs"},"scripts":{"build":"tsc","test":"vitest run","test:coverage":"vitest run --coverage"},"author":{"name":"dan1d"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/dan1d/mercadolibre-mcp.git"},"engines":{"node":">=18"},"dependencies":{"@modelcontextprotocol/sdk":"^1.27.1","zod":"^3.23.0"},"devDependencies":{"typescript":"^5.4.0","vitest":"^1.6.0"},"_id":"@dan1d/mercadolibre-mcp@1.0.2","gitHead":"c48c76779be65ecf4bb8756f6f574225d695caaa","bugs":{"url":"https://github.com/dan1d/mercadolibre-mcp/issues"},"homepage":"https://github.com/dan1d/mercadolibre-mcp#readme","_nodeVersion":"22.22.1","_npmVersion":"10.9.4","dist":{"integrity":"sha512-QdDsOY/vrdac19QxHyyW4jP6bruYQcsBaqZJoAEPunKKrnPtjv1NGM27luO9q2igxpDTSGsvtCJ4uleSBgefHA==","shasum":"3492073d0ca3725f58b59ae27a4a1a4b7f6225cf","tarball":"https://registry.npmjs.org/@dan1d/mercadolibre-mcp/-/mercadolibre-mcp-1.0.2.tgz","fileCount":22,"unpackedSize":36153,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIF7e3iR3X7gdXIfBCuLm3IeU8P9y+TjiATP/drLG6C4NAiEAo5YyOExtzlAd52y6We6Ps7OvW4Bem7damF3CGTFXhMs="}]},"_npmUser":{"name":"dan1d","email":"danielfromarg@gmail.com"},"directories":{},"maintainers":[{"name":"dan1d","email":"danielfromarg@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mercadolibre-mcp_1.0.2_1773012634801_0.7793107875450527"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-08T21:37:02.681Z","modified":"2026-03-08T23:30:35.088Z","1.0.0":"2026-03-08T21:37:02.953Z","1.0.1":"2026-03-08T23:30:32.694Z","1.0.2":"2026-03-08T23:30:34.969Z"},"bugs":{"url":"https://github.com/dan1d/mercadolibre-mcp/issues"},"author":{"name":"dan1d"},"license":"MIT","homepage":"https://github.com/dan1d/mercadolibre-mcp#readme","repository":{"type":"git","url":"git+https://github.com/dan1d/mercadolibre-mcp.git"},"description":"MercadoLibre MCP server for AI agents. Search products, browse categories, track trends across Latin America.","maintainers":[{"name":"dan1d","email":"danielfromarg@gmail.com"}],"readme":"# mercadolibre-mcp\n\n**MercadoLibre marketplace for AI agents.**\n\n[![npm version](https://img.shields.io/npm/v/@dan1d/mercadolibre-mcp)](https://www.npmjs.com/package/@dan1d/mercadolibre-mcp)\n[![tests](https://img.shields.io/github/actions/workflow/status/dan1d/mercadolibre-mcp/ci.yml?label=tests)](https://github.com/dan1d/mercadolibre-mcp/actions)\n[![npm downloads](https://img.shields.io/npm/dm/@dan1d/mercadolibre-mcp)](https://www.npmjs.com/package/@dan1d/mercadolibre-mcp)\n[![license](https://img.shields.io/npm/l/@dan1d/mercadolibre-mcp)](./LICENSE)\n\nMCP server that connects AI agents to [MercadoLibre](https://www.mercadolibre.com), the largest e-commerce marketplace in Latin America (150M+ users). Search products, get item details, browse categories, track trends, and convert currencies across Argentina, Brazil, Mexico, Chile, Colombia, and more.\n\n[npm](https://www.npmjs.com/package/@dan1d/mercadolibre-mcp) | [GitHub](https://github.com/dan1d/mercadolibre-mcp)\n\n---\n\n## Quick Start\n\nNo API key required for public endpoints (search, items, categories, trends).\n\n### Claude Desktop\n\nAdd to your `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"mercadolibre\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@dan1d/mercadolibre-mcp\"]\n    }\n  }\n}\n```\n\n### Claude Code\n\n```bash\nclaude mcp add mercadolibre -- npx -y @dan1d/mercadolibre-mcp\n```\n\n### Cursor\n\nAdd to `.cursor/mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"mercadolibre\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@dan1d/mercadolibre-mcp\"]\n    }\n  }\n}\n```\n\n### Windsurf\n\n```json\n{\n  \"mcpServers\": {\n    \"mercadolibre\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@dan1d/mercadolibre-mcp\"]\n    }\n  }\n}\n```\n\n### With authentication (optional)\n\nFor endpoints that require auth (future premium features), add your access token:\n\n```json\n{\n  \"mcpServers\": {\n    \"mercadolibre\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@dan1d/mercadolibre-mcp\"],\n      \"env\": {\n        \"MERCADOLIBRE_ACCESS_TOKEN\": \"APP_USR-...\"\n      }\n    }\n  }\n}\n```\n\n> Once configured, ask your AI assistant things like: *\"Search for iPhone 15 on MercadoLibre\"* or *\"What are the trending searches in Argentina?\"* or *\"Show me details for item MLA1234567890\"*\n\n---\n\n## Available Tools\n\n| Tool | Description |\n|------|-------------|\n| `search_items` | Search products by keyword. Filter by category, price range, and site (MLA=Argentina, MLB=Brazil, MLM=Mexico, MLC=Chile, MCO=Colombia). |\n| `get_item` | Get full item details: title, price, pictures, seller, condition, stock, and more. |\n| `get_item_description` | Get the full text description of an item. |\n| `get_categories` | List all top-level categories for a MercadoLibre site. |\n| `get_category` | Get category details including name, path from root, and children. |\n| `get_seller_info` | Get seller profile: reputation, ratings, and transaction stats. |\n| `get_trends` | Get current trending searches for a specific site/country. |\n| `get_currency_conversion` | Convert between currencies using MercadoLibre exchange rates (ARS, BRL, MXN, USD, etc.). |\n\n---\n\n## Supported Sites\n\n| Site ID | Country |\n|---------|---------|\n| `MLA` | Argentina |\n| `MLB` | Brazil |\n| `MLM` | Mexico |\n| `MLC` | Chile |\n| `MCO` | Colombia |\n| `MLU` | Uruguay |\n| `MPE` | Peru |\n| `MEC` | Ecuador |\n| `MCR` | Costa Rica |\n| `MPA` | Panama |\n| `MLV` | Venezuela |\n| `MRD` | Dominican Republic |\n| `MHN` | Honduras |\n| `MBO` | Bolivia |\n| `MNI` | Nicaragua |\n| `MPY` | Paraguay |\n| `MSV` | El Salvador |\n| `MGT` | Guatemala |\n\n---\n\n## Example Prompts\n\n- \"Search for PlayStation 5 under $500000 in Argentina\"\n- \"Show me the details of item MLA1405857684\"\n- \"What are the trending searches in Brazil?\"\n- \"List all categories on MercadoLibre Mexico\"\n- \"Show me the reputation of seller 123456789\"\n- \"Convert 100 USD to ARS\"\n\n---\n\n## Programmatic Usage\n\n```bash\nnpm install @dan1d/mercadolibre-mcp\n```\n\n```typescript\nimport { createMercadoLibreTools } from \"@dan1d/mercadolibre-mcp\";\n\nconst ml = createMercadoLibreTools();\n\n// Search products\nconst results = await ml.tools.search_items({\n  query: \"iPhone 15\",\n  site_id: \"MLA\",\n  price_max: 2000000,\n  limit: 5,\n});\n\n// Get item details\nconst item = await ml.tools.get_item({ item_id: \"MLA1405857684\" });\n\n// Get trending searches in Argentina\nconst trends = await ml.tools.get_trends({ site_id: \"MLA\" });\n\n// Browse categories\nconst categories = await ml.tools.get_categories({ site_id: \"MLA\" });\n\n// Get seller reputation\nconst seller = await ml.tools.get_seller_info({ seller_id: 123456789 });\n\n// Convert currencies\nconst conversion = await ml.tools.get_currency_conversion({\n  from: \"USD\",\n  to: \"BRL\",\n  amount: 100,\n});\n```\n\n---\n\n## Part of the LATAM MCP Toolkit\n\n| Server | What it does |\n|--------|-------------|\n| [CobroYa](https://github.com/dan1d/mercadopago-tool) | Mercado Pago payments — create links, search payments, refunds |\n| **MercadoLibre MCP** | MercadoLibre marketplace — search products, categories, trends |\n| [DolarAPI MCP](https://github.com/dan1d/dolar-mcp) | Argentine exchange rates — blue, oficial, CCL, crypto, conversion |\n\n---\n\n## License\n\n[MIT](./LICENSE) -- by [dan1d](https://dan1d.dev/)\n","readmeFilename":"README.md"}