# Gheima

> Gheima is a freemium MCP server for cloud and infrastructure. Deploy and manage apps, databases and storage on Gheima from an AI assistant. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** Web, CLI, API
- **Website:** https://gheima.ma/docs/ai-assistants
- **MCP Registry name:** io.github.gheima/mcp
- **Categories:** cloud and infrastructure, developer tools
- **Listing updated:** 2026-11-15

## About

Gheima is a cloud platform that bills in Moroccan dirhams, and this server lets an assistant look after the services you run on it. The hosted endpoint at gheima.ma/mcp signs you in through the browser, where you pick read-only or read-and-write access. The assistant then gets an API key scoped to that choice, which appears in Settings as an MCP key you can revoke.

With it an assistant can see services, deployments, logs and metrics and explain a failed deploy, restart, pause, resume and scale a service, list databases, take snapshots and browse storage buckets. It can also read and run cron jobs and check usage, the current bill, domains, alerts and the audit log. Deleting, rotating or resetting anything needs explicit confirmation, and everything the assistant does is recorded in the audit log under the MCP surface.

A local stdio version via npx runs with the key saved by `gheima login`. Writes are refused there unless GHEIMA_MCP_ALLOW_WRITES=1 is set, and revealing credentials needs GHEIMA_MCP_ALLOW_SECRETS=1 plus a confirmation on each call. The pricing page says the platform is in private beta with invite-only sign-ups.

## Features

- **Hosted and local modes:** Connect to the hosted URL, or run the npm package over stdio.
- **Scoped API keys:** Choose read-only or read-and-write at sign-in, and revoke the key from Settings.
- **Deploy and scale services:** Deploy, restart, pause, resume and scale services from chat.
- **Logs and failure analysis:** Read logs and metrics and ask why a deploy failed.
- **Billing and usage checks:** See usage, the current bill, domains and alerts.
- **Audit trail:** Assistant actions are logged separately from your own.
- **Built-in prompts:** Ready-made prompts such as why a deploy failed or what the month will cost.

## Good for

- Ask why the last deploy failed and get the relevant logs
- Scale or restart a service without opening the dashboard
- Snapshot a database before a risky change
- Check how much of this month's allowance is used
- Review which actions an assistant took on your account

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http mcp https://gheima.ma/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://gheima.ma/mcp
```

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

```json
{
  "mcpServers": {
    "mcp": {
      "url": "https://gheima.ma/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "mcp": {
      "type": "http",
      "url": "https://gheima.ma/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp": {
      "serverUrl": "https://gheima.ma/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp": {
      "type": "http",
      "url": "https://gheima.ma/mcp"
    }
  }
}
```

## FAQ

### Who can connect an assistant?

Only an owner or admin, because connecting creates an API key.

### Can the assistant change things by default?

On the hosted server you choose read-only or read-and-write at sign-in. Locally, writes are off unless GHEIMA_MCP_ALLOW_WRITES=1 is set.

### Can it read my database password?

The hosted server never reads credentials. The local server can reveal them only with GHEIMA_MCP_ALLOW_SECRETS=1 and a confirmation on each call.

### Is Gheima open to everyone?

The pricing page says it is in private beta and new accounts are by invite for now.

### Is Gheima free?

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

### How do I add Gheima to Claude Code?

Run this command in your terminal: claude mcp add --transport http mcp https://gheima.ma/mcp

### What are the best alternatives to Gheima?

The closest alternatives to Gheima are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [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.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/gheima
