Magento Cloud MCP Server

io.github.juan-cinto-infracommercePublished by GitHub account juan-cinto-infracommercev2.4.0Updated Oct 24, 2026

MCP server for Adobe Commerce Cloud — REST API + SSH, no PHP CLI required

The publisher's own server: magento.watch

VerifiedSTDIODesktop onlyDatabasesCloud & InfrastructureDeveloper Tools

Overview

AI-generated overview

Local MCP server that lets an AI assistant inspect and manage Adobe Commerce Cloud projects via the REST API and SSH, without the PHP CLI.

What you can do
List projects, environments, environment details and URLs, activities and their logs, variables, and services with versions and disk allocation via the REST API. Run read-only SQL queries against a remote environment database. Read server logs and list available log types. Retrieve service connection details such as host, port and credentials. Set Magento config values over SSH, create environment branches, and push local git branches.
When to use it
Useful when you work with Adobe Commerce Cloud projects and want an assistant to survey environments, read logs and activities, run read-only database queries, or make scoped configuration and branch changes without installing the Magento Cloud PHP CLI.
Requirements
Runs locally via npx as an npm package; needs Node.js 20+ and an ssh binary (default on Linux and macOS). Authentication is either an automatic browser OAuth2 login with an Adobe/Magento account, or an API token supplied in the MAGENTO_CLOUD_CLI_TOKEN environment variable. Desktop client only.
Before you install
API tokens grant full access to every project the account can reach and should be treated as sensitive secrets; revoke a compromised token immediately. Browser login stores refresh tokens locally. Write tools change remote state: set_cloud_config alters Magento configuration (blocked on production), create_branch creates environments, and push_branch pushes git branches. Service relationship output can expose database credentials.

Installation

In SourceWeft

  1. Open Magento Cloud MCP Server in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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

VersionDescriptionRequirements
v2.x (latest)REST API + SSH directly. Browser login or API token.Node.js 20+, ssh binary
v1.xWraps the magento-cloud PHP CLI.Node.js 20+, magento-cloud CLI installed

Using a specific version

bash
# Latest (v2.x)npx -y mcp-magento-cloud
# v1.x (requires magento-cloud CLI)npx -y [email protected]

Prerequisites (v2.x)

  • Node.js 20+
  • ssh binary — 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:

bash
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:

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:

json
{  "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:

json
{  "mcpServers": {    "magento-cloud": {      "command": "npx",      "args": ["-y", "mcp-magento-cloud"]    }  }}
Gemini CLI

In ~/.gemini/settings.json:

json
{  "mcpServers": {    "magento-cloud": {      "command": "npx",      "args": ["-y", "mcp-magento-cloud"]    }  }}

Available Tools

REST API Tools

ToolDescription
list_projectsList all projects available to the current user
list_environmentsList all environments for a project
get_environment_infoGet detailed info about an environment
get_environment_urlsGet the public URLs of an environment
list_activitiesList recent activities with filters
get_activity_logDisplay the full log for an activity
list_variablesList project or environment variables
list_servicesList services with versions and disk allocation

SSH Tools

ToolDescription
execute_sqlExecute a read-only SQL query on the remote database
get_environment_logsRead server logs (deploy, error, cron, etc.)
get_environment_relationshipsGet service connection details (host, port, credentials)
list_log_typesList available log types

Write Tools

ToolDescription
set_cloud_configSet a Magento config value via bin/magento config:set over SSH (supports scope/scope_code and encrypted values). Blocked on the production environment.
create_branchCreate a new environment branch cloned from integration
push_branchPush 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_config refuses to run against the production environment; 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 0600 permissions
  • API tokens should be treated as sensitive secrets — they grant full access to all projects

Testing with MCP Inspector

bash
# Browser login will open automatically on first tool usenpx @modelcontextprotocol/inspector node dist/main.js
# Or with API tokenMAGENTO_CLOUD_CLI_TOKEN=your-token npx @modelcontextprotocol/inspector node dist/main.js

Development

bash
git clone https://github.com/juan-cinto-infracommerce/mcp-magento-cloud.gitcd mcp-magento-cloudnpm installnpm run buildnpm start

License

MIT

Source: README.md at commit edd5c9d

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v2.4.0LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Magento integrations

magento.watch

watch.magentoOfficial publisher

A remote MCP server that gives an assistant Magento Open Source, Adobe Commerce and Mage-OS release, lifecycle, compatibility, CVE and patch information.

Streamable HTTPWeb executable
Developer Tools13 toolsOct 24, 2026

Magento MCP by InsightfulPipe

com.insightfulpipe

Hosted remote MCP server that lets an AI assistant read and manage a Magento 2 or Adobe Commerce store's products, orders, inventory and sales.

Streamable HTTPWeb executableAuth
Data & AnalyticsCredential requiredOct 27, 2026