MCP server wrapping the magento-cloud CLI for database queries, logs, and environment management
Quick Install
Automated & IDE SetupCopy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.
Not yet automatically verified
We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.
Manual Client & Custom JSON ConfigExpand JSON ▾
Client Config & Setup
Choose your client or environment
Target File:
💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.
Documentation Overview
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
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:
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:
If using an API token instead of browser login, add the environment key:
Claude Desktop
In claude_desktop_config.json:
Gemini CLI
In ~/.gemini/settings.json:
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
Development
License
MIT
Related MCP Servers
Reviews
No reviews yet — be the first to share how this listing worked for you.
Frequently Asked Questions about Magento Cloud MCP Server
AllMCPs Directory Badge
Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.
Badge Style:
Live Dynamic SVG Preview
Markdown (GitHub README)
[](https://allmcps.com/mcp/magento-cloud-mcp-server)HTML Embed
<a href="https://allmcps.com/mcp/magento-cloud-mcp-server"><img src="https://allmcps.com/api/badge/magento-cloud-mcp-server?style=directory" alt="Magento Cloud MCP Server on AllMCPs" /></a>Technical Specs & Signals
CategoryDatabases
36Quality signal: Fair · 36/100How this signal is calculated ▾
Server availabilityNot measured
Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.
Verified ownership10/20
Documentation & tools16/30
Adoption & activity1/15
Community engagement0/10
A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.
Own this project?
This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge — proof is checked automatically, then reviewed by our team.
Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.
Claim & get free dofollowShare & Embed
Add our SVG badge (dark/light directory styles) or embeddable widget to your site.