MCP server for Adobe Commerce Cloud — REST API + SSH, no PHP CLI required
MCP (Model Context Protocol) server for Adobe Commerce Cloud. Allows AI agents to interact with Magento Cloud projects — query databases, read logs, list environments, inspect activities, and more.
No PHP CLI required — uses the REST API and SSH directly.
| Version | Description | Requirements |
|---|---|---|
| v2.x (latest) | REST API + SSH directly. Browser login or API token. | Node.js 20+, ssh binary |
| v1.x | Wraps the magento-cloud PHP CLI. | Node.js 20+, magento-cloud CLI installed |
# Latest (v2.x)
npx -y mcp-magento-cloud
# v1.x (requires magento-cloud CLI)
npx -y mcp-magento-cloud@1.0.1
ssh binary — Available by default on Linux/macOSNo setup required. The first time you use any tool, a browser window will open automatically for OAuth2 login via your Adobe/Magento account. Credentials are stored locally in ~/.config/mcp-magento-cloud/credentials.json and refreshed automatically.
You can also login manually:
npx -y -p mcp-magento-cloud mcp-magento-cloud-login
If you prefer using an API token (e.g. for CI/CD), create one at https://accounts.magento.cloud/user/api-tokens and pass it as an environment variable (MAGENTO_CLOUD_CLI_TOKEN). When a token is set, browser login is skipped.
Security note: API tokens grant full access to all projects your account has access to. Treat them as sensitive secrets. If a token is compromised, revoke it immediately at the URL above.
In ~/.config/kilo/kilo.json:
{
"mcp": {
"magento-cloud": {
"type": "local",
"command": ["npx", "-y", "mcp-magento-cloud"]
}
}
}
If using an API token instead of browser login, add the environment key:
{
"mcp": {
"magento-cloud": {
"type": "local",
"command": ["npx", "-y", "mcp-magento-cloud"],
"environment": {
"MAGENTO_CLOUD_CLI_TOKEN": "your-api-token-here"
}
}
}
}
In claude_desktop_config.json:
{
"mcpServers": {
"magento-cloud": {
"command": "npx",
"args": ["-y", "mcp-magento-cloud"]
}
}
}
In ~/.gemini/settings.json:
{
"mcpServers": {
"magento-cloud": {
"command": "npx",
"args": ["-y", "mcp-magento-cloud"]
}
}
}
| Tool | Description |
|---|---|
list_projects | List all projects available to the current user |
list_environments | List all environments for a project |
get_environment_info | Get detailed info about an environment |
get_environment_urls | Get the public URLs of an environment |
list_activities | List recent activities with filters |
get_activity_log | Display the full log for an activity |
list_variables | List project or environment variables |
list_services | List services with versions and disk allocation |
| Tool | Description |
|---|---|
execute_sql | Execute a read-only SQL query on the remote database |
get_environment_logs | Read server logs (deploy, error, cron, etc.) |
get_environment_relationships | Get service connection details (host, port, credentials) |
list_log_types | List available log types |
| Tool | Description |
|---|---|
set_cloud_config | Set a Magento config value via bin/magento config:set over SSH (supports scope/scope_code and encrypted values). Blocked on the production environment. |
create_branch | Create a new environment branch cloned from integration |
push_branch | Push a local git branch to the project using SSH certificate auth |
set_cloud_config refuses to run against the production environment; such changes must be made manually0600 permissions# Browser login will open automatically on first tool use
npx @modelcontextprotocol/inspector node dist/main.js
# Or with API token
MAGENTO_CLOUD_CLI_TOKEN=your-token npx @modelcontextprotocol/inspector node dist/main.js
git clone https://github.com/juan-cinto-infracommerce/mcp-magento-cloud.git
cd mcp-magento-cloud
npm install
npm run build
npm start
MIT
Source-derived launch command. Check the maintainer’s required arguments and credentials before running:
npx -y mcp-magento-cloudMerge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.
{
"mcpServers": {
"io-github-juan-cinto-infracommerce-magento-cloud": {
"command": "npx",
"args": [
"-y",
"mcp-magento-cloud"
]
}
}
}Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.
Claude Desktop setup referencemcp-magento-cloudnpmMagento Cloud MCP Server works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.
~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.~/.cursor/mcp.jsonRestart Cursor for changes to take effect..vscode/mcp.jsonReload VS Code window for changes to take effect.~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect..mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.