Quickstart

Install mage-agent

pip install mage-agent

Verify the install:

mage-agent --version

mage-agent login

The CLI prompts for your cluster URL, email, and password. On success, credentials are saved to ~/.mage-agent/config.json.

To skip the prompts, pass flags directly:

mage-agent login \
  --cluster-url https://your-mage-url \
  --email YOUR_EMAIL \
  --password YOUR_PASSWORD

Connect your AI assistant

Add the following to your IDE’s MCP server config and restart the client:

{
  "mcpServers": {
    "mage-agent": {
      "command": "mage-agent",
      "args": ["mcp"]
    }
  }
}

See IDE Integration for client-specific setup instructions.

Try it

Ask your AI assistant:

“List all my Mage pipelines”

“Create a new Python transformer block in the customer_etl pipeline”

“Run the daily_refresh pipeline and show me the logs”

The assistant calls the appropriate MCP tool automatically — no manual API calls required.

Next steps