Connection	Use it when	URL
Account MCP	The client asks for one server URL, or you want it to create its own private room	`https://freakout.ai/api/mcp/account`
Room MCP	You are already in a saved Room Editor and want the client to work in that room	copied from `Agent access`
Manual token	The client does not support OAuth for remote MCP servers	copied from `Agent access`

OAuth connections are preferred. The prompt contains no token; your MCP client signs in through the browser and stores the tokens itself.

Account MCP#

Use the account URL when a client has a custom connector screen that only asks for an MCP URL.

Add this server URL in the MCP client:
```
https://freakout.ai/api/mcp/account
```
Start the client authentication flow.
Sign in to Freakout if the browser asks.
Choose the shop the agent may use.
Review the permission controls.
Select Allow.

Freakout creates a private workspace room for that client and shop. Reconnecting the same client in the same shop returns it to that room when the connection is still valid.

Room MCP#

Use the Room MCP URL when you want the client to work in a specific saved room.

Open the saved room in the Room Editor.
Select Agent access in the top toolbar.
Copy the setup prompt.
Paste the prompt into the MCP client.
If the client is not configured yet, run the command shown in the prompt.
Authenticate the server from the client.
Approve the browser request in the Room Editor.
Ask the client to read the room before it changes anything.

The copied prompt includes the room URL, the MCP server URL, and client-specific command examples. It does not include a secret.

Client Commands#

Use the room-specific server name and URL from the copied prompt.

claude mcp add --transport http freakout-room-abc123 https://freakout.ai/api/mcp/rooms/<roomId>

codex mcp add freakout-room-abc123 --url https://freakout.ai/api/mcp/rooms/<roomId>

codex mcp login freakout-room-abc123

In Claude Code, use /mcp, choose the Freakout server, then select Authenticate.

Permissions#

The consent screen controls what the client may do.

Permission	Allows
`Edit this room`	Read room data, preview room drafts, and save room changes
`Agent has write permission`	Save changes and create new private rooms
`Allow Agent Spend`	Generate images and 3D assets within the selected credit limit

Generation uses the approved connection budget. The client can read quotes before spending, and it cannot buy credits, change subscriptions, or publish a room.

Working With the Client#

Ask the client to:

Call room_read first.
Use room_list to see which rooms the connection can work in and which one is active. The list covers the room you connected plus rooms the client created. Rooms that already existed in the shop are not included.
Use shop_media_list when it needs product images, videos, or existing 3D models.
Use room_preview before saving visual ideas.
Save with room_patch or room_upsert only after you approve the direction.
Use the latest updatedAt value when saving.

Keep the Room Editor open while reviewing preview drafts. If you have unsaved local edits, Freakout will not silently replace them with agent changes.

Disconnect#

Open Agent access in the Room Editor and disconnect the active agent connection. The current access token stops working immediately and refreshes fail.

Welcome

Overview