Listing Bureau - Amazon Organic Ranking MCP Server

Amazon organic ranking MCP server. Run campaigns, track positions, monitor rank movement.

OtherTypeScriptv0.1.11

listingbureau-mcp

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.

Works
with
Claude Desktop Claude Code Cursor OpenClaw Any 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

Installation

Source-derived launch command. Check the maintainer’s required arguments and credentials before running:

bash
npx -y listingbureau-mcp

Set up in your AI client

Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.

json
{
  "mcpServers": {
    "io-github-listingbureau-listingbureau-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "listingbureau-mcp"
      ]
    }
  }
}

Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.

Claude Desktop setup reference

Package

listingbureau-mcpnpm

Compatible MCP Clients

Listing Bureau - Amazon Organic Ranking MCP Server works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.

  • Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.
  • Cursor~/.cursor/mcp.jsonRestart Cursor for changes to take effect.
  • VS Code.vscode/mcp.jsonReload VS Code window for changes to take effect.
  • Windsurf~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect.
  • Claude Code.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.

Learn More