Is there an official VTEX MCP?
Yes. VTEX ships the VTEX Developer MCP, a local server that gives AI coding tools VTEX’s documentation and API references. It doesn’t read your store’s orders or stock. Porter’s VTEX MCP runs at https://mcp.portermetrics.com/mcp, reads your store with your App Key and App Token and puts it next to your other channels.
What is the VTEX MCP server URL?
Porter’s VTEX MCP server URL is https://mcp.portermetrics.com/mcp. Paste it into Claude, ChatGPT or another AI client as a custom connector, then connect your store with its account name, App Key and App Token. VTEX’s Developer MCP has no URL: you start it on your machine with npx.
Is the VTEX MCP free?
Porter’s VTEX MCP is included in every Porter plan, the free-forever plan too. The free plan covers unlimited connected accounts, up to 30 days of history, 15 days in AI chats and 100 automation credits a month. Paid Reporting starts at $12.50 a month per data source account, billed annually, and the 14-day trial needs no card.
Can I connect several VTEX stores?
Yes. Each store connects with its own account name, App Key and App Token and bills as one data source account. Agencies add every client’s store the same way, then name the store they mean when they ask. The free plan connects unlimited stores.
Does Porter read VTEX customers?
Porter reads orders, order lines, the catalog and inventory. Customer records in VTEX Master Data stay out, and so do the customer name, email and address on each order. For customer lists and segments, use the VTEX admin as usual.
Which time zone does Claude use for VTEX orders?
Your store’s. VTEX keeps order dates in UTC, and Porter dates each order in the time zone its sales channel declares, so yesterday in Claude is yesterday in your admin. If a channel declares a zone Porter doesn’t map yet, Claude names it in an error instead of moving orders to the wrong day.
What is MCP? Is MCP an agent?
MCP is the Model Context Protocol, an open standard for connecting AI applications to tools like VTEX. MCP isn’t the agent. Claude and ChatGPT are the agents, and Porter’s MCP is how they reach your store.
Troubleshooting
Why don’t the totals match the VTEX admin?
Ask for invoiced orders first: VTEX counts cancelled orders in sales totals until you filter by Order Status. Order Value includes shipping and tax, while Line Revenue doesn’t. And a day in Porter is the store’s local day, not the UTC day. Those three explain most gaps.
Why is the first VTEX question slow?
VTEX lists at most 30 pages of orders per request, so Porter splits a long date range into smaller ones and then reads each order. A month of a large store can take a while the first time. Catalog and inventory questions read every SKU, so they take longer than order questions.
Why did Claude lose access to VTEX?
Generate a new App Key and App Token in the VTEX admin and reconnect them in Porter. Porter stops after VTEX rejects the key pair twice in a row, for example when the key was deactivated. If VTEX answers 403 instead, the key works but its role can’t read that data, so add the missing role.