v0.2.0 - PII Protection for all VTEX API endpoints

🔒 Release v0.2.0: Comprehensive PII Protection

This release introduces automatic PII (Personally Identifiable Information) protection across all VTEX API endpoints, ensuring LGPD/GDPR compliance by default.

✨ Major Features

🛡️ Automatic PII Filtering

• All 20 API endpoints now automatically filter sensitive customer data
• 33 protected field types including names, emails, documents, addresses, and payment data
• Enabled by default for maximum security out of the box
• Configurable via VTEX_PII_PROTECTION environment variable

🔐 What Gets Protected

👤 Personal Information

• Names: firstName, lastName, clientName, receiverName, cardHolder
• Corporate: corporateName, tradeName

📧 Contact Information

• Email: email, followUpEmail
• Phone: phone, cellPhone, corporatePhone

🆔 Documents & IDs

• cpf, cnpj, document, corporateDocument, stateInscription

🏠 Address Information

• Components: street, number, complement, neighborhood, postalCode, city, state
• Objects: address, billingAddress, location
• Geo: geoCoordinates, latitude, longitude

💳 Payment Information

• Card data: cardNumber, firstDigits, lastDigits
• Security: cvv, cvv2, expireMonth, expireYear

✅ What Gets Preserved

All ID fields are preserved for correlation:

• orderId, userId, userProfileId, addressId, transactionId
• productId, skuId, warehouseId, dockId
• All other fields ending in Id

Business data remains intact:

• Order values, quantities, prices, status
• Dates, timestamps, configuration flags
• Product names, descriptions, SKUs

📦 Installation

Download & Install

1. Download mcp-vtex.mcpb from the assets below
2. Open Claude Desktop
3. Go to Settings → Developer → MCP Servers
4. Click "Install from file" and select the downloaded .mcpb file
5. Configure your VTEX credentials
6. Enable the server

Configuration

```bash

Required

VTEX_ACCOUNT_NAME=your-account-name
VTEX_APP_KEY=your-app-key
VTEX_APP_TOKEN=your-app-token

Optional

VTEX_ENVIRONMENT=vtexcommercestable # default
VTEX_PII_PROTECTION=true # default (recommended)
```

To disable PII protection (not recommended):
```bash
VTEX_PII_PROTECTION=false
```

🧪 Testing

This release includes comprehensive test suites:

```bash

Test PII filtering

npm test

Test MCP server integration

npm run test:server
```

💡 Benefits

• 🛡️ LGPD/GDPR Compliance: Sensitive data never reaches the LLM
• 💰 Token Efficiency: Less data = lower costs
• 🔒 Privacy by Design: PII filtered at source
• ⚡ Simple & Fast: No complex masking or pseudonymization
• ✅ Maintains Functionality: IDs allow for correlation and lookups

📊 Technical Details

• Protected Endpoints: All 20 (Catalog: 5, Orders: 3, Pricing: 6, Inventory/Logistics: 6)
• Filter Implementation: Recursive function applied globally to all responses
• Response Format: YAML for token optimization
• Performance: Zero overhead when disabled, minimal when enabled

🔄 What's Changed

New Files:

• `.env.example` - Configuration template
• `test-pii-filter.js` - PII protection test suite
• `test-mcp-server.js` - MCP integration tests

Modified:

• `server/index.js` - Added PII filtering logic
• `README.md` - Comprehensive PII protection documentation
• `manifest.json` - Added `VTEX_PII_PROTECTION` configuration
• `package.json` - Added test scripts

📝 Full Changelog

Commits:

• feat: add comprehensive PII protection for all API endpoints
• chore: bump version to 0.2.0

---

🤖 Generated with Claude Code

Full Changelog: v0.1.0...v0.2.0

v0.1.0 - Initial Release

VTEX MCP Server v0.1.0

First unnofficial release of the VTEX MCP Server.

Features

🛠️ Tools (21 total)

• Catalog API (5 tools): Products, SKUs, categories
• Orders API (3 tools): Order management and tracking
• Pricing API (6 tools): Price management and tables
• Inventory API (6 tools): Stock and logistics

📋 Prompts (8 workflows)

• analyze-sku-complete - Complete SKU analysis
• analyze-product-performance - Product performance review
• compare-prices - Price comparison across tables
• inventory-report - Inventory reporting
• order-analysis - Detailed order analysis
• product-catalog-overview - Catalog overview
• pricing-strategy-review - Pricing strategy review
• logistics-setup-review - Logistics configuration review

🎯 Key Features

• ✅ Read-only operations for safety
• ✅ YAML responses (20-30% token savings)
• ✅ Comprehensive VTEX API coverage
• ✅ Pre-built analytical workflows

Installation

Download mcp-vtex.mcpb and install via Claude Desktop Settings → MCP Servers

Requirements

• VTEX Account Name
• VTEX App Key with permissions:
  • Catalog - Full access
  • Orders - Full access
  • Pricing - Full access
  • Logistics - Full access

---

🤖 Generated with Claude Code