Free VTEX MCP: No-Code Setup

  • Free forever plan: unlimited connected accounts, up to 30 days of history (15 days in AI chats) and 100 automation credits a month.
  • Nothing to host: your VTEX account name, an App Key and its App Token, entered once in Porter.
  • Your store in one chat: orders, order lines, SKUs, brands, sales channels and stock per warehouse.
  • Safe for live stores: orders, prices and stock stay exactly as you set them in VTEX.
Try free

What is a VTEX MCP server?

A VTEX MCP server lets an AI assistant like Claude or ChatGPT reach your VTEX data through the Model Context Protocol (MCP). You ask in plain language, and the assistant calls the VTEX APIs for orders, SKUs, brands, sales channels and stock per warehouse.

  • Quick setup: paste https://mcp.portermetrics.com/mcp into Claude, ChatGPT or Cursor and sign in with your Porter account. Full steps
  • Works in: Claude, ChatGPT, Claude Code, Cursor, VS Code and Codex
  • Data: 36 VTEX fields: orders, order lines, SKUs, brands, sales channels and stock per warehouse
  • Changes: none, Porter only reads VTEX
  • Price: free plan, paid plans from $15 per account a month
  • Official VTEX server: VTEX’s Developer MCP serves documentation and API references, not your store data
Use cases

VTEX MCP use cases

Porter Metrics connects VTEX to Claude, ChatGPT and other AI clients through one hosted MCP server. Ask what the store really sold yesterday, which SKUs carry the month or where stock ran out, and the answer comes from your live VTEX account.

Reports

Orders and net sales

  • Invoiced sales: Orders, Order Value and Units by Order Date, filtered to invoiced orders so cancellations don’t inflate the total.
  • Every status: Order Status from ready-for-handling and handling to invoiced and canceled, with each one’s share.
  • What’s in the total: Items Value, Shipping, Tax and Discounts split out for any period.
  • Your store’s calendar: Order Date is the store’s local day, taken from each sales channel’s time zone.

SKUs, brands and categories

  • What sold: Line Revenue and Quantity Sold by SKU Name, Brand and Category, from the order lines.
  • List price vs selling price: Line List Value next to Line Revenue shows the real discount per SKU.
  • Channels and payments: Orders and Order Value by Sales Channel and by Payment Methods.
  • Marketplace or own stock: Origin and Seller show who fulfilled each order.

Stock per warehouse

  • Today’s stock: Stock On Hand, Stock Reserved and Stock Available for every SKU and Warehouse.
  • Catalog status: SKU Active shows which SKUs are live in the catalog.

Every field and its definition is in the VTEX fields list.

VTEX next to your marketing

  • Spend next to invoiced sales: Meta and Google Ads spend beside what the store billed. Start with the Meta Ads MCP and the Google Ads MCP.
  • Sessions next to orders: GA4 sessions beside invoiced Orders, week by week, through the GA4 MCP.
  • Email next to revenue: Klaviyo campaigns beside Order Value, through the Klaviyo MCP.

Reports and alerts

  • Live dashboards: one hosted link that stays current, with no orders export to rebuild.
  • Scheduled delivery: a dashboard emailed to you or a client on the day and hour you pick.
  • Weekly summary: what sold, what was cancelled and which SKUs ran out, written in the chat.

Research

  • Channel mix: marketplace vs own-store share of invoiced sales, month by month.

Audits

  • Stock-outs: the SKUs with zero Stock Available, leaving out the ones VTEX marks as Unlimited Stock.
  • Cancellations: the share of orders canceled by sales channel and payment method.
  • Discount depth: SKUs whose Line Revenue sits far below Line List Value.
  • Inactive SKUs with stock: SKUs marked inactive that still hold Stock Available.

Example answer

Demo data, from a fictional store. Prompt: “Show yesterday’s invoiced Orders and Order Value by Sales Channel, with average order value and Shipping.”

Sales ChannelTypeOrdersOrder ValueAverage order valueShipping
Main storeWeb1,840$212,400.00$115.43$8,640.00
Mobile appApp920$98,650.00$107.23$3,210.00
Marketplace · Mercado LivreMarketplace610$54,320.00$89.05$1,180.00
Physical storesPOS388$41,860.00$107.89$0.00

