MCP Server

redu.cloud provides a Model Context Protocol (MCP) server at mcp.redu.cloud. Connect it to Claude Code, Claude.ai, or ChatGPT to manage your cloud infrastructure in natural language.


Create a large Ubuntu instance called web-prod with my default keypair


What instances am I running? Stop the staging one.


Deploy a reduOS instance and give me the SSH command when it's ready.

Connect from Claude Code

Add the server to your Claude Code settings. You need a redu.cloud API key — generate one at Account → API Keys.

Open ~/.claude/settings.json and add:


{
  "mcpServers": {
    "redu-cloud": {
      "url": "https://mcp.redu.cloud/mcp",
      "headers": {
        "x-api-key": "YOUR_REDU_CLOUD_API_KEY"
      }
    }
  }
}

Restart Claude Code. The redu.cloud tools will appear automatically.

Connect from Claude.ai

Claude.ai supports MCP servers (rolling out 2025–2026).

Open Claude.ai → Settings → Integrations → Add MCP server
Enter: https://mcp.redu.cloud/mcp
Authenticate with your redu.cloud account (OAuth via Keycloak)

Connect from ChatGPT

redu.cloud works as a ChatGPT Custom GPT Action.

Create a Custom GPT → Configure → Actions
Set the schema URL to: https://mcp.redu.cloud/.well-known/oauth-protected-resource
Authentication: OAuth 2.0 — use your redu.cloud Keycloak credentials

Available tools

Tool	What it does
`list_instances`	List your running instances
`list_flavors`	List available instance sizes
`list_images`	List available OS images
`list_keypairs`	List your SSH keypairs
`list_private_networks`	List your private networks
`list_security_groups`	List your security groups
`list_volumes`	List your block storage volumes
`list_snapshots`	List instance snapshots
`list_backups`	List volume backups
`list_clusters`	List autoscaling clusters
`list_domains`	List your verified custom domains
`plan_instance`	Get all options needed to create an instance
`create_instance`	Create a new instance
`delete_instance`	Delete an instance
`instance_action`	Start, stop, or reboot an instance
`get_ssh_command`	Get the SSH command for an instance
`get_instance_logs`	Get console log output
`create_snapshot`	Snapshot an instance
`delete_snapshot`	Delete a snapshot
`create_volume`	Create a block storage volume
`get_domain_verification`	Get TXT record for domain ownership
`whoami`	Show your authenticated account

Example: create an instance

Ask Claude Code or Claude.ai:

“Create a medium Ubuntu instance called api-server with my default keypair. Use the first available network.”

Claude will call plan_instance to gather the options, then create_instance with the right IDs. You don’t need to know image IDs or flavor IDs.

Example: deploy reduOS

“Deploy a reduOS full-stack instance on a large flavor.”

Claude will call create_instance with cloud_init_template: "reduos", which automatically:

Picks port 3006 for the dashboard DNS entry
Injects the full reduOS setup cloud-init
Starts setup in the background (takes 15–25 min)

After creation, ask:

“Check if the reduOS instance is ready and give me the SSH command.”

API key vs OAuth

Method	Best for	How
API key	Claude Code, scripts, local tools	`x-api-key` header in settings
OAuth (Keycloak)	Claude.ai, ChatGPT	Browser-based login flow

Generate an API key at console.redu.cloud/category/user/api-keys .