TrueMargin MCP Server
Provides Amazon FBA US unit-economics audits for cross-border SKUs, including landed COGS, platform fees, margin waterfall, break-even ROAS, and GO/CAUTION/KILL verdicts.
Provides Shopify DTC unit-economics audits for cross-border SKUs, including landed COGS, platform fees, margin waterfall, break-even ROAS, and GO/CAUTION/KILL verdicts.
Provides TikTok Shop US unit-economics audits for cross-border SKUs, including affiliate commissions, refund/RTO impact, freight surcharges, margin waterfall, break-even ROAS, and GO/CAUTION/KILL verdicts.
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.
⚖️ TrueMargin MCP Server (truemargin-mcp)
Zero-dependency Model Context Protocol (MCP) server for cross-border e-commerce unit economics & 1688 primary factory sourcing.
Give Claude Desktop, Cursor, Windsurf, Cline, and n8n AI Agents instant access to real landed-COGS calculations, GBK-encoded 1688 factory search links, sensitive-cargo air/sea DDP freight surcharges, and TikTok Shop / Amazon FBA / Shopify DTC net contribution margins.
🌐 No-Login Interactive Web Calculator & 200-SKU Bulk CSV Pro Suite: https://truemargin.aitruelabs.com 🕷️ Cloud Batch API on Apify Store: aitruelabs/truemargin-1688-profit-scout
Why Sellers & Sourcing Agents Need This
Escape the 1688 Middleman Trap: Literal Google Translate queries on 1688.com route foreign buyers to Yiwu/Taobao trading companies (
商行/电子商务, +30–40% markup) instead of Shenzhen/Dongguan/Ningbo primary plants (源头工厂/实业). Plus, 1688's native search endpoint requires GBK-encoded byte URLs.Expose the "TikTok Shop GMV Illusion": Buying an item for ¥20 ($2.80) and selling it for $24.99 looks profitable—until battery/magnetic sensitive-line freight (+30%), 6.5% tariff buffer, 6% platform referral, 15% creator affiliate cut, and 14% impulse refund RTO bleed wipe out your margin.
100% Pure Python Stdlib: Zero third-party packages required (
dependencies = []). Starts in<100msviauvxorpython3.
Related MCP server: AMZ Vault
Quick Start (Claude Desktop / Cursor / Windsurf)
Option A: Zero-Install via uvx (Recommended)
Add this to your claude_desktop_config.json or .cursor/mcp.json:
{
"mcpServers": {
"truemargin-1688-scout": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/yixuanrobot/truemargin-mcp",
"truemargin-mcp"
]
}
}
}Option B: Clone & Run Directly with python3
git clone https://github.com/yixuanrobot/truemargin-mcp.git{
"mcpServers": {
"truemargin-1688-scout": {
"command": "python3",
"args": ["-m", "truemargin_mcp"],
"cwd": "/path/to/truemargin-mcp"
}
}
}Exposed MCP Tools
1. audit_crossborder_sku_margin
Audits one or more SKUs (Title | RetailUSD | WeightGrams | OptionalFactoryCNY or product URLs) across tiktok_shop_us, amazon_fba_us, or shopify_dtc.
Example Prompt in Claude / Cursor:
"Use TrueMargin to audit
Magnetic POV Neck Phone Holder | 27.99 | 260gandCheap Pet Hair Roller | 12.99 | 240gon TikTok Shop US with 15% affiliate commission and air packet shipping. Tell me which one to kill."
Returned Structured Fields:
verdict:GO/CAUTION/KILLchineseFactoryQuery&direct1688SearchUrl(GBK-encoded)industrialBelt(e.g., Shenzhen / Dongguan 3C Magnetic & Silicone Mold Cluster)cargoSensitivity:GENERAL|BATTERY_MAGNETIC|LIQUID_COSMETIC|BULKY_VOLUMETRICmarginWaterfall: Full line-by-line USD breakdown +breakEvenRoasverifiedFactories: Primary manufacturer benchmarks filtered by B2B repurchase rate (回头率)
2. translate_1688_factory_query
Instantly maps an English SKU title into native industrial-cluster Mandarin factory keywords, QC inspection gates, and a clickable GBK-encoded 1688 search link.
Need Bulk CSV Exports, Visual Waterfalls, or Team Access?
Interactive Web App & Pro Bulk CSV Suite: https://truemargin.aitruelabs.com
Hosted Cloud Actor (Webhook / n8n / Make): https://apify.com/aitruelabs/truemargin-1688-profit-scout
License
MIT © AI True Labs (support@aitruelabs.com)
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
Landed cost, fees & profit calculators for cross-border Amazon, TikTok Shop and Shopify sellers.
Read-only Amazon profit, fee, ACoS, and geo-holdout MCP tools for Claude, ChatGPT, and agents.
Connects Amazon Seller Central and Amazon Advertising to any MCP client. Settlement-accurate P&L - every fee, refund and reimbursement as Amazon posted it - plus contribution margin and breakeven per product, per marketplace, per day. Full Sponsored Products, Brands and Display management: search terms, placements, keyword and competitor research, dayparting, automation rules. 110 tools: 78 read-only (P&L, PPC at every grain, SQP/Brand Analytics, inventory, forecasting), 28 staged writes (every change is a proposal you review and confirm before it reaches Amazon - there is no autonomous-write mode), and 4 confirmation & support tools. 4 additional AI Workforce tools appear once a client is connected.
Ecommerce data MCP: Amazon, TikTok Shop, Walmart, Temu, Ozon, Shopee, 1688, Etsy, eBay & more
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceAI-powered e-commerce research tools via MCP. Search Amazon, Alibaba & AliExpress for winning products, vet suppliers, and calculate FBA margins. 19 tools, free tier available.40 npm5MIT
- AlicenseNot gradedqualityCmaintenanceConnects Amazon Seller Central and Amazon Advertising to any MCP client, with a settlement-accurate P&L underneath: every fee, refund and reimbursement as Amazon actually posted it, so contribution margin and breakeven are per product, per marketplace, per day. 107 tools spanning P&L, full Sponsored Products/Brands/Display management, Search Query Performance and Brand Analytics, inventory and for1MIT
- AlicenseBqualityCmaintenanceEnables AI agents to calculate Etsy, eBay, and Stripe fees, compare platform fees, and analyze profit margins through MCP tools.141MIT
- AlicenseAqualityBmaintenanceEnables querying Amazon bestseller ranks and reviews, confirmed eBay sold prices, TikTok Shop sales estimates, and Etsy shop/search sales signals through hosted or local MCP tools.61MIT