How to Use the Commerce.js MCP in Claude Code

Q: How do I add the Commerce.js server to Claude Code?

Use the claude mcp add command with the server URL. Once configured, you can call any of the ten tools directly from your terminal prompt.

Q: Which Commerce.js tools require a Secret Key?

Both getorder and listorders require your Secret Key. Ensure these are set in your environment variables for the server to access them.

Automate your store maintenance and order processing in the terminal with Claude Code.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Commerce.js MCP to Claude Code

Create your Vinkius account to connect Commerce.js to Claude Code and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Commerce.js with Claude Code

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Headless Commerce.js operations in Claude Code

Run store management tasks directly from your shell. Use `list_products` to pipe store data into your CI scripts or cron jobs, keeping your inventory information updated without a browser. The server integrates with your existing terminal workflows. You can trigger batch updates or pull product IDs for automated testing pipelines in a single command.

Terminal-based order management

Query your sales data during deployment or debugging. `list_orders` lets you scan recent transactions, while `get_order` pulls the exact record you need to verify a failed payment. This is perfect for DevOps tasks. You can build shell scripts that use these tools to monitor store health and alert you to issues in real-time.

Automated checkout testing

Simulate end-to-end purchasing in your test suites. Claude Code uses `create_cart`, `add_to_cart`, and `capture_order` to verify that your checkout flow remains stable after every commit. It handles the entire sequence programmatically. You can bake these checks into your deployment process to catch regressions before they reach your customers.

Setup guide

Set up Commerce.js MCP in Claude Code

Prerequisites

Claude Code CLI installed (npm install -g @anthropic-ai/claude-code)
Active Vinkius subscription with a valid endpoint token

1

Run the add command

Open your terminal and run the command shown on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com. Use --scope user to make it available across all projects.
2

Verify the connection

Start a Claude Code session and type /mcp to list connected servers. You should see commercejs-mcp with a green status indicator.
3

Start using tools

Ask Claude Code something like "Check my latest Commerce.js transactions." It will automatically discover and invoke the available Commerce.js tools.

Terminal

claude mcp add --transport http commercejs-mcp https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Get your connection token →

Prerequisites

Claude Code CLI installed
Active Vinkius subscription with a valid endpoint token

1

Open the config file

Create or edit .mcp.json in your project root for project-level scope, or ~/.claude.json for user-level scope.
2

Add the Commerce.js MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Code

Start a new Claude Code session. Type /mcp to confirm the server is connected. The tools will be automatically available in your conversation.

.mcp.json

{
  "mcpServers": {
    "commercejs-mcp": {
      "type": "url",
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Commerce.js. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Commerce.js now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Commerce.js MCP in Claude Code

Use the `claude mcp add` command with the server URL. Once configured, you can call any of the ten tools directly from your terminal prompt.

Yes, it works in any headless environment. You can pipe the tool outputs into your build scripts to automate store data synchronization.

Your keys are stored locally in your config file. The Vinkius sandbox ensures that only authenticated requests reach your store endpoint.

Both `get_order` and `list_orders` require your Secret Key. Ensure these are set in your environment variables for the server to access them.

It accesses your product catalog, cart sessions, and order records. We treat this data as ephemeral, keeping your store information private and isolated.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript