Server data from the Official MCP Registry
MCP server for Adobe Commerce Cloud — REST API + SSH, no PHP CLI required
About
MCP server for Adobe Commerce Cloud — REST API + SSH, no PHP CLI required
Security Report
This MCP server for Adobe Commerce Cloud has solid architecture with proper authentication, input validation, and security guardrails (SQL validation, production environment protection). However, there are moderate concerns around credential storage security (file permissions in home directory), overly broad SSH command execution, and credential handling edge cases. Permissions align reasonably with the server's purpose. Supply chain analysis found 3 known vulnerabilities in dependencies (0 critical, 3 high severity). Package verification found 1 issue.
6 files analyzed · 14 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
Permissions Required
This plugin requests these system permissions. Most are normal for its category.
How to Install
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-juan-cinto-infracommerce-magento-cloud": {
"args": [
"-y",
"mcp-magento-cloud"
],
"command": "npx"
}
}
}Documentation
View on GitHubFrom the project's GitHub README.
mcp-magento-cloud
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.
Versions
| 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 |
Using a specific version
# Latest (v2.x)
npx -y mcp-magento-cloud
# v1.x (requires magento-cloud CLI)
npx -y mcp-magento-cloud@1.0.1
Prerequisites (v2.x)
- Node.js 20+
sshbinary — Available by default on Linux/macOS
Quick Start
Authentication
Automatic browser login (recommended)
No 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
API token (alternative)
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.
Configure your MCP client
Kilo
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"
}
}
}
}
Claude Desktop
In claude_desktop_config.json:
{
"mcpServers": {
"magento-cloud": {
"command": "npx",
"args": ["-y", "mcp-magento-cloud"]
}
}
}
Gemini CLI
In ~/.gemini/settings.json:
{
"mcpServers": {
"magento-cloud": {
"command": "npx",
"args": ["-y", "mcp-magento-cloud"]
}
}
}
Available Tools
REST API Tools
| 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 |
SSH Tools
| 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 |
Write Tools
| 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 |
Security
- SQL queries are validated — only SELECT, SHOW, DESCRIBE, and EXPLAIN are allowed
- SQL comments are stripped and multiple statements are blocked to prevent injection
- Production is protected —
set_cloud_configrefuses to run against theproductionenvironment; such changes must be made manually - SSH authentication uses temporary Ed25519 certificates signed by the Magento Cloud API
- Browser login stores refresh tokens locally with
0600permissions - API tokens should be treated as sensitive secrets — they grant full access to all projects
Testing with MCP Inspector
# 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
Development
git clone https://github.com/juan-cinto-infracommerce/mcp-magento-cloud.git
cd mcp-magento-cloud
npm install
npm run build
npm start
License
MIT
Reviews
No reviews yet
Be the first to review this server!
More Developer Tools MCP Servers
Fetch
Freeby Modelcontextprotocol · Developer Tools
Web content fetching and conversion for efficient LLM usage
Git
Freeby Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
mcp-creator-python
Freeby mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
MarkItDown
Freeby Microsoft · Content & Media
Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption
MCP Marketplace
Freeby mcp-marketplace · Developer Tools
Search and install MCP servers from inside your AI client.
