home / mcp / vtex headless cms mcp server

VTEX Headless CMS MCP Server

MCP Server generated by mcp.ag2.ai

Installation
Add the following to your MCP client configuration file.

Configuration

View docs
{
  "mcpServers": {
    "ag2-mcp-servers-vtex-headless-cms": {
      "command": "python",
      "args": [
        "mcp_server/main.py",
        "stdio"
      ],
      "env": {
        "CONFIG": "{...}",
        "SECURITY": "YOUR_API_KEYS_OR_SECURITY_VARS",
        "CONFIG_PATH": "mcp_server/mcp_config.json"
      }
    }
  }
}

You run an MCP server that exposes a context-aware API for your data source and lets clients interact with it using the MCP protocol. This server is configured to start locally via a stdio-based runtime and supports flexible environment variables to control security and configuration. It is designed to be easy to run from your development or CI environment and to work with MCP clients that expect a local server you can start with a single command.

How to use

To use the MCP server, start it in stdio mode and connect your MCP client to the local process. The server loads its configuration from environment variables you provide, so you can customize security keys and file-based config without editing code.

How to install

Prerequisites: Python 3.9 or newer, and the uv runner. You will install dependencies and then run the server.

# Install Python dependencies for development and runtime
pip install -e ".[dev]"

# Alternatively, run with uv if you prefer an editable install
uv pip install --editable ".[dev]"

Additional sections

Configuration and runtime are controlled via environment variables. The following variables influence how the server starts and authenticates requests.

Key environment variables to know: - CONFIG_PATH: Path to a JSON configuration file (for example, mcp_server/mcp_config.json). - CONFIG: A JSON string containing the configuration. - SECURITY: Environment variables that control security parameters (such as API keys or access controls).

Available tools

lint

Run linting and formatting checks to ensure code quality and style consistency.

staticAnalysis

Perform static analysis for type safety and security checks (mypy, bandit, semgrep).

tests

Execute tests with coverage reports to verify functionality.

precommit

Use pre-commit hooks to run checks before committing changes.