# Catalog CLI MCP server

> Audits Amazon catalog files and Seller Central listings for attribute, title, and bullet quality issues, with JSON output for agents.

- Repository: https://github.com/BWB03/amazon-catalog-cli
- Page: https://hostedmcp.org/servers/bwb03/amazon-catalog-cli
- Transport: stdio
- Stars: 17
- License: MIT
- Latest version: 1.0.0

## Install

### Claude Code

```sh
claude mcp add --env 'CATALOG_API_KEY=<YOUR_CATALOG_API_KEY>' amazon-catalog-cli -- npx -y @bwb03/catalog-cli-pro
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "amazon-catalog-cli": {
      "command": "npx",
      "args": [
        "-y",
        "@bwb03/catalog-cli-pro"
      ],
      "env": {
        "CATALOG_API_KEY": "<YOUR_CATALOG_API_KEY>"
      }
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "amazon-catalog-cli": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@bwb03/catalog-cli-pro"
      ],
      "env": {
        "CATALOG_API_KEY": "<YOUR_CATALOG_API_KEY>"
      }
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"amazon-catalog-cli","type":"stdio","command":"npx","args":["-y","@bwb03/catalog-cli-pro"],"env":{"CATALOG_API_KEY":"<YOUR_CATALOG_API_KEY>"}}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "amazon-catalog-cli": {
      "command": "npx",
      "args": [
        "-y",
        "@bwb03/catalog-cli-pro"
      ],
      "env": {
        "CATALOG_API_KEY": "<YOUR_CATALOG_API_KEY>"
      }
    }
  }
}
```

### Codex

```sh
codex mcp add amazon-catalog-cli --env 'CATALOG_API_KEY=<YOUR_CATALOG_API_KEY>' -- npx -y @bwb03/catalog-cli-pro
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.amazon-catalog-cli]
command = "npx"
args = ["-y", "@bwb03/catalog-cli-pro"]

[mcp_servers.amazon-catalog-cli.env]
CATALOG_API_KEY = "<YOUR_CATALOG_API_KEY>"
```

### Gemini CLI

```sh
gemini mcp add -s user -e 'CATALOG_API_KEY=<YOUR_CATALOG_API_KEY>' amazon-catalog-cli npx -- -y @bwb03/catalog-cli-pro
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "amazon-catalog-cli": {
      "command": "npx",
      "args": [
        "-y",
        "@bwb03/catalog-cli-pro"
      ],
      "env": {
        "CATALOG_API_KEY": "<YOUR_CATALOG_API_KEY>"
      }
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `CATALOG_API_KEY` | yes | yes | Your Catalog CLI Pro API key. Get one free at catalogcli.com/signup |
| `CATALOG_SELLER_CENTRAL_COOKIE` | no | no |  |

## FAQ

### How do I run a catalog audit from an AI agent?

Start the stdio MCP server with `catalog mcp` and call tools like `catalog_scan` or `catalog_check` from an MCP client such as Claude Desktop.

### What checks does Catalog CLI include?

It ships 14 built-in catalog health checks covering missing attributes, prohibited characters, bullet formatting and intent coverage, title length and mobile readiness, product type mismatches, and missing variations.

### Can it compare my live Amazon listing against my Category Listing Report?

Yes. Run `catalog listing diff <asin> <clr-file>` to compare Amazon's current listing fields against the matching CLR row.

### How does it authenticate with Seller Central?

You supply a logged-in Seller Central cookie via `--cookie`, `--cookie-file`, or the `CATALOG_SELLER_CENTRAL_COOKIE` environment variable, and the cookie stays on your machine.

### Can I get structured output for automation or CI?

Yes, use `--format json` or `--format ndjson` with optional field masks, limits, offsets, and JSON or stdin input.