Skip to main content
ME

Mercado Libre

v0.2.0OAuth2

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

22 tools1 env vars๐ŸŒŽ LATAMstable on npm

Install

terminal
$ npm install @codespar/mcp-mercado-libre

Quickstart

Add this entry to your claude_desktop_config.json (or any MCP-compatible client config).

claude_desktop_config.json
{
  "mcpServers": {
    "mercado-libre": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-mercado-libre"
      ],
      "env": {
        "MELI_ACCESS_TOKEN": "<your_meli_access_token>"
      }
    }
  }
}

After restart, your agent can call any of the 22 tools below โ€” try search_products first.

Environment variables ยท 1

Required to authenticate the server. Stored encrypted when using CodeSpar managed hosting.

MELI_ACCESS_TOKEN
requiredsecret

API key/token for mercado-libre

Available tools ยท 22

Each tool is independent โ€” your agent loads only what it needs to reduce context and response time.

READsearch_products
Search products in Mercado Libre marketplace
READget_product
Get detailed product information by item ID
READget_product_description
Get product description text by item ID
READlist_categories
List all marketplace categories for the site
READget_category
Get category details and children
READpredict_category
Predict the best category for a product title (domain_discovery)
READget_trends
Get trending searches in the marketplace
READlist_listings
List seller's active product listings

Compatible frameworks

MCP is a protocol โ€” any framework that speaks it can mount this server.

Claude Agent SDKAnthropic
OpenAI AgentsOpenAI
Vercel AI SDKVercel
LangChainLangChain
LlamaIndexLlamaIndex
CrewAICrewAI
MastraMastra
Any MCP clientProtocol

Frequently asked questions

All credentials are encrypted at rest in an isolated vault scoped per organization. OAuth2 tokens are automatically refreshed before expiry. Your agent code never sees raw secrets โ€” it receives scoped, short-lived session tokens.
Servers โ€” Every LatAm commerce API your agent needs | CodeSpar