# Magic Cloud

> Magic Cloud is a freemium MCP server for databases. Self-hosted backend that turns a database into secured APIs and MCP tools. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** self-hosted, Web, API, Linux, macOS, Windows
- **Website:** https://hyperlambda.dev
- **Repository:** https://github.com/polterguy/magic
- **MCP Registry name:** io.github.polterguy/magic
- **Categories:** databases, browser automation, developer tools
- **Listing updated:** 2026-11-14

## About

Magic Cloud is an MIT-licensed platform built on Hyperlambda, a language whose code is an AST that is checked against a whitelist before it runs. Its pitch is that an agent can be given a sandbox and a restricted vocabulary, and a bundled generator cannot return a function that does not exist. The registry entry shows the MCP endpoint lives on your own Magic instance, at /magic/modules/mcp/mcp, rather than a shared hosted URL.

Through it, an assistant can generate secured CRUD APIs over an existing SQL Server, MySQL, PostgreSQL or SQLite database, run SQL, manage files and tasks, and drive a headless browser. Every endpoint becomes an MCP tool behind role-based access control. The README also describes wrapping any OpenAPI or Swagger spec, background jobs, chatbots grounded in crawled content, and a Chat Ops agent that builds database, API and frontend from a description.

Run it with Docker Compose on your own hardware for free. AINIRO also sells managed cloudlets with a 14-day trial, billed per cloudlet rather than per user.

## Features

- **CRUD API generation:** Point it at a database and get a role-gated REST API.
- **Endpoints as MCP tools:** Every endpoint is exposed to MCP clients.
- **Sandboxed runtime:** Hyperlambda runs with no file access outside its sandbox and can whitelist functions.
- **SQL, files and tasks:** Run SQL and manage files and scheduled tasks.
- **Headless browser:** Drive a browser from the same instance.
- **OpenAPI wrappers:** Wrap third-party APIs from an OpenAPI or Swagger URL.

## Good for

- Put an agent on an existing SQL database with access control
- Generate an internal CRM or admin tool from a description
- Wrap a legacy system with an API
- Expose company endpoints to Claude or Cursor
- Run scheduled background jobs

## Install

### Claude Code (Terminal)

```sh
claude mcp add magic --env magic_host='<magic_host>' -- docker run -i --rm -e magic_host docker.io/servergardens/magic-aio:v24.4.23
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "magic": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "magic_host",
        "docker.io/servergardens/magic-aio:v24.4.23"
      ],
      "env": {
        "magic_host": "<magic_host>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "magic": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "magic_host",
        "docker.io/servergardens/magic-aio:v24.4.23"
      ],
      "env": {
        "magic_host": "<magic_host>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "magic": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "magic_host",
        "docker.io/servergardens/magic-aio:v24.4.23"
      ],
      "env": {
        "magic_host": "<magic_host>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "magic": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "magic_host",
        "docker.io/servergardens/magic-aio:v24.4.23"
      ],
      "env": {
        "magic_host": "<magic_host>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "magic": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "magic_host",
        "docker.io/servergardens/magic-aio:v24.4.23"
      ],
      "env": {
        "magic_host": "<magic_host>"
      }
    }
  }
}
```

## FAQ

### Is it free?

The runtime is MIT-licensed and free to self-host. Managed cloudlets are paid with a 14-day trial.

### How do I start it locally?

Run the Docker Compose file from hyperlambda.dev and log in at localhost:5555; change the default root password.

### Are app users billed?

On managed cloudlets, no. Billing is per cloudlet, not per user.

### Which databases work?

SQL Server, MySQL, PostgreSQL, MariaDB and SQLite are mentioned.

### Is Magic Cloud free?

Magic Cloud has a free plan, with paid plans for more usage or features.

### How do I add Magic Cloud to Claude Code?

Run this command in your terminal: claude mcp add magic --env magic_host='<magic_host>' -- docker run -i --rm -e magic_host docker.io/servergardens/magic-aio:v24.4.23

### What are the best alternatives to Magic Cloud?

The closest alternatives to Magic Cloud are REA, Browser Use, Scrapling MCP Server, Codebase Memory and GitHub.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Browser Use](https://ai-powered.com/mcp/browser-use): Browser Use is a freemium MCP server for browser automation.
- [Scrapling MCP Server](https://ai-powered.com/mcp/scrapling-mcp-server): Scrapling MCP Server is an open-source MCP server for web search and scraping.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/magic-cloud
