{
  "markdown": "# listingbureau-mcp\n\n<a href=\"https://www.npmjs.com/package/listingbureau-mcp\"><img src=\"https://img.shields.io/npm/v/listingbureau-mcp\" alt=\"npm version\" /></a>\n<a href=\"https://www.npmjs.com/package/listingbureau-mcp\"><img src=\"https://img.shields.io/npm/dm/listingbureau-mcp\" alt=\"npm downloads\" /></a>\n<a href=\"https://github.com/listingbureau/listingbureau-mcp/blob/main/LICENSE\"><img src=\"https://img.shields.io/badge/license-MIT-blue\" alt=\"MIT License\" /></a>\n<a href=\"https://github.com/listingbureau/listingbureau-mcp/stargazers\"><img src=\"https://img.shields.io/github/stars/listingbureau/listingbureau-mcp?style=flat\" alt=\"GitHub stars\" /></a>\n<img src=\"https://img.shields.io/badge/node-%3E%3D20-brightgreen\" alt=\"Node.js >= 20\" />\n\nOrganic ranking campaigns for Amazon products, managed through your AI assistant.\n\nThe 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.\n\nBuilt on the same infrastructure associated with 1,700+ products reaching page one. Median time: 48 days. Past performance does not predict future results.\n\n<p align=\"center\">\n  <img src=\"https://raw.githubusercontent.com/listingbureau/listingbureau-mcp/main/assets/demo.gif\" alt=\"listingbureau-mcp demo\" width=\"800\" />\n</p>\n\n<div align=\"center\">\n<table>\n  <tr>\n    <td align=\"center\"><strong>Works<br/>with</strong></td>\n    <td align=\"center\"><img src=\"https://img.shields.io/badge/Claude_Desktop-black?style=for-the-badge&logo=anthropic&logoColor=white\" alt=\"Claude Desktop\" /></td>\n    <td align=\"center\"><img src=\"https://img.shields.io/badge/Claude_Code-black?style=for-the-badge&logo=anthropic&logoColor=white\" alt=\"Claude Code\" /></td>\n    <td align=\"center\"><img src=\"https://img.shields.io/badge/Cursor-black?style=for-the-badge&logo=cursor&logoColor=white\" alt=\"Cursor\" /></td>\n    <td align=\"center\"><img src=\"https://img.shields.io/badge/OpenClaw-black?style=for-the-badge\" alt=\"OpenClaw\" /></td>\n    <td align=\"center\"><img src=\"https://img.shields.io/badge/Any_MCP_Client-black?style=for-the-badge\" alt=\"Any MCP Client\" /></td>\n  </tr>\n</table>\n<em>If it speaks MCP, it'll replace your ranking agency.</em>\n</div>\n\n## 🚀 What it does\n\nThis MCP server connects your AI assistant to [Listing Bureau](https://listingbureau.com/mcp?utm_source=github&utm_medium=readme&utm_campaign=mcp)'s Amazon ranking infrastructure. Three signal types drive organic rank improvement:\n\n- **Search-Find-Buy (SFB)** signals the A10 algorithm that real shoppers searched for a keyword, found the product, and purchased it\n- **Add-to-Cart (ATC)** builds conversion intent and purchase intent signals\n- **Page Views (PGV)** generate session-level browsing behavior that supports organic discovery\n\nYour 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.\n\n## 📦 Quick start\n\n### Claude Desktop (one-click)\n\nDownload the Desktop Extension and double-click to install. Claude Desktop will prompt for your API key.\n\n**[Download listingbureau-mcp.mcpb](https://github.com/listingbureau/listingbureau-mcp/releases/latest/download/listingbureau-mcp.mcpb)** (requires Claude Desktop 4.0+)\n\n<details>\n<summary>Manual config (alternative)</summary>\n\nAdd to `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"listingbureau\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"listingbureau-mcp\"],\n      \"env\": {\n        \"LB_API_KEY\": \"your-api-key-here\"\n      }\n    }\n  }\n}\n```\n\n</details>\n\n### Claude Code\n\nInstall the plugin from the marketplace:\n\n```bash\n/plugin install listingbureau@claude-plugins-official\n```\n\nThis installs the MCP server + the campaign methodology skill. Set `LB_API_KEY` in the shell environment before starting Claude Code.\n\n<details>\n<summary>Manual setup (alternative)</summary>\n\n```bash\nclaude mcp add listingbureau -e LB_API_KEY=your-api-key -- npx -y listingbureau-mcp\n```\n\n</details>\n\n### Cursor\n\n[![Install in Cursor](https://img.shields.io/badge/Install_in-Cursor-blue?style=for-the-badge&logo=cursor&logoColor=white)](cursor://anysphere.cursor-deeplink/mcp/install?name=ListingBureau&config=eyJtY3BTZXJ2ZXJzIjp7Imxpc3RpbmdidXJlYXUiOnsiY29tbWFuZCI6Im5weCIsImFyZ3MiOlsiLXkiLCJsaXN0aW5nYnVyZWF1LW1jcCJdLCJlbnYiOnsiTEJfQVBJX0tFWSI6InlvdXItYXBpLWtleS1oZXJlIn19fX0=)\n\nAfter clicking, replace `your-api-key-here` with the actual API key in the dialog before confirming.\n\n<details>\n<summary>Manual config (alternative)</summary>\n\nAdd to `.cursor/mcp.json` (project-scoped) or `~/.cursor/mcp.json` (global):\n\n```json\n{\n  \"mcpServers\": {\n    \"listingbureau\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"listingbureau-mcp\"],\n      \"env\": {\n        \"LB_API_KEY\": \"your-api-key-here\"\n      }\n    }\n  }\n}\n```\n\n</details>\n\n### Any MCP client\n\nRun the server via npx and configure your client to connect over stdio:\n\n```bash\nnpx -y listingbureau-mcp\n```\n\nSet `LB_API_KEY` as an environment variable. See the [MCP specification](https://modelcontextprotocol.io) for client-specific config.\n\n### 🔑 Get an API key\n\nCreate an account at [listingbureau.com](https://listingbureau.com/mcp?utm_source=github&utm_medium=readme&utm_campaign=mcp-signup). Your API key is in the dashboard under Settings.\n\n## ⚙️ Environment variables\n\n| Variable | Required | Default | Description |\n|----------|----------|---------|-------------|\n| `LB_API_KEY` | Yes | - | Listing Bureau API key |\n| `LB_BASE_URL` | No | `https://listingbureau.com` | API base URL (override for staging/dev) |\n\n## 🔧 Tools\n\n21 tools across 7 categories.\n\n### 📂 Projects (6 tools)\n\n| Tool | Description |\n|------|-------------|\n| `lb_projects_list` | List projects with optional region/active filters |\n| `lb_projects_create` | Create a new Amazon project (ASIN + keyword + region) |\n| `lb_projects_get` | Get project details (schedule, services, SERP data) |\n| `lb_projects_update` | Update project (pause/resume) |\n| `lb_projects_archive` | Archive (soft delete) a project |\n| `lb_projects_get_stats` | Get daily stats (SFB, ATC, PGV, SERP, ARA, BR, SQR) |\n\n### 📅 Schedule (3 tools)\n\n| Tool | Description |\n|------|-------------|\n| `lb_schedule_get` | Get current per-day schedule |\n| `lb_schedule_set` | Set full per-day schedule (replaces existing) |\n| `lb_schedule_quick_set` | Quick-set uniform daily volumes |\n\n### 💲 Cost Estimation (1 tool)\n\n| Tool | Description |\n|------|-------------|\n| `lb_estimate_cost` | Estimate campaign cost before committing. Computes total cost, daily averages, and wallet sustainability. |\n\n### 💰 Wallet (3 tools)\n\n| Tool | Description |\n|------|-------------|\n| `lb_wallet_get_balance` | Get wallet balance (credits and USD) |\n| `lb_wallet_get_transactions` | Get transaction history (paginated) |\n| `lb_wallet_topup` | Generate a Stripe checkout URL to top up wallet balance |\n\n### 📦 Orders (3 tools)\n\n| Tool | Description |\n|------|-------------|\n| `lb_orders_list` | List orders (paginated, newest first) |\n| `lb_orders_get` | Get order details |\n| `lb_orders_report_issue` | Report an issue with an order |\n\n### 👤 Account (4 tools)\n\n| Tool | Description |\n|------|-------------|\n| `lb_account_get` | Get account info (email, name, account status, wallet balance) |\n| `lb_account_update_profile` | Update profile fields (first_name, last_name, company) |\n| `lb_account_get_service_rates` | Get current service pricing rates |\n| `lb_account_get_subscription` | Get subscription info (plan, fee, discount) |\n\n### 💬 Feedback (1 tool)\n\n| Tool | Description |\n|------|-------------|\n| `lb_feedback_submit` | Submit feedback, feature requests, or suggestions (10-5000 characters) |\n\n## 🧠 Campaign methodology skill\n\nThe MCP server ships with a companion skill at [`skills/amazon-product-ranking/`](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.\n\n**Claude Code (plugin):** The Claude Code plugin includes the skill automatically. Install via `/plugin install listingbureau@claude-plugins-official`.\n\n**Claude Code (manual):** Copy or symlink the `skills/amazon-product-ranking/` folder into your `.claude/skills/` directory.\n\n**Other platforms:** The server instructions reference the skill automatically. The AI can read the methodology from the GitHub link included in the instructions.\n\n## 🛠️ Development\n\n```bash\nnpm install\nnpm run build\nnpm run dev    # watch mode\nnpm test\n```\n\n## 🔗 Links\n\n- [Landing page](https://listingbureau.com/mcp?utm_source=github&utm_medium=readme&utm_campaign=mcp-links)\n- [Create an account](https://listingbureau.com/auth/signup?utm_source=github&utm_medium=readme&utm_campaign=mcp-links-signup)\n\n## 📄 License\n\nMIT\n",
  "bytes": 8959,
  "sha": "989af2f69f670bae09f1332bd6da96114481d1ed2ce62d7d3b12576b4a26dadd",
  "repo_slug": "listingbureau/listingbureau-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_listingbureau_listingbureau_mcp_listing__558c0366/readme"
}