# Catalog Machine MCP by usefulapi

> Catalog Machine MCP by usefulapi is an MCP server. Read products, orders and catalogs; update products and rebuild catalog PDFs in Catalog Machine. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/catalog-machine/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/catalog-machine
- **MCP Registry name:** io.usefulapi/catalog-machine
- **Listing updated:** 2026-11-13

## About

Read products, orders and catalogs; update products and rebuild catalog PDFs in Catalog Machine.

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http catalog-machine https://catalog-machine.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://catalog-machine.usefulapi.io/mcp
```

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

```json
{
  "mcpServers": {
    "catalog-machine": {
      "url": "https://catalog-machine.usefulapi.io/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "catalog-machine": {
      "type": "http",
      "url": "https://catalog-machine.usefulapi.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "catalog-machine": {
      "serverUrl": "https://catalog-machine.usefulapi.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "catalog-machine": {
      "type": "http",
      "url": "https://catalog-machine.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `catalogmachine_list_products`: List products with all fields, variants and collections. Filter by category or collection. Catalog Machine API: GET /products.
- `catalogmachine_get_product`: Get one product by its Code, with all fields and variants. Catalog Machine API: GET /products/{code}.
- `catalogmachine_update_product`: WRITE. Change fields of one product. The tool reads the product, merges your `fields` over it, and sends the full record back (the API needs the whole structure). Top-level keys only, for example Name, Price, Description. Variants and Collections replace the old list if you pass them. Catalog Machine API: GET then POST /products/{code}.
- `catalogmachine_list_categories`: List product categories with their field definitions. Catalog Machine API: GET /categories.
- `catalogmachine_list_orders`: List orders (open orders by default), with customer and line items. Filter by status. Catalog Machine API: GET /orders.
- `catalogmachine_list_catalogs`: List catalogs with permalink, status, privacy and the HTML and PDF links. Catalog Machine API: GET /catalogs.
- `catalogmachine_rebuild_catalog`: WRITE. Start a rebuild of the catalog PDF by permalink. Returns a JobId: check it with catalogmachine_get_catalog_job. Catalog Machine API: GET /catalogs/{permalink}/rebuild.
- `catalogmachine_get_catalog_job`: Get the status, errors and warnings of a catalog rebuild job. Catalog Machine API: GET /jobs/catalogs/{jobId}.
- `catalogmachine_get_import_job`: Get the status of the last Shopify import job (`shopify`) or CSV import job (`csv`). Catalog Machine API: GET /jobs/import/shopify-import or /jobs/import/csv-import.

## FAQ

### How do I add Catalog Machine MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http catalog-machine https://catalog-machine.usefulapi.io/mcp

---
Source: https://ai-powered.com/mcp/catalog-machine-mcp-by-usefulapi
