home / mcp / shopee agentic mcp server
A lightweight, autonomous MCP server bridging AI agents with Shopee APIs for real-time product search and category lookups.
Configuration
View docs{
"mcpServers": {
"pedroguilhermesilv-mcp-shopee": {
"url": "http://localhost:8002/sse",
"headers": {
"SHOPEE_APP_ID": "your_app_id",
"SHOPEE_SECRET": "your_secret_here"
}
}
}
}You are deploying a lightweight, autonomous MCP server that acts as a real-time integration bridge between AI agents and the Shopee platform. It exposes Shopee Affiliate API and Seller Center interactions as tools, enabling agents to search products, filter by commission, and query categories directly within conversations.
You will run the MCP server and connect it to an MCP client or orchestrator. The server provides two tools: search_shopee_products to query the Shopee catalog with filters like keyword and category_id and with sorting options including highest commission, and search_shopee_categories to map keywords to official global categories and retrieve exact category IDs for product searches. Use the SSE endpoint for real-time, agent-to-agent communication.
Prerequisites: Install Python and Poetry. Ensure you can run Python and have Poetry available in your shell.
poetry installConfigure your Shopee API credentials by creating a .env file at the project root with your Shopee OpenAPI credentials.
SHOPEE_APP_ID=your_app_id
SHOPEE_SECRET=your_secret_hereStart the server locally using the Server-Sent Events (SSE) protocol. The server binds to port 8002 and exposes the MCP endpoint for tools at the SSE URL.
make dev
# or equivalently
poetry run python mcp_server.py sse 8002Query the Shopee catalog with filters by keyword and category_id, and sort by relevance, best sellers, price, or commission. Returns detailed product data including images, price, sales volume, rating, and affiliate links.
Resolve keywords to official global categories to obtain exact category IDs for product searches.