---
name: ruumix-mcp-setup
description: Install, sign in to, and verify the official Ruumix MCP server in a user's agent. Use when the user wants to connect Ruumix for the first time or fix a missing or expired Ruumix MCP connection.
---

# Connect Ruumix MCP

Use the official remote endpoint `https://www.ruumix.ai/api/mcp`. Ruumix uses browser-based OAuth and requires a Ruumix account with a verified email.

1. Identify the user's agent client. If the current client and its MCP settings are known, use them. Otherwise, ask which client they use. Check for an existing Ruumix connection before adding a duplicate or changing an existing entry.
2. If the client is Codex CLI, use its MCP commands:

   ```sh
   codex mcp list
   codex mcp add ruumix --url https://www.ruumix.ai/api/mcp
   ```

   Run the add command only if the official server is missing. If Ruumix is listed but the browser does not open or authorization has expired, run:

   ```sh
   codex mcp login ruumix
   ```

   For other clients, use the client's documented steps for adding a remote MCP server with OAuth. If you cannot configure the client directly, give the user the steps and the endpoint. For Codex setup details, see https://www.ruumix.ai/mcp.
3. Let the user sign in to Ruumix and approve access in their browser. Keep passwords and verification codes in the sign-in flow. If the client needs a new session to discover MCP tools, ask the user to open one.
4. Call Ruumix's read-only `get_account` tool when it becomes available. A successful response confirms the connection and does not spend Ruumix credits. If you cannot call the tool yet, tell the user which setup step remains, or ask them to send “Show my available Ruumix credits” in their connected session.

Finish after the connection check. Leave project creation and design generation for a separate user request.
