{
"markdown": "\n\n# ๐ Lumnix\n\n**AI-powered e-commerce research tools via MCP**\n\nStop paying for three different SaaS dashboards. Ask your AI to find winning products, vet suppliers, and calculate margins โ all in one conversation.\n\n[](https://www.npmjs.com/package/lumnix)\n[](https://opensource.org/licenses/MIT)\n[](https://modelcontextprotocol.io)\n[](https://keepa.com)\n\n```bash\nnpm install lumnix\n```\n\n[Get API Key](https://lumnix.dev) ยท [Documentation](#-tools-reference) ยท [npm Package](https://www.npmjs.com/package/lumnix)\n\n
\n\n---\n\n## ๐ฌ Demos\n\n\n\n**Explainer** โ What Lumnix does:\n\nhttps://github.com/user-attachments/assets/388cad8a-948d-4921-9945-fd5d5e618b9c\n\n**Live Demo** โ Real research session:\n\nhttps://github.com/user-attachments/assets/dd76f1df-18ff-492a-b9ac-0ae2d6d69815\n\n
\n\n---\n\n## Why Lumnix\n\n**The old way:** Subscribe to Jungle Scout for product research ($49/mo), Keepa for price history ($50/mo), some Chrome extension for Alibaba vetting ($20/mo), and a spreadsheet for margin math. Switch between tabs all day. Miss opportunities.\n\n**The Lumnix way:** One API key. 19 tools. In your AI assistant. No dashboards. No Chrome extensions. No tab-hopping.\n\n> *\"Find me wireless earbuds under $20 with high sales volume, low reviews, and a supplier on Alibaba with MOQ under 500\"*\n\nYour AI calls Lumnix. You get structured data with revenue estimates, competition analysis, and profit margins. You decide. Done.\n\n### What makes it different\n\n- **๐ซ No dashboards** โ Works inside Claude, Cursor, Windsurf, Cline, or any MCP client\n- **๐ Keepa-powered** โ Real price history and BSR tracking, not estimates\n- **๐ฏ Opportunity Score** โ 0-100 niche score based on demand, competition, and margin potential\n- **๐ญ Full sourcing pipeline** โ Amazon โ Alibaba โ AliExpress, all connected\n- **๐ฐ Profit calculator** โ Full P&L with FBA fees, shipping, PPC ads, refunds, and ROI\n- **โก 30-second setup** โ No install. No config file editing. Just an API key and one JSON block\n\n---\n\n## โก Quick Start\n\n### 1. Get an API key (free)\n\nSign up at [lumnix.dev](https://lumnix.dev) โ no credit card required. Get your key in 30 seconds.\n\n### 2. Add to your MCP client\n\n**Claude Desktop** โ edit `~/Library/Application Support/Claude/claude_desktop_config.json`:\n\n```json\n{\n \"mcpServers\": {\n \"lumnix\": {\n \"command\": \"npx\",\n \"args\": [\n \"mcp-remote\",\n \"https://lumnix.dev/api/mcp\",\n \"--header\",\n \"Authorization: Bearer YOUR_API_KEY\"\n ]\n }\n }\n}\n```\n\n> โ ๏ธ Claude Desktop doesn't support remote MCP URLs natively. The `mcp-remote` bridge (auto-installed by npx) makes it work. Requires Node.js installed.\n\n**Cursor** โ Settings โ MCP โ Add new global MCP server:\n\n```json\n{\n \"mcpServers\": {\n \"lumnix\": {\n \"url\": \"https://lumnix.dev/api/mcp\",\n \"headers\": {\n \"Authorization\": \"Bearer YOUR_API_KEY\"\n }\n }\n }\n}\n```\n\n**Windsurf / Cline / any MCP client** โ same pattern as Cursor. URL + Bearer token header.\n\n### 3. Start researching\n\nRestart your AI client. Then just talk naturally:\n\n> *\"Search Amazon for portable blenders with high sales and low reviews\"*\n\nThat's it. No Docker. No config files to debug.\n\n---\n\n## ๐ Tools Reference\n\nLumnix gives your AI **19 specialized tools** across three platforms:\n\n### Amazon โ 11 tools\n\n| Tool | What it does |\n|------|-------------|\n| `amazon_search_products` | Search by keyword with price, rating, and review filters |\n| `amazon_get_product_details` | Full product page โ features, specs, reviews, images, category |\n| `amazon_estimate_sales` | Monthly sales volume with confidence range |\n| `amazon_opportunity_score` | **โญ 0-100 niche score** โ demand, competition, margin potential |\n| `amazon_analyze_competition` | Top players, review counts, price ranges for a keyword |\n| `amazon_best_sellers` | Best-selling products by category with sales data |\n| `amazon_keyword_suggestions` | Amazon autocomplete keywords with search frequency |\n| `amazon_price_history` | **๐ Keepa-powered** โ historical price chart |\n| `amazon_bsr_history` | **๐ Keepa-powered** โ Best Sellers Rank trend over time |\n| `amazon_analyze_negative_reviews` | Complaint categories, sentiment breakdown, common issues |\n| `amazon_analyze_listing_quality` | CTR + CVR scoring with specific improvement suggestions |\n\n### Alibaba โ 4 tools\n\n| Tool | What it does |\n|------|-------------|\n| `alibaba_search_products` | Search suppliers and products with MOQ and price filters |\n| `alibaba_get_product_details` | Pricing tiers, specs, variants, supplier credentials |\n| `alibaba_vet_supplier` | **Trust score, risk flags, verification status** โ avoid bad suppliers |\n| `alibaba_match_to_amazon` | Match Alibaba products to Amazon listings for FBA arbitrage |\n\n### AliExpress โ 4 tools\n\n| Tool | What it does |\n|------|-------------|\n| `aliexpress_search_products` | Search with price, rating, and store filters |\n| `aliexpress_get_product_details` | Variants, specs, shipping options, store ratings |\n| `aliexpress_analyze_supplier` | Store score, feedback rate, top-rated status |\n| `aliexpress_profit_calculator` | **๐ฐ Full P&L** โ product cost, shipping, FBA fees, PPC, refunds, ROI |\n\n---\n\n## ๐ฌ Example Prompts\n\n**Product Research**\n> \"Search Amazon for stainless steel water bottles between $15-30 with at least 4 stars and under 1000 reviews\"\n\n**Opportunity Scoring**\n> \"Score the 'portable blender' niche on Amazon. Is it worth entering?\"\n\n**Competition Analysis**\n> \"Analyze the competition for 'organic dog treats'. How many sellers have less than 500 reviews?\"\n\n**Keepa Price History**\n> \"Show me the price history for ASIN B0FHWKYT89. Has it been trending down?\"\n\n**Supplier Vetting**\n> \"Find aluminum water bottle suppliers on Alibaba with trust score above 70 and MOQ under 500\"\n\n**Margin Calculation**\n> \"I want to sell this AliExpress product on Amazon for $29.99. Calculate my profit margin including FBA fees, PPC ads at 15%, and 5% refund rate\"\n\n**Full Workflow**\n> \"Find a product on Amazon with high sales volume and low reviews, find the matching supplier on Alibaba, vet them, and tell me if the margins work\"\n\n---\n\n## ๐ Example Response\n\n```json\n{\n \"asin\": \"B0FHWKYT89\",\n \"title\": \"Portable Blender for Shakes and Smoothies\",\n \"price\": \"$29.99\",\n \"rating\": 4.5,\n \"reviews\": 2847,\n \"sales_volume\": \"5K+ bought in past month\",\n \"monthly_revenue_est\": \"$149,950\",\n \"is_amazon_choice\": true,\n \"is_prime\": true,\n \"number_of_offers\": 12\n}\n```\n\n---\n\n## ๐ฐ Plans\n\n| | Free | Pro | Business |\n|---|---|---|---|\n| **Price** | $0 | $29/mo | $99/mo |\n| **API calls** | 10/month | 5,000/month | 25,000/month |\n| **Platforms** | Amazon only | Amazon + Alibaba + AliExpress | Amazon + Alibaba + AliExpress |\n| **Tools** | Search, details, keywords | **All 19** including Keepa | **All 19** including Keepa |\n| **API keys** | 2 | 5 | 20 |\n| **Keepa price history** | โ | โ
| โ
|\n| **Opportunity score** | โ | โ
| โ
|\n| **Supplier vetting** | โ | โ
| โ
|\n| **Profit calculator** | โ | โ
| โ
|\n\nThe free tier gives you 3 Amazon search tools โ enough to see the data quality. When you're ready for Keepa-powered insights, opportunity scoring, and full sourcing across all platforms, [upgrade here](https://lumnix.dev).\n\n---\n\n## ๐ง API Reference\n\nLumnix is a **remote MCP server**. No installation, no Docker, no local dependencies.\n\n**Endpoint:** `https://lumnix.dev/api/mcp`\n**Auth:** Bearer token in the Authorization header\n**Protocol:** JSON-RPC 2.0 (MCP spec `2025-03-26`)\n\n### Direct API call\n\n```bash\ncurl -X POST https://lumnix.dev/api/mcp \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: Bearer YOUR_API_KEY\" \\\n -d '{\n \"jsonrpc\": \"2.0\",\n \"id\": 1,\n \"method\": \"tools/call\",\n \"params\": {\n \"name\": \"amazon_search_products\",\n \"arguments\": { \"keyword\": \"wireless earbuds\", \"max_price\": 50 }\n }\n }'\n```\n\n---\n\n## ๐ Find Us On\n\nLumnix is listed on all major MCP directories:\n\n- [**Smithery.ai**](https://smithery.ai) โ Search \"lumnix\"\n- [**MCP Servers**](https://mcpservers.org) โ Search \"lumnix\"\n- [**Claude MCP Directory**](https://docs.anthropic.com/en/docs/agents-and-tools/mcp) โ Coming soon\n- [**npm**](https://www.npmjs.com/package/lumnix) โ `npm install lumnix` ยท `npm info lumnix`\n\n---\n\n## โ FAQ\n\n**What MCP clients work with Lumnix?**\nAny client that supports remote MCP servers with HTTP transport: Claude Desktop, Cursor, Windsurf, Cline, VS Code (with MCP extension), and more.\n\n**Is the free tier really free?**\nYes. 10 API calls/month, no credit card. Enough to search products and see the data quality before committing.\n\n**Where does the data come from?**\nAmazon data via web APIs + [Keepa](https://keepa.com) (for price/BSR history). Alibaba and AliExpress via their respective platforms. All structured, enriched, and ready to act on.\n\n**How fast are the responses?**\nMost tools respond in 1-5 seconds. Deep analysis tools (competition, reviews, opportunity score) can take up to 15 seconds.\n\n**Can I use Lumnix in my own app?**\nYes. The REST API works with any HTTP client. Call the MCP endpoint directly with your API key โ no AI assistant required.\n\n**Do I need to install anything?**\nNo. Lumnix is a remote server. Just add the config to your MCP client and go.\n\n---\n\n## ๐ Security\n\n- API keys hashed with SHA-256 โ never stored in plaintext\n- Row-level security on all database tables\n- Per-platform rate limiting\n- Webhook signature verification for all payment events\n\n---\n\n## ๐ License\n\nMIT\n\n---\n\n\n\n**Built by [Molt Studios](https://moltstudios.com)**\n\n[Website](https://lumnix.dev) ยท [Twitter](https://twitter.com/lumnix_dev)\n\n
\n",
"bytes": 9931,
"sha": "3cc8677c793b63bae10ce2970d79db7b7a5b2ba73a6dee36f0b0fcde0e9b316c",
"repo_slug": "moltstudios/lumnix-mcp",
"fonte": "repo",
"truncated": false,
"api": "https://agentalog.com/api/listings/mcp_io_github_moltstudios_lumnix_7f4db023/readme"
}