Skip to main content
ML

Mercado Libre

@codespar/mcp-mercado-libre · v0.2.2

🌎 Latin AmericaE-CommerceAuth · OAuth2live22 tools2 env vars

LatAm's largest marketplace: product listing, order management, seller metrics, and shipping labels. Your agent sells across 18 countries.

Get started · freeView docs

MIT · runs locally with your own credentials

Limitations

  • The package manifest does not declare 1 of the 2 variables the code reads.
  • The npm package ships no server.json manifest.
  • Hosted calls with a test key are not available: the runtime has not recorded this provider's test behaviour (test venue unclassified).
Package
@codespar/mcp-mercado-libre
Version
0.2.2
npm dist-tag
latest
Category
E-Commerce
Auth
OAuth2
Country
🌎 Latin America
License
MIT
Transport
stdio · streamable-http

Quickstart

Install, set the credentials, make the first call.

Pick your client. The server runs locally over stdio, with your own credentials.

Add the server to your clientOne config entry. No build step, no SDK required.
Set the environment variables2 variables read by this server's code, listed below.
Restart and make the first callThe agent can call any of the 22 tools. Try search_products first.
terminal
# Claude Code claude mcp add mercado-libre -e MELI_ACCESS_TOKEN=… -e MELI_SITE_ID=… -- npx -y @codespar/mcp-mercado-libre@0.2.2 # then: /mcp to confirm the server is connected
Environment variables2 variables
MELI_ACCESS_TOKENAPI key/token for mercado-librerequiredsecret
MELI_SITE_IDRead by the code; the package manifest does not declare it.

Names read from the package code (@codespar/mcp-mercado-libre@0.2.2). Descriptions and flags come from its manifest. Self-hosted, you hold the credentials.

First call demosearch_products

"Search products in Mercado Libre marketplace"

tools/callsearch_productsresult returned

Tools

What your agent can call.

22 tools, as the package's tools/list returns them.

search_products

Search products in Mercado Libre marketplace

get_product

Get detailed product information by item ID

get_product_description

Get product description text by item ID

list_categories

List all marketplace categories for the site

get_category

Get category details and children

predict_category

Predict the best category for a product title (domain_discovery)

get_trends

Get trending searches in the marketplace

list_listings

List seller's active product listings

update_item

Update item fields such as available_quantity (stock), status (active/paused/closed), price, or title

get_seller

Get seller information and reputation

list_orders

List seller orders with filters

get_order

Get order details by ID

Names and descriptions come from the package's tools/list (@codespar/mcp-mercado-libre@0.2.2). A kind (read, write, delete) is shown only when the package annotates its tools or each tool was verified one by one; neither exists for this server yet.

Compatibility

MCP is a protocol. Any client that speaks it can mount this server.

codespar_discover lists this server's tools, but a project with a test key cannot call them yet: the runtime has not recorded what this provider does in test mode, and refuses rather than guess.

Protocol

Any MCP client

stdio · streamable-http

Questions

Before you install.

How do I install the Mercado Libre MCP server?

Run npx -y @codespar/mcp-mercado-libre@0.2.2 and add the config block above to your MCP client: Claude Code, Cursor, Claude Desktop, VS Code, or any MCP-compatible client. No build step, no SDK required.

What can my agent do with Mercado Libre?

Mercado Libre exposes 22 tools for e-commerce. Your agent calls them directly; the full list is above.

How does Mercado Libre authenticate, and how are credentials stored?

Mercado Libre uses OAuth2. Self-hosted, you hold the credentials: the server reads them from its environment variables.

How does Mercado Libre handle upstream API changes?

Every server is versioned independently on npm. The command on this page pins 0.2.2, the version whose tools are listed here; your agent keeps running it until you change the version.

Is Mercado Libre open source? How do I report a bug?

Yes. Mercado Libre is MIT-licensed and published on npm as @codespar/mcp-mercado-libre, source on GitHub (link in the Details panel). Report issues on the package repository; security issues go to security@codespar.dev, and we respond within 24 hours.

Start in seconds.

Add the config above, set the variables, and your agent calls the tools.

Start in seconds demo
Add the server to your client with the config above.
Set the environment variables listed above.
Ask your agent for the first call.
Mercado Libre — MCP server · 22 tools | CodeSpar