Rally

The first Model Context Protocol (MCP) server for Mercado Libre & Shopee affiliates.

Built by André Hocsis — Creator of Rally de Vendas, the leading AI-powered platform for Brazilian e-commerce sellers and affiliates.

---

What is this?

An MCP server that gives AI assistants (Claude, ChatGPT, Cursor, etc.) direct access to marketplace affiliate tools:

• Search products on Mercado Libre and Shopee with commission estimates
• Generate affiliate links with tracking
• Analyze products (quality score 0-100, photos, title, price competitiveness)
• Generate marketing copy for TikTok, Reels, WhatsApp, Telegram, Blog
• Check trending products by category and season

Why?

Mercado Libre has no affiliate API. Shopee's API is complex. This MCP server abstracts both into a simple, unified interface that any AI agent can use.

Quick Start

# Install
npm install @rally-vendas/mcp-server

# Or run directly
npx @rally-vendas/mcp-server

Claude Desktop Configuration

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "rally-affiliates": {
      "command": "npx",
      "args": ["@rally-vendas/mcp-server"],
      "env": {
        "ML_AFFILIATE_ID": "your_matt_tool_id",
        "SHOPEE_APP_ID": "your_app_id",
        "SHOPEE_SECRET": "your_secret"
      }
    }
  }
}

Available Tools

search_products

Search products across marketplaces with affiliate commission estimates.

{
  "marketplace": "mercadolibre",
  "query": "fone bluetooth",
  "category": "MLB1051",
  "sort": "relevance",
  "limit": 20
}

Returns: Product list with title, price, image, commission rate, estimated earnings, affiliate link.

generate_affiliate_link

Generate a tracked affiliate link for any product.

{
  "marketplace": "mercadolibre",
  "product_url": "https://www.mercadolivre.com.br/produto-xyz/p/MLB12345",
  "campaign": "tiktok_maio"
}

Returns: Affiliate URL with tracking parameters.

analyze_product

Get a quality score (0-100) for any marketplace product.

{
  "marketplace": "mercadolibre",
  "product_id": "MLB12345"
}

Returns: Score breakdown (title, photos, description, attributes, price), problems found, improvement suggestions.

generate_copy

AI-powered marketing copy for any channel.

{
  "product_id": "MLB12345",
  "channel": "tiktok",
  "tone": "casual",
  "language": "pt-BR"
}

Returns: Ready-to-post copy with hashtags, emojis, and CTA.

trending_products

Get trending products by category with commission data.

{
  "marketplace": "mercadolibre",
  "category": "MLB1051",
  "period": "7d"
}

Returns: Top products by sales velocity, with commission estimates.

commission_calculator

Calculate expected earnings for a product.

{
  "marketplace": "mercadolibre",
  "product_id": "MLB12345",
  "estimated_daily_clicks": 50,
  "conversion_rate": 0.02
}

Returns: Daily/monthly/yearly estimated commission in BRL.

Supported Marketplaces

Marketplace	Search	Links	Analytics	Reports
Mercado Libre (Brazil)	✅	✅ (matt_tool)	✅ (Raio-X)	Estimated
Shopee (Brazil)	✅	✅ (API)	✅	✅ Real-time
Amazon (coming soon)	⏳	⏳	⏳	⏳

Architecture

rally-mcp-server/
├── src/
│   ├── index.ts              — MCP server entry point
│   ├── tools/
│   │   ├── search.ts         — Product search (ML + Shopee)
│   │   ├── links.ts          — Affiliate link generation
│   │   ├── analyze.ts        — Product analysis (Raio-X)
│   │   ├── copy.ts           — AI copy generation
│   │   └── trending.ts       — Trending products
│   ├── adapters/
│   │   ├── mercadolibre.ts   — ML API adapter
│   │   └── shopee.ts         — Shopee API adapter
│   └── utils/
│       ├── commission.ts     — Commission calculator
│       └── cache.ts          — Request caching
├── package.json
├── tsconfig.json
└── README.md

Built With

• Model Context Protocol SDK — Anthropic's MCP
• Mercado Libre API — Product data
• Shopee Affiliate API — Affiliate operations

About Rally de Vendas

Rally de Vendas is a Brazilian AI-powered e-commerce platform that helps:

• Sellers: Manage Mercado Libre listings with AI optimization, Raio-X diagnostics, bulk management
• Affiliates: Discover products, generate tracked links, create content with AI, automate WhatsApp/Telegram
• Agencies: Multi-account management, centralized inbox, dynamic pricing

500+ routes · 90+ controllers · AI-powered (Claude + Gemini) · ISO 9001 + 27001 compliant

Author

André Hocsis — E-commerce specialist, AI developer, creator of Rally de Vendas.

• Website: andrehocsis.com.br
• Platform: rallydevendas.com.br
• Affiliates: afiliados.rallydevendas.com.br

License

MIT — Free to use, modify, and distribute. Attribution appreciated.

---

⭐ Star this repo if you find it useful! First MCP server for marketplace affiliates in Brazil.