# Hanoo

> Hanoo is a freemium MCP server for cloud and infrastructure. Inspect and deploy Laravel and WordPress apps on your own Ubuntu servers. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $4 a month
- **Platforms:** Web, API
- **Website:** https://hanoo.io/docs/mcp
- **MCP Registry name:** io.hanoo/hanoo
- **Categories:** cloud and infrastructure, developer tools
- **Listing updated:** 2026-11-15

## About

Hanoo is a control panel for PHP applications on servers you own, and its MCP server exposes that panel to an assistant with a scoped API token or OAuth 2.1 sign-in. The assistant acts as the person who made the token and never beyond that person's access, and it only sees the tools the token allows.

Reads are the default: list_servers shows whether each server's agent is answering, get_server returns hardware, PHP versions and CPU, memory and disk use, and list_deployments reports each Git deployment's state, commit and per-step outcome without pipeline output. Changes are separate opt-ins: create_application, deploy_application, rollback_deployment, update_application_settings and update_application_php_settings. Every change needs an idempotency key and returns a job_id to follow with get_job; rollbacks also need confirm_live_change set to true and do not reverse database migrations.

Tokens expire after 7, 30 or 90 days, can be limited to named servers and applications, and are shown only once. Hanoo's own plans start free for one server.

## Features

- **Scoped API tokens:** Pick reads and each write permission separately, with 7, 30 or 90 day expiry.
- **OAuth sign-in:** Hosted clients connect without pasting a token.
- **Server inspection:** See server health, PHP versions and resource use.
- **Deploy and roll back:** Deploy a Git branch or restore a retained release.
- **Idempotent changes:** Each change takes an idempotency key and returns a job to follow.
- **Typed settings:** PHP and PHP-FPM settings are typed values, never raw config text.

## Good for

- Ask which servers stopped responding and since when
- Find applications still on PHP 8.2
- Find out why the last deployment failed
- Deploy the main branch of an app and follow the job
- Create a new Laravel application on a connected server

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http hanoo https://mcp.hanoo.io/mcp
```

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

```sh
https://mcp.hanoo.io/mcp
```

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

```json
{
  "mcpServers": {
    "hanoo": {
      "url": "https://mcp.hanoo.io/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "hanoo": {
      "type": "http",
      "url": "https://mcp.hanoo.io/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "hanoo": {
      "serverUrl": "https://mcp.hanoo.io/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "hanoo": {
      "type": "http",
      "url": "https://mcp.hanoo.io/mcp"
    }
  }
}
```

## Tools

- `whoami`: The organization, member and token this connection acts as.
- `list_servers`: Servers with agent status, OS, applications and operations in progress.
- `get_server`: One server's hardware, PHP versions and resource use.
- `list_applications`: Applications with type, state, server, domain and PHP version.
- `get_application`: One application's domains, TLS, runtime, source and latest deployment.
- `list_deployments`: An application's Git deployments and step outcomes.
- `get_job`: One operation by job id with state, timing and history.
- `create_application`: Creates an application from the pinned catalogue.
- `deploy_application`: Deploys a Git branch through a read-only deploy key.
- `rollback_deployment`: Makes a retained release live again.
- `update_application_settings`: Changes the application root and web root.
- `update_application_php_settings`: Replaces the named PHP and PHP-FPM settings set.

## FAQ

### How does it authenticate?

With OAuth 2.1 or a bearer API token.

### Can the assistant make changes?

Only if the token grants it; writes are separate opt-ins.

### Does rollback undo database migrations?

No.

### What does Hanoo cost?

Free for 1 server and 8 apps; Starter $4/month, Pro $8/month, Agency $15/month.

### Is Hanoo free?

Hanoo has a free plan, with paid plans for more usage or features. Paid plans start at $4 a month.

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

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

### What are the best alternatives to Hanoo?

The closest alternatives to Hanoo 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/hanoo
