Listing Bureau Amazon Organic Ranking MCP Server README
The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the Listing Bureau Amazon Organic Ranking MCP Server listing page.
listingbureau-mcp
Organic ranking campaigns for Amazon products, managed through your AI assistant.
The only ranking-focused Amazon MCP server. Create ranking campaigns, set campaign schedules, track keyword positions, and monitor rank movement from Claude, Cursor, or any MCP-compatible client.
Built on the same infrastructure associated with 1,700+ products reaching page one. Median time: 48 days. Past performance does not predict future results.
| Works with |  |  |  |  |  |
🚀 What it does
This MCP server connects your AI assistant to Listing Bureau's Amazon ranking infrastructure. Three signal types drive organic rank improvement:
- Search-Find-Buy (SFB) signals the A10 algorithm that real shoppers searched for a keyword, found the product, and purchased it
- Add-to-Cart (ATC) builds conversion intent and purchase intent signals
- Page Views (PGV) generate session-level browsing behavior that supports organic discovery
Your assistant handles the entire workflow: create a project for any ASIN and keyword, set a daily campaign schedule, estimate costs before committing, and pull position reports to track movement.
📦 Quick start
Claude Desktop (one-click)
Download the Desktop Extension and double-click to install. Claude Desktop will prompt for your API key.
Download listingbureau-mcp.mcpb (requires Claude Desktop 4.0+)
Manual config (alternative)
Add to claude_desktop_config.json:
Claude Code
Install the plugin from the marketplace:
This installs the MCP server + the campaign methodology skill. Set LB_API_KEY in the shell environment before starting Claude Code.
Manual setup (alternative)
Cursor
After clicking, replace your-api-key-here with the actual API key in the dialog before confirming.
Manual config (alternative)
Add to .cursor/mcp.json (project-scoped) or ~/.cursor/mcp.json (global):
Any MCP client
Run the server via npx and configure your client to connect over stdio:
Set LB_API_KEY as an environment variable. See the MCP specification for client-specific config.
🔑 Get an API key
Create an account at listingbureau.com. Your API key is in the dashboard under Settings.
⚙️ Environment variables
| Variable | Required | Default | Description |
|---|---|---|---|
LB_API_KEY | Yes | - | Listing Bureau API key |
LB_BASE_URL | No | https://listingbureau.com | API base URL (override for staging/dev) |
🔧 Tools
21 tools across 7 categories.
📂 Projects (6 tools)
| Tool | Description |
|---|---|
lb_projects_list | List projects with optional region/active filters |
lb_projects_create | Create a new Amazon project (ASIN + keyword + region) |
lb_projects_get | Get project details (schedule, services, SERP data) |
lb_projects_update | Update project (pause/resume) |
lb_projects_archive | Archive (soft delete) a project |
lb_projects_get_stats | Get daily stats (SFB, ATC, PGV, SERP, ARA, BR, SQR) |
📅 Schedule (3 tools)
| Tool | Description |
|---|---|
lb_schedule_get | Get current per-day schedule |
lb_schedule_set | Set full per-day schedule (replaces existing) |
lb_schedule_quick_set | Quick-set uniform daily volumes |
💲 Cost Estimation (1 tool)
| Tool | Description |
|---|---|
lb_estimate_cost | Estimate campaign cost before committing. Computes total cost, daily averages, and wallet sustainability. |
💰 Wallet (3 tools)
| Tool | Description |
|---|---|
lb_wallet_get_balance | Get wallet balance (credits and USD) |
lb_wallet_get_transactions | Get transaction history (paginated) |
lb_wallet_topup | Generate a Stripe checkout URL to top up wallet balance |
📦 Orders (3 tools)
| Tool | Description |
|---|---|
lb_orders_list | List orders (paginated, newest first) |
lb_orders_get | Get order details |
lb_orders_report_issue | Report an issue with an order |
👤 Account (4 tools)
| Tool | Description |
|---|---|
lb_account_get | Get account info (email, name, account status, wallet balance) |
lb_account_update_profile | Update profile fields (first_name, last_name, company) |
lb_account_get_service_rates | Get current service pricing rates |
lb_account_get_subscription | Get subscription info (plan, fee, discount) |
💬 Feedback (1 tool)
| Tool | Description |
|---|---|
lb_feedback_submit | Submit feedback, feature requests, or suggestions (10-5000 characters) |
🧠 Campaign methodology skill
The MCP server ships with a companion skill at skills/amazon-product-ranking/ that provides a guided 9-phase campaign workflow. The skill teaches the AI how to use the tools effectively: product assessment, competition analysis, funnel profile selection, ramp schedules, cost/ROI projections, execution, and monitoring.
Claude Code (plugin): The Claude Code plugin includes the skill automatically. Install via /plugin install listingbureau@claude-plugins-official.
Claude Code (manual): Copy or symlink the skills/amazon-product-ranking/ folder into your .claude/skills/ directory.
Other platforms: The server instructions reference the skill automatically. The AI can read the methodology from the GitHub link included in the instructions.
🛠️ Development
🔗 Links
📄 License
MIT