Claude counts invoiced orders only, so cancellations don’t inflate the total, and notes the marketplace orders with the lowest basket.

Reference

VTEX MCP server reference

One server, every VTEX store: Porter connects VTEX to the AI clients, fields and workflows e-commerce teams already use. The same Porter server URL works in Claude, ChatGPT and any MCP client that supports remote servers. Porter calls VTEX’s APIs with the application key you give it, as VTEX’s guide to API authentication with API keys describes.

VTEX metrics

Orders: Orders · Order Value · Units · Items Value · Shipping · Tax · Discounts

Order lines: Line Revenue · Line List Value · Quantity Sold

Catalog: SKUs

Inventory: Stock On Hand · Stock Reserved · Stock Available

VTEX dimensions

Orders: Order Date · Order ID · Order Status · Sales Channel · Sales Channel ID · Payment Methods · Origin · Seller · Currency · Has Return Invoice

Products: Product Name · Product ID · SKU Name · SKU ID · Reference Code · Brand · Category · SKU Active

Inventory: Warehouse · Warehouse ID · Unlimited Stock

Porter has 36 ready-made VTEX fields, 14 metrics and 22 dimensions. Each one is in the full VTEX field reference.

Four tables, one question each

Orders · Order lines · SKU catalog · Inventory per warehouse. Each table answers its own questions. Product Name lives in the catalog, so ask for SKU Name, Brand and Category when you want them next to Line Revenue. Catalog and inventory are today’s, whatever the date range.

Other destinations

The same VTEX connection also sends data to Data Studio (formerly Looker Studio), BigQuery and Google Sheets, at no extra cost.

Security and trust

Safety and security

Porter’s VTEX MCP reads orders, the catalog and inventory and leaves your store as it is. Claude reports on what sold and what’s in stock while orders, prices and stock levels stay exactly as you set them in the VTEX admin. You choose the key Porter uses and its role, and can switch it off anytime.

Safe for live stores

Every VTEX question is a report. Order edits, price changes, promotions and stock updates stay in the VTEX admin, where you handle them as usual.

Give Porter its own app key

Generate an application key just for Porter, with a role that reads orders, the catalog and inventory. VTEX’s guide to application keys explains that new keys start with no permissions and get access only through the roles you add.

Customer data stays out

Porter leaves out the customer name, email, document and shipping address that come with each order. Customer records in VTEX Master Data aren’t part of the connector.

Revoke access anytime

Deactivate Porter’s key in the VTEX admin and the connection stops at once, without touching your other integrations. Generate a new key pair to reconnect.

Setup

How to set up the VTEX MCP server

Porter’s VTEX MCP uses one server URL in every AI client, plus your VTEX account name and an App Key with its App Token. Claude takes Porter as a plugin or a custom connector. ChatGPT takes it through the Porter Metrics app or a custom MCP server. Both read the same stores, with the same 36 fields.

https://mcp.portermetrics.com/mcp

Before you start

  • Account name: the first part of your store’s VTEX address, as in yourstore.myvtex.com. Porter also accepts the admin URL and keeps the name.
  • App Key and App Token: generated in your VTEX admin, with a role that reads orders, the catalog and inventory. VTEX shows the token only once, so copy it straight away.

How to install VTEX MCP in Claude

  1. Open claude.ai and go to Settings → Connectors.
  2. Click Add custom connector.
  3. Name it Porter and paste https://mcp.portermetrics.com/mcp.
  4. Click Add, then sign in with your Porter account and approve access.
  5. Ask “Connect my VTEX store”, then enter your account name, App Key and App Token in Porter.
  6. Ask a store question, like “Show yesterday’s invoiced Orders and Order Value by Sales Channel.”

On Team and Enterprise plans, an owner adds the connector first. Anthropic’s custom connector guide covers the same steps. The Claude-specific setup and use cases live on the VTEX connector for Claude page.

Watch the Claude setup demo

How to install VTEX MCP in ChatGPT

