{"_id":"@codespar/mcp-vtex","_rev":"6-6dc804aa3af911d91d1dfbb6bcefd385","name":"@codespar/mcp-vtex","dist-tags":{"latest":"0.2.2"},"versions":{"0.1.0":{"name":"@codespar/mcp-vtex","version":"0.1.0","keywords":["mcp","vtex","ecommerce","orders","products","brazil"],"license":"MIT","_id":"@codespar/mcp-vtex@0.1.0","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-vtex":"dist/index.js"},"dist":{"shasum":"3a4d7c149349f3888f6dda642aedfcc7332f8ae5","tarball":"https://registry.npmjs.org/@codespar/mcp-vtex/-/mcp-vtex-0.1.0.tgz","fileCount":4,"integrity":"sha512-no3hT8LntqyDJaptsZ3Y5ZN9qOT7QY9jUsZ3KaA3itwzc15/k+XeFqW10fR8/LIHcNf0r0zEYoe6ZBd+SXD71Q==","signatures":[{"sig":"MEUCIB9eJqZLzXjyWdnqBqHLjrsosBUjId9jrRtMHKDh4AfYAiEA1e+wthh67GvdjX8VwbXlzIdLSKj2dLao66zOVCAe7Rw=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":22878},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"ac49d04d5aa50ad5dc16233f0bba88213f917641","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for VTEX — e-commerce, orders, products, inventory, shipping","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-vtex_0.1.0_1774923342499_0.7194357449795581","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@codespar/mcp-vtex","version":"0.1.2","keywords":["mcp","vtex","ecommerce","orders","products","brazil"],"license":"MIT","_id":"@codespar/mcp-vtex@0.1.2","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-vtex":"dist/index.js"},"dist":{"shasum":"0b1e1e92d474f52fc5511f7a56c57179b2a8bdef","tarball":"https://registry.npmjs.org/@codespar/mcp-vtex/-/mcp-vtex-0.1.2.tgz","fileCount":7,"integrity":"sha512-qOpohH2lMXbzTC5MshAGRBmyZmDlaOW9mUKkCZjPO1BHUJ279Irqjcw3LECEvq7bL3SBgEtHosv4Fetwnn22Ww==","signatures":[{"sig":"MEQCIDiZKHTb0fsFaLQm9e+gaEkYAh5AyvKICAdIioXBZoc2AiADrFJ108lZB0RIAJR1/2ynzXeic7dRAQl7xkKGcvAfHQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":44524},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"8fd47fad095cdf96618460a39345eddfe2a4af21","mcpName":"io.github.codespar/mcp-vtex","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for VTEX — e-commerce, orders, products, inventory, shipping","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-vtex_0.1.2_1775953702630_0.5367007818300102","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@codespar/mcp-vtex","version":"0.2.0","keywords":["mcp","vtex","ecommerce","orders","products","brazil"],"license":"MIT","_id":"@codespar/mcp-vtex@0.2.0","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-vtex":"dist/index.js"},"dist":{"shasum":"1810052ef7caca239ae347b5967167351adf8905","tarball":"https://registry.npmjs.org/@codespar/mcp-vtex/-/mcp-vtex-0.2.0.tgz","fileCount":7,"integrity":"sha512-7QvWLMU94DyxLQbICJnFiQn386JjJpAJOyK6k6pXZtz9PvoicDwEMJVW4tUKgvlKOVcm06GtvZ+8wjUgeZU1EA==","signatures":[{"sig":"MEYCIQCLwC5hXbQYY6a98azTqWgDCnH4X3gT0JXhfSTvknm/AgIhAKjtj+OvzzUwCGLhQzm2xGFvZsrViQf2Il+y87WbSgfW","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":86091},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"bcd94c331d54cfed9e5380cc2d0d8aaee4d0c815","mcpName":"io.github.codespar/mcp-vtex","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for VTEX — e-commerce, orders, products, inventory, shipping","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-vtex_0.2.0_1777038503644_0.6285813658648258","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"@codespar/mcp-vtex","version":"0.2.1","keywords":["mcp","vtex","ecommerce","orders","products","brazil"],"license":"MIT","_id":"@codespar/mcp-vtex@0.2.1","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-vtex":"dist/index.js"},"dist":{"shasum":"741096f2f51dce0e11b9f58af970abfe0481b14d","tarball":"https://registry.npmjs.org/@codespar/mcp-vtex/-/mcp-vtex-0.2.1.tgz","fileCount":7,"integrity":"sha512-y1qPNDStYztEDv608Vi6H9dfHndZjYypZA7joGhc4M0QxnQHt17nNxQRLmHkXThe75ZHQ9YG1eyb1saQLSEssQ==","signatures":[{"sig":"MEUCIF9JLDSIIlT3xLUIyd21uuQE7X8+pAT/Ks+HRcvbRUDwAiEAy2dPzqKxSK2KQgI/M5AzGLKz5+bHko6uDTCB/+iDFGA=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":85869},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"0ab801a863239f0cb986bbda65abbaee3c621b44","mcpName":"io.github.codespar/mcp-vtex","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for VTEX — e-commerce, orders, products, inventory, shipping","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-vtex_0.2.1_1777123057310_0.4514424551746741","host":"s3://npm-registry-packages-npm-production"}},"0.2.2":{"name":"@codespar/mcp-vtex","version":"0.2.2","description":"MCP server for VTEX — e-commerce, orders, products, inventory, shipping","type":"module","main":"./dist/index.js","bin":{"mcp-vtex":"dist/index.js"},"scripts":{"build":"tsc","start":"node dist/index.js"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"devDependencies":{"@types/node":"^25.5.0","typescript":"^5.8.0"},"license":"MIT","keywords":["mcp","vtex","ecommerce","orders","products","brazil"],"mcpName":"io.github.codespar/mcp-vtex","_id":"@codespar/mcp-vtex@0.2.2","gitHead":"e8f2ad023876683538fe7b66a2fc88ab8d8ef92f","types":"./dist/index.d.ts","_nodeVersion":"22.22.3","_npmVersion":"10.9.8","dist":{"integrity":"sha512-1JMqyaY4C6zMkNLjnE2blcAQp1JvcZ3N/2ApOssFgbgBtjeIKb4hKAYDPQGdu0Y1JL/sfDjOMTswJ0u24y6AwA==","shasum":"181630459b5b1032df569fe41bdf66653965d0b7","tarball":"https://registry.npmjs.org/@codespar/mcp-vtex/-/mcp-vtex-0.2.2.tgz","fileCount":7,"unpackedSize":87124,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIDAiZlUlbXTs7sJxYRfp5t7F2q/Geu7/abk/pzbIXfBwAiBRUj0sR51gWcmMz3gaTCTLNGnDf1xK0lZwYZXZT4wXdQ=="}]},"_npmUser":{"name":"codespar-npm","email":"fabiano@codespar.dev"},"directories":{},"maintainers":[{"name":"codespar-npm","email":"fabiano@codespar.dev"},{"name":"dangazineu","email":"daniel.gazineu@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-vtex_0.2.2_1782153594267_0.5589237737936874"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-31T02:15:42.329Z","modified":"2026-06-22T18:39:54.560Z","0.1.0":"2026-03-31T02:15:42.635Z","0.1.2":"2026-04-12T00:28:22.766Z","0.2.0":"2026-04-24T13:48:23.783Z","0.2.1":"2026-04-25T13:17:37.453Z","0.2.2":"2026-06-22T18:39:54.403Z"},"license":"MIT","keywords":["mcp","vtex","ecommerce","orders","products","brazil"],"description":"MCP server for VTEX — e-commerce, orders, products, inventory, shipping","maintainers":[{"name":"codespar-npm","email":"fabiano@codespar.dev"},{"name":"dangazineu","email":"daniel.gazineu@gmail.com"}],"readme":"# @codespar/mcp-vtex\n\n> MCP server for **VTEX** — e-commerce platform with catalog, orders, inventory, and promotions\n\n[![npm](https://img.shields.io/npm/v/@codespar/mcp-vtex)](https://www.npmjs.com/package/@codespar/mcp-vtex)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)\n\n## Quick Start\n\n### Claude Desktop\n\nAdd to `~/.config/claude/claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"vtex\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@codespar/mcp-vtex\"],\n      \"env\": {\n        \"VTEX_ACCOUNT_NAME\": \"your-account\",\n        \"VTEX_APP_KEY\": \"your-app-key\",\n        \"VTEX_APP_TOKEN\": \"your-app-token\"\n      }\n    }\n  }\n}\n```\n\n### Claude Code\n\n```bash\nclaude mcp add vtex -- npx @codespar/mcp-vtex\n```\n\n### Cursor / VS Code\n\nAdd to `.cursor/mcp.json` or `.vscode/mcp.json`:\n\n```json\n{\n  \"servers\": {\n    \"vtex\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@codespar/mcp-vtex\"],\n      \"env\": {\n        \"VTEX_ACCOUNT_NAME\": \"your-account\",\n        \"VTEX_APP_KEY\": \"your-app-key\",\n        \"VTEX_APP_TOKEN\": \"your-app-token\"\n      }\n    }\n  }\n}\n```\n\n## Tools (33)\n\n| Tool | Purpose |\n|---|---|\n| `list_products` | List products from VTEX catalog |\n| `get_product` | Get product details by ID |\n| `create_product` | Create a new product in the VTEX catalog |\n| `update_product` | Update an existing product in the VTEX catalog |\n| `list_skus` | List SKUs for a product |\n| `create_sku` | Create a new SKU for a product |\n| `list_categories` | List all categories with pagination |\n| `create_category` | Create a new category in the catalog |\n| `get_catalog` | Get the catalog category tree |\n| `list_orders` | List orders with optional filters |\n| `get_order` | Get full OMS order details by ID |\n| `update_order_status` | Transition an order to the handling state (start fulfillment) |\n| `invoice_order` | Issue a fiscal invoice (nota fiscal) for an order |\n| `track_order_invoice` | Update tracking info for a previously issued invoice |\n| `cancel_order` | Cancel an order |\n| `list_customer_orders` | List order history for a customer (filtered by email) |\n| `get_sku_price` | Get pricing details for an SKU (base price, list price, markup, cost, fixed prices per trade policy) |\n| `update_sku_price` | Update base/list/cost price for an SKU |\n| `list_price_tables` | List all configured price tables (trade policies) |\n| `get_inventory` | Get inventory/stock for a SKU across warehouses |\n| `update_inventory` | Update inventory quantity for a SKU at a specific warehouse |\n| `get_shipping_rates` | Simulate shipping rates for items to a postal code |\n| `list_warehouses` | List all warehouses configured in the account |\n| `create_warehouse` | Register a new warehouse (fulfillment center) |\n| `create_promotion` | Create a promotion/discount in VTEX |\n| `list_coupons` | List all promotion coupons |\n| `create_coupon` | Create a promotion coupon code |\n| `list_subscriptions` | List customer subscriptions |\n| `create_subscription` | Create a recurring subscription for a customer (VTEX Subscriptions) |\n| `get_masterdata_document` | Get a document (customer profile, custom entity) from VTEX Master Data v2 |\n| `search_masterdata` | Search documents in a Master Data entity |\n| `create_giftcard` | Create a gift card for a customer (GiftCard Hub) |\n| `get_giftcard` | Get gift card details by ID |\n\n## Authentication\n\nVTEX uses app key and app token headers for API authentication.\n\n## Sandbox / Testing\n\nVTEX provides sandbox access via partner accounts. Contact VTEX for developer access.\n\n### Get your credentials\n\n1. Go to [VTEX Developer Portal](https://developers.vtex.com)\n2. Access your VTEX admin or create a partner account\n3. Generate an app key and app token from License Manager\n4. Set the environment variables\n\n## Environment Variables\n\n| Variable | Required | Description |\n|----------|----------|-------------|\n| `VTEX_ACCOUNT_NAME` | Yes | VTEX account name |\n| `VTEX_APP_KEY` | Yes | API app key |\n| `VTEX_APP_TOKEN` | Yes | API app token |\n| `VTEX_ENVIRONMENT` | No | Environment host slug (default `vtexcommercestable`) |\n\n## Roadmap\n\n### v0.3 (planned)\n- Checkout / cart session management\n- Marketplace seller and offer management\n- Carrier (shipping policy) registration\n\nWant to contribute? [Open a PR](https://github.com/codespar/mcp-dev-latam) or [request a tool](https://github.com/codespar/mcp-dev-latam/issues).\n\n## Links\n\n- [VTEX Website](https://vtex.com)\n- [VTEX Developer Documentation](https://developers.vtex.com)\n- [MCP Dev LATAM](https://github.com/codespar/mcp-dev-latam)\n- [Landing Page](https://codespar.dev/mcp)\n\n## Enterprise\n\nNeed governance, budget limits, and audit trails for agent payments? [CodeSpar Enterprise](https://codespar.dev/enterprise) adds policy engine, payment routing, and compliance templates on top of these MCP servers.\n\n## License\n\nMIT\n","readmeFilename":"README.md"}