mercadolibre-seller-mcp
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
mercadolibre-seller-mcp
An MCP server that lets an AI assistant run your MercadoLibre seller account: create and edit listings, see what you sold and what you bought, answer buyer questions and check fees, all in natural language.
Unofficial community project, not affiliated with MercadoLibre. MercadoLibre's own MCP server (
mcp.mercadolibre.com) only searches the API documentation. This one works with the seller APIs using your own OAuth token, on your machine.
What you can ask your assistant
"What did I sell in the last 30 days, and how much was left after fees?"
"What have I bought on MercadoLibre this quarter?"
"Show my active listings and pause the one with no stock."
"Create a listing for this product, draft the description, and show me a preview first."
"Are there unanswered buyer questions? Draft replies."
"What is the fee for a 25,000 ARS item in this category?"
Related MCP server: MCP MercadoLibre
Tools
Tool | Type | What it does |
| read | Seller id, nickname, reputation |
| read | Your listings / full details of one (description, attributes, photos, shipping) |
| read | Your sales for N days: orders, per-item totals, revenue, marketplace fees |
| read | Your own purchases as a buyer for N days |
| read | Buyer questions on your listings |
| read | Marketplace fee and net amount for a price / category / listing type |
| read | Find a category from a title; list its (required) attributes |
| write | Create a listing with photos and description |
| write | Price, stock, pause/activate, shipping mode, description, extra photos |
| write | Public answer to a buyer question |
Safety model
Write tools are dry-run by default. They return a preview; nothing changes until you pass
apply=true.create_listingrequires an explicitshipping(personal= arranged with the buyer, ormercadoenvios), so the assistant has to ask you instead of guessing.Listings cannot be closed or deleted through this server (irreversible), only paused/activated.
Answers containing Cyrillic are rejected (they would be published to buyers as typed).
Tokens are never returned or logged. They live in a local file (
chmod 600where supported).Runs locally over stdio. No third party sees your token or data.
Setup
Create an app in your country's MercadoLibre developers portal (for Argentina: developers.mercadolibre.com.ar). Set a redirect URI and enable read/write for items, orders and pre/post-sale communications (questions).
Install:
pip install -r requirements.txt(Python 3.10+).Configure: copy
.env.exampleto.envand fillMELI_CLIENT_ID,MELI_CLIENT_SECRET,MELI_REDIRECT_URI, andMELI_SITE_ID(defaultMLA; alsoMLB,MLM,MLC,MCO,MLU,MPE).Authorize once:
python auth.py, open the link, approve, paste thecodefrom the redirect URL. Tokens are saved to~/.meli-seller-mcp/tokens.json(override withMELI_TOKENS_PATH) and refreshed automatically.Check:
python server.py --selftestprints your account.
Connect to an MCP client
Claude Code / Claude Desktop / Cursor (.mcp.json or the client's MCP settings):
{
"mcpServers": {
"mercadolibre-seller": { "command": "python", "args": ["/absolute/path/to/server.py"] }
}
}Notes and limitations
Title, description, attributes and answers go to the marketplace exactly as written: use the site's language.
Some categories need
family_nameinstead oftitle; passfamily_namefor those.Free listing quotas, mandatory Mercado Envios in some categories and API permissions differ by site and account; API errors are returned as-is.
Public MercadoLibre endpoints change over time. If a call fails with 403, check the app's permissions.
Not covered yet: shipping labels, claims/returns, invoices, ads, bulk edits.
Project layout
server.py registers tools; tools_read.py / tools_write.py hold the logic; ml.py is a thin API facade;
meli_client.py handles OAuth and HTTP; auth.py is the one-time authorization helper.
License
MIT. Use at your own risk: you are responsible for what is published under your seller account.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Run an eBay seller account from your AI assistant: orders, listings, stock, fees and payouts.
Mercado Libre market data for AI agents: prices, best sellers, go/no-go. Pay-per-call with x402.
Mercado Libre keyword & competitor intelligence for AI agents across all 18 ML markets.
Run storefronts, listings, orders, content, fulfillment, and analytics through AI.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceConnects Claude to your MercadoLibre seller account, enabling natural language management of listings, orders, and shipments.-
- AlicenseAqualityCmaintenanceEnables sellers to connect their MercadoLibre accounts to Claude AI and query consolidated multi-store sales, real profitability, stock, listings, buyer questions, claims, Product Ads, and competitor prices in natural language.33MIT
- AlicenseAqualityBmaintenanceEnables AI assistants to search, create, update, delete, and manage product listings, orders, shipping, questions, advertising campaigns, and more across 18 Latin American countries via the MercadoLibre REST API.203MIT
- AlicenseBqualityBmaintenanceEnables sellers to connect one or more MercadoLibre store accounts to Claude over OAuth 2.0 with PKCE and ask about sales, orders, questions, catalog buy box, promotions, reputation, and competitor pricing in natural language, with optional write actions for pricing, stock, listings, and buyer replies. Supports consolidated multi-store reporting and requires no backend server, keeping tokens in a local file on the user's machine.321MIT