ChatGPT has two routes to the same data. The Porter Metrics app in ChatGPT’s app directory works on any plan with apps. The Porter MCP gets every new tool the day Porter ships it, on Business, Enterprise and Edu workspaces.

Porter Metrics app: in ChatGPT, open Apps, search “Porter Metrics”, click Connect and sign in with your Porter account, then ask “Connect my VTEX store”, then enter your account name, App Key and App Token in Porter.

Porter MCP:

  1. Open ChatGPT on the web and go to Plugins.
  2. Click +, then Add custom MCP server.
  3. Name it Porter and paste https://mcp.portermetrics.com/mcp under Connection.
  4. Choose OAuth, tick “I understand and want to continue” and click Create as a plugin.
  5. Sign in with your Porter account.

Pro accounts can add it with read access only, per OpenAI’s custom MCP server guide.

How to install VTEX MCP in Claude Code, Cursor, VS Code and Codex

Pick your coding agent. Each one uses the same server URL and a Google sign-in, so no API key or credentials file sits in a config.

  1. Add Porter’s plugin in Claude Code. It installs the Porter connector and Porter’s skill in one step.
    /plugin marketplace add portermetrics/porter /plugin install porter-metrics@portermetrics
  2. Ask for your data. The first time, your browser opens: sign in with the Google account you use in Porter.
  3. No plugins? Add the server directly instead:
    claude mcp add --transport http porter https://mcp.portermetrics.com/mcp
  4. Check: /mcp shows porter as connected. Ask: “Which VTEX accounts can you see?”
  1. Open Cursor Settings → Tools & Integrations and click New MCP Server. Cursor opens mcp.json.
  2. Paste this and save.
    { "mcpServers": { "porter": { "url": "https://mcp.portermetrics.com/mcp" } } }
  3. Click Connect next to porter and sign in with the Google account you use in Porter.
  4. Check: porter shows a green dot in Tools & Integrations. Open an Agent chat. Ask: “Which VTEX accounts can you see?”
  1. Open the Command Palette (Ctrl/Cmd+Shift+P) and run MCP: Add Server → HTTP.
  2. Paste https://mcp.portermetrics.com/mcp, name it porter and choose Global. Or add it to .vscode/mcp.json:
    { "servers": { "porter": { "type": "http", "url": "https://mcp.portermetrics.com/mcp" } } }
  3. Allow the sign-in prompt and sign in with the Google account you use in Porter.
  4. Check: open Copilot Chat in Agent mode; Porter’s tools appear under the tools icon. Ask: “Which VTEX accounts can you see?”
  1. Add Porter from your terminal.
    codex mcp add porter --url https://mcp.portermetrics.com/mcp
  2. Sign in. Your browser opens: sign in with the Google account you use in Porter.
    codex mcp login porter
  3. Check: codex mcp list shows porter as logged in. Start codex. Ask: “Which VTEX accounts can you see?”

The same URL works in Windsurf, Cline, Zed and any client that supports remote MCP servers over HTTP.

Add Porter’s skill

Porter’s skill teaches Claude which Porter tools to call for each VTEX task, so answers need fewer retries. In claude.ai, download https://mcp.portermetrics.com/skill.zip and upload it in Settings → Capabilities → Skills. In Claude Code, Porter’s plugin adds it for you, and other agents can run npx skills add portermetrics/porter.

Test the connection

Paste this into a new chat. It only reads data.

Use Porter only. List my connected VTEX stores and show invoiced Orders, Order Value and Units by Order Date for the last 7 days. Add the average order value as Order Value divided by Orders. Say so if an account returns no data.

Is there an official VTEX MCP server URL?

VTEX’s own server, the VTEX Developer MCP, has no URL to paste: it runs on your machine and reads VTEX’s documentation, not your store. Use Porter’s URL above to ask about your own orders, SKUs and stock, next to your other channels.

Guides and videos

  • Claude: the VTEX connector page linked above has the 3-step setup and five use cases.
  • Videos: more Claude setups on Porter’s YouTube channel.
Prompts

VTEX MCP prompts

