# PlainByte Shopify Variant Metafields CSV Validator

> PlainByte Shopify Variant Metafields CSV Validator is a paid MCP server for files and documents. Validates Shopify variant metafield CSV files and plans GraphQL batches without touching. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Paid
- **Platforms:** API, Web
- **Website:** https://apify.com/ministrant_ram/shopify-variant-metafields-planner
- **MCP Registry name:** io.github.plainbyte-tools/shopify-variant-metafields-planner
- **Categories:** [files and documents](https://ai-powered.com/categories/files-and-documents), [e-commerce](https://ai-powered.com/categories/e-commerce)
- **Listing updated:** 2026-11-20

## About

The README says Shopify's native product CSV cannot carry variant metafields, so this Apify Actor fills that gap for files of variant metafield values. You send a CSV and a column-to-metafield mapping, and it returns a report that flags row-level errors and duplicate destinations, then produces metafieldsSet request bodies when the input passes.

The tool works offline. It never connects to Shopify, reads current values or changes a store, so a ready report is a plan rather than an import. Identifiers must be canonical ProductVariant GIDs, or SKUs resolved through an explicit mapping file the caller supplies.

It suits agencies, developers and AI agents that already hold variant IDs and want a typed, checked request set before a separately authorized executor runs anything.

## Features

- **Row-level CSV validation:** Reports malformed CSV, missing columns, unsupported values and duplicate destinations with the source row and column.
- **GraphQL batch planning:** Builds metafieldsSet request bodies in batches of up to 25 metafields when the input passes validation.
- **Write policy modes:** Supports create_only, compare_digest and overwrite policies, with digest values supplied by the caller.
- **SKU mapping support:** Resolves SKUs through a caller-supplied sku-to-variant_id mapping file, with duplicate SKUs blocking the job.
- **Typed value checks:** Validates six metafield types, including integer and decimal bounds and date format, without automatic type conversion.

## Good for

- Checking supplier variant metafield CSVs before an import is scheduled
- Finding duplicate variant destinations in a catalog file
- Preparing typed metafieldsSet requests for a separate Shopify executor
- Adding an offline validation step to an n8n or API-driven workflow

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http shopify-variant-metafields-planner 'https://mcp.apify.com/?tools=ministrant_ram/shopify-variant-metafields-planner'
```

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

```sh
https://mcp.apify.com/?tools=ministrant_ram/shopify-variant-metafields-planner
```

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

```json
{
  "mcpServers": {
    "shopify-variant-metafields-planner": {
      "url": "https://mcp.apify.com/?tools=ministrant_ram/shopify-variant-metafields-planner"
    }
  }
}
```

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

```json
{
  "servers": {
    "shopify-variant-metafields-planner": {
      "type": "http",
      "url": "https://mcp.apify.com/?tools=ministrant_ram/shopify-variant-metafields-planner"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "shopify-variant-metafields-planner": {
      "serverUrl": "https://mcp.apify.com/?tools=ministrant_ram/shopify-variant-metafields-planner"
    }
  }
}
```

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

```sh
https://mcp.apify.com/?tools=ministrant_ram/shopify-variant-metafields-planner
```

Enter a Name (for example "PlainByte Shopify Variant Metafields CSV Validator"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin. When we checked, this server asked for a bearer token. Add it under HTTP headers as Authorization: Bearer <your token>.

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

```json
{
  "mcpServers": {
    "shopify-variant-metafields-planner": {
      "type": "http",
      "url": "https://mcp.apify.com/?tools=ministrant_ram/shopify-variant-metafields-planner"
    }
  }
}
```

## FAQ

### Does the Actor write to my Shopify store?

No. The README states it does not connect to Shopify or change a store, and a ready result is not authorization to write.

### What does a run cost?

The Actor page lists USD 1 per completed validation report plus USD 0.00005 per Actor start, with a minimum run budget of USD 1.01.

### Which metafield namespaces are supported?

Only the custom namespace is supported, according to the input contract.

### Does PlainByte Shopify Variant Metafields CSV Validator fetch variant IDs from my store?

No. The page says it does not fetch variant IDs, resolve SKUs from a live store or read current values.

### How do I add PlainByte Shopify Variant Metafields CSV Validator to Claude Code?

Run this command in your terminal: claude mcp add --transport http shopify-variant-metafields-planner 'https://mcp.apify.com/?tools=ministrant_ram/shopify-variant-metafields-planner'

### What are the best alternatives to PlainByte Shopify Variant Metafields CSV Validator?

The closest alternatives to PlainByte Shopify Variant Metafields CSV Validator are Shopify Product Scraper, Moltline Shopify Prep, Shopify Store Products (Apify) by Dataset Works, Shopify Product Scraper — Prices, Variants & Availability and Shopify Store Sync.

## Where this comes from

- Description: written from the project's website and its MCP Registry entry.
- Status: checked automatically by AIPoweredBot on 21 November 2026.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Shopify Product Scraper](https://ai-powered.com/mcp/shopify-product-scraper): Shopify Product Scraper is a paid MCP server for web search and scraping.
- [Moltline Shopify Prep](https://ai-powered.com/mcp/moltline-shopify-prep): Moltline Shopify Prep is a freemium MCP server for e-commerce.
- [Shopify Store Products (Apify) by Dataset Works](https://ai-powered.com/mcp/shopify-store-products-apify-by-dataset-works): Shopify Store Products (Apify) by Dataset Works is a paid MCP server for e-commerce.
- [Shopify Product Scraper — Prices, Variants & Availability](https://ai-powered.com/mcp/shopify-product-scraper-prices-variants-and-availability): Shopify Product Scraper — Prices, Variants & Availability is a paid MCP server for e-commerce.
- [Shopify Store Sync](https://ai-powered.com/mcp/shopify-store-sync): Shopify Store Sync is an open-source MCP server for e-commerce.
- [Wagner Data: supplier catalogs to Shopify](https://ai-powered.com/mcp/wagner-data-supplier-catalogs-to-shopify): Wagner Data: supplier catalogs to Shopify is a freemium MCP server for files and documents.
- [ChatGPT Product Feed Generator (Apify) - OpenAI product feed from Google Merchant or WooCommerce](https://ai-powered.com/mcp/chatgpt-product-feed-generator-apify-openai-product-feed-fro): ChatGPT Product Feed Generator (Apify) - OpenAI product feed from Google Merchant or WooCommerce is a paid MCP server for e-commerce.
- [Feed Check](https://ai-powered.com/mcp/feed-check): Feed Check is a freemium MCP server for e-commerce.

---
Source: https://ai-powered.com/mcp/plainbyte-shopify-variant-metafields-csv-validator
