Documentation
Feedback
Guides
API Reference

Guides
Guides

AI-assisted development

Learn how VTEX AI-powered tools help developers build on the platform faster with real-time documentation access and domain-specific AI skills.

Building on VTEX involves working across APIs, frameworks, and platform-specific requirements. To help AI coding assistants operate more effectively in that environment, VTEX provides two complementary tools: VTEX Developer MCP and VTEX Skills.

VTEX Developer MCP gives AI assistants access to VTEX documentation and API references during a task. VTEX Skills provides persistent context about VTEX-specific patterns, constraints, and best practices. Together, these tools help your assistant retrieve up-to-date information and apply platform-specific guidance more effectively.

VTEX Developer MCP

The @vtex/developer-mcp package is a Model Context Protocol (MCP) server that connects AI coding assistants to VTEX documentation and API specifications. It exposes four tools: documentation search, document fetching, endpoint search, and endpoint detail lookup.

No API key or authentication is required. To run it locally, use:


_10
npx -y @vtex/developer-mcp

VTEX Developer MCP works with Cursor, VS Code with GitHub Copilot, Claude Code, and Claude Desktop.

For setup instructions and available tools, see VTEX Developer MCP.

VTEX Skills

VTEX Skills is a catalog of 42 AI agent skills for VTEX platform development. The catalog is maintained from a single source and exported in six formats for different AI development tools.

These skills provide guidance on VTEX-specific implementation details, including topics such as Overrides API behavior, Payment Provider Protocol (PPP) endpoints, BFF patterns, and Master Data limits.

The catalog is organized into six tracks: Architecture, FastStore, Payment, VTEX IO, Marketplace, and Headless.

To install VTEX Skills, run:


_10
npx skills add vtex/skills

For installation options and the full catalog, see VTEX Skills.

How they work together

The MCP and Skills serve different purposes and complement each other well. Use VTEX Developer MCP when your assistant needs to search documentation, inspect API references, or retrieve information dynamically during a task.

Use VTEX Skills when your assistant benefits from persistent context about recommended patterns, known constraints, and platform-specific implementation guidance.

Using both tools together gives your assistant access to current reference material and reusable VTEX-specific context.

ToolPurposeInstallationSupported platforms
VTEX Developer MCPConnects AI assistants to VTEX documentation and API referencesnpx -y @vtex/developer-mcpCursor, VS Code, Claude Code, Claude Desktop
VTEX SkillsProvides VTEX-specific patterns, constraints, and best practices as a persistent AI contextnpx skills add vtex/skillsCursor, Copilot, Claude, AGENTS.md, OpenCode, Kiro

Next steps

Contributors
2
Photo of the contributor
Photo of the contributor
Was this helpful?
Yes
No
Suggest Edits (GitHub)
See also
VTEX Skills
Guides
Contributors
2
Photo of the contributor
Photo of the contributor
Was this helpful?
Suggest edits (GitHub)
On this page