Copy a prompt into Claude or ChatGPT, then change the dates or thresholds to fit your account. Every prompt only reads data.

Reporting prompts

Daily net sales

For the last 30 days, show invoiced Orders, Order Value and Units by Order Date. Add the average order value for each day as Order Value divided by Orders, and tell me which day sold the most.

Cancellations check

Break down last month’s Orders and Order Value by Order Status. Show each status’s share of the total, and tell me how much higher gross sales are than invoiced sales.

Top SKUs

From order lines in the last 30 days, list the top 20 SKUs by Line Revenue for invoiced orders, with SKU Name, Brand, Category, Quantity Sold and Line List Value. Add the average discount as 1 minus Line Revenue divided by Line List Value.

Brand share

For the last 30 days, total Line Revenue by Brand for invoiced orders, and show each brand’s share.

Channels and payments

For the last 90 days, show invoiced Orders and Order Value by Sales Channel, then by Payment Methods. Which channel has the highest average order value?

Research and audit prompts

Spend to invoiced sales

For the last 12 weeks, put weekly Meta Ads and Google Ads spend next to invoiced Order Value by week. Show cost per invoiced order by week.

Sessions to orders

For the last 8 weeks, put GA4 sessions by week next to invoiced Orders by week, and work out orders per 100 sessions.

Email to revenue

For the last 8 weeks, put Klaviyo campaign sends and clicks by week next to invoiced Order Value by week. Flag weeks where email went out and revenue didn’t move.

VTEX next to Shopify

For brands on both platforms: compare VTEX invoiced Order Value with Shopify Net Sales by week for the last 8 weeks, with each store’s share of the total.

The research skills blend VTEX with your ad, analytics, email or other store accounts, so connect Meta Ads, Google Ads, GA4, Klaviyo or the Shopify MCP in Porter first.

Management prompts

These run on a schedule and send what they find, while your VTEX store stays as it is.

Weekly report by email

Build a VTEX dashboard with invoiced Orders, Order Value and average order value by week, plus Line Revenue by Brand, and email it to me every Monday at 8 a.m.

Monday stock-out email

Every Monday, email me a dashboard listing SKUs with zero Stock Available by Warehouse, leaving out Unlimited Stock, so the ad team can pause them.

Live store dashboard

Build a live VTEX dashboard with invoiced Orders and Order Value by Order Date for the last 30 days, a Sales Channel table and the top 10 SKUs by Line Revenue, and give me its link.
Who this is for

Who this is for

E-commerce marketers who run a VTEX store and answer for its numbers get the most from Porter’s MCP. Agencies, paid media teams and marketing analysts use it to turn a store question into a net sales report, a best-seller list or a stock-out check, without exporting orders from the admin.

E-commerce and DTC marketers

  • Morning check: yesterday’s invoiced orders and order value by sales channel.
  • Best sellers: SKUs, brands and categories ranked by line revenue.

Your daily sales number includes orders that were later cancelled. The real question is what got invoiced.

Agencies and freelancers

  • Every client store: each VTEX account connects with its own key and answers to the same prompt.
  • Client reports: a live dashboard link the client opens on Monday, already current.

Paid media and growth marketers

  • Spend next to invoiced sales: Meta and Google Ads beside what the store billed.
  • Ads on empty shelves: out-of-stock SKUs flagged so campaigns stop sending traffic to them.
Comparison

VTEX Developer MCP vs. Porter

VTEX’s own VTEX Developer MCP and Porter’s MCP do different jobs. VTEX’s Developer MCP guide describes a local server that searches VTEX documentation and API references for AI coding tools. Porter is a hosted MCP for marketers: connect your store once, ask about orders and stock, and see VTEX next to your other channels.

VTEX’s MCP helps you build on VTEX. Porter’s MCP hands your AI your store next to everything that brings buyers to it.

Both speak MCP and work in Claude. Here is where they part.

