mcpField
L
Listing Bureau   Amazon Organic Ranking

Listing Bureau Amazon Organic Ranking

Local
github.com/listingbureauCloud & Infra0Updated 29w ago

About Listing Bureau Amazon Organic Ranking

Listing Bureau Amazon Organic Ranking is an MCP server for managing Amazon organic ranking campaigns. It helps sellers and campaign operators schedule activity, estimate costs, and track keyword positions through an MCP client.

Key features

  1. 01Create and manage ASIN keyword projects
  2. 02Set daily campaign schedules
  3. 03Estimate campaign costs
  4. 04Track ranking and project statistics
  5. 05Review orders, wallet, and account details

Use cases

  1. 01Set up a ranking campaign for an ASIN and keyword
  2. 02Plan daily campaign volumes and costs
  3. 03Monitor keyword position changes
  4. 04Check wallet balance and order status

MCP support

Exposes Listing Bureau campaign management, scheduling, cost estimation, reporting, wallet, order, and account tools to MCP clients. It runs over stdio and requires an LB_API_KEY.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
"mcpServers": {
"listingbureau": {
"command": "npx",
"args": [
"-y",
"listingbureau-mcp"
],
"env": {
"LB_API_KEY": "<LB_API_KEY>"
}
}
}
}
Run commandnpx -y listingbureau-mcp
Environment variables to set
LB_API_KEYSecretListing Bureau API key. Create an account at listingbureau.com to get one.

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmlistingbureau-mcp0.1.11

Tools

21

Saved tool list · updated 3w ago

This tool takes no parameters.

Details

From the project README

listingbureau-mcp

npm version npm downloads MIT License GitHub stars Node.js >= 20

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.

listingbureau-mcp demo

Works
with
Claude DesktopClaude CodeCursorOpenClawAny MCP Client
If it speaks MCP, it'll replace your ranking agency.

🚀 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:

{
  "mcpServers": {
    "listingbureau": {
      "command": "npx",
      "args": ["-y", "listingbureau-mcp"],
      "env": {
        "LB_API_KEY": "your-api-key-here"
      }
    }
  }
}
Claude Code

Install the plugin from the marketplace:

/plugin install listingbureau@claude-plugins-official

This installs the MCP server + the campaign methodology skill. Set LB_API_KEY in the shell environment before starting Claude Code.

Manual setup (alternative)
claude mcp add listingbureau -e LB_API_KEY=your-api-key -- npx -y listingbureau-mcp
Cursor

Install in 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):

{
  "mcpServers": {
    "listingbureau": {
      "command": "npx",
      "args": ["-y", "listingbureau-mcp"],
      "env": {
        "LB_API_KEY": "your-api-key-here"
      }
    }
  }
}
Any MCP client

Run the server via npx and configure your client to connect over stdio:

npx -y listingbureau-mcp

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

VariableRequiredDefaultDescription
LB_API_KEYYes-Listing Bureau API key
LB_BASE_URLNohttps://listingbureau.comAPI base URL (override for staging/dev)

🔧 Tools

21 tools across 7 categories.

📂 Projects (6 tools)
ToolDescription
lb_projects_listList projects with optional region/active filters
lb_projects_createCreate a new Amazon project (ASIN + keyword + region)
lb_projects_getGet project details (schedule, services, SERP data)
lb_projects_updateUpdate project (pause/resume)
lb_projects_archiveArchive (soft delete) a project
lb_projects_get_statsGet daily stats (SFB, ATC, PGV, SERP, ARA, BR, SQR)
📅 Schedule (3 tools)
ToolDescription
lb_schedule_getGet current per-day schedule
lb_schedule_setSet full per-day schedule (replaces existing)
lb_schedule_quick_setQuick-set uniform daily volumes
💲 Cost Estimation (1 tool)
ToolDescription
lb_estimate_costEstimate campaign cost before committing. Computes total cost, daily averages, and wallet sustainability.
💰 Wallet (3 tools)
ToolDescription
lb_wallet_get_balanceGet wallet balance (credits and USD)
lb_wallet_get_transactionsGet transaction history (paginated)
lb_wallet_topupGenerate a Stripe checkout URL to top up wallet balance
📦 Orders (3 tools)
ToolDescription
lb_orders_listList orders (paginated, newest first)
lb_orders_getGet order details
lb_orders_report_issueReport an issue with an order
👤 Account (4 tools)
ToolDescription
lb_account_getGet account info (email, name, account status, wallet balance)
lb_account_update_profileUpdate profile fields (first_name, last_name, company)
lb_account_get_service_ratesGet current service pricing rates
lb_account_get_subscriptionGet subscription info (plan, fee, discount)
💬 Feedback (1 tool)
ToolDescription
lb_feedback_submitSubmit 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

npm install
npm run build
npm run dev    # watch mode
npm test

🔗 Links

📄 License

MIT

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.