PorterVTEX Developer MCP
Same job, different reach
Built forMarketers, agencies and analystsDevelopers building on VTEX
Where it runsHosted by Porter at mcp.portermetrics.com/mcpOn your own machine, with Node.js 18 or newer
What it readsYour store’s orders, order lines, SKUs and stockVTEX documentation and API references
Tools36 ready-made fields in four tables4 tools: search docs, fetch a doc, search endpoints, endpoint details
Works inClaude, ChatGPT and any remote MCP clientCursor, VS Code with GitHub Copilot, Claude Code, Claude Desktop and Gemini CLI
PriceIncluded in every Porter plan, the free plan tooNo price listed in VTEX’s guide
Only one side
Meta, Google, GA4 and Klaviyo in the same answerYes, from Porter’s 30+ data sources—
Live dashboards at their own linkYes—
Scheduled reports by emailYes—
Skills: whole store tasks, already writtenYes—
VTEX docs search and endpoint specs—Yes

VTEX’s column follows VTEX’s Developer MCP guide and VTEX’s release note on the AI Developer Toolkit (as of November 2026).

Use VTEX’s own if you write VTEX code. Everything under Only one side is what happens when the store is one channel among several. Both servers can sit in the same Claude account.

Which VTEX MCP do you need?

“VTEX MCP” names a few different servers. The job decides which one you want.

  • VTEX Developer MCP: VTEX’s docs and API references inside your coding tool, launched April 9, 2026.
  • VTEX skills: VTEX’s catalog of AI skills with platform context for coding agents.
  • Self-hosted open-source servers: free to download and yours to run. You keep the App Token on your machine and patch the code when VTEX’s APIs change.
  • Porter: your store’s orders and stock next to your ads, email and analytics, hosted, in any MCP client.

And the third-party VTEX MCPs?

A few rank for this search, and they split two ways.

  • Hosted store connectors: they read VTEX into the chat, usually VTEX alone.
  • Code-generated servers: they wrap VTEX endpoints one by one and leave the analysis to you.

Porter reads your store next to your marketing from one hosted server, starting on the free plan. For other store platforms, see the WooCommerce MCP.

Porter vs other hosted VTEX MCPs

Other hosted VTEX MCPs also skip the setup. Porter is built for teams that report on several accounts and channels:

1

Every account at once

One prompt answers for all your VTEX accounts and clients, not one account per setup.

2

VTEX next to 30+ sources

GA4, Google Tag Manager, Google Ads, Meta Ads and Klaviyo, blended in one answer.

3

Competitor research

Competitor ads, keywords and search results, next to your own VTEX numbers.

4

Reports outside the chat

Live dashboards, scheduled email reports, and the same data in Data Studio, BigQuery and Google Sheets.

5

Read-only by design

Porter reads VTEX and changes nothing in it.

6

Claude and ChatGPT both covered

A remote MCP URL, plus an approved app in ChatGPT’s app directory.

VTEX MCP pricing

The VTEX MCP is included in every Porter plan, the free-forever plan too. Reporting is billed per connected account.

  • 14-day trial: everything unlimited, no credit card.
  • Free forever: unlimited connected accounts, 30 days of history (15 days in AI chats), 100 automation credits a month.
  • Paid Reporting: from $15 per account a month, or $12.50 billed annually.
  • Unlimited questions: AI chats, queries and dashboards are included. Reads are free; each completed change uses 1 automation credit.
5 accounts
Monthly billing
$40
Annual billing, per month
$33.33
Per account
$8.00

Reporting price for connected accounts, in USD. AI chats, queries and dashboards are unlimited. Annual billing is 10 months for 12.

The more accounts you connect, the lower the price per account. See the full calculator on Porter pricing.

Frequently asked questions

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.

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.

Start free

Connect VTEX to Claude or ChatGPT and start with invoiced sales reports, best-seller lists and stock-out emails that land in your inbox.

Start free: unlimited connected accounts on the free-forever plan, or a 14-day trial with everything unlimited and no card.

  • E-commerce and DTC marketers: what the store really invoiced yesterday, from one question.
  • Agencies: every client's VTEX store answers to one prompt.
  • Paid media and growth marketers: ad spend sits next to invoiced sales, and empty shelves get flagged.
  • Marketing analysts: 36 named fields and totals that reconcile with the admin.