Connect your AI companion

Your companion joins your home as one of the household. Nothing to install, and it works from any device.

What you need

An AI app that can add a connector by web address. These are often called "custom connectors", "remote MCP servers" or "tools". The game does not charge for this and never sees your AI account; your AI app does the thinking.

Set it up once

1. In your AI app, add a new connector with this address:

   https://play.glitchedgarden.com/api/mcp

   It needs no sign-in and no key. Name it "Glitched Garden".
2. In the game, open Household and press Connect a companion, then Invite my companion. You will see your companion code.
3. Tell your companion: "Join my Glitched Garden game. My companion code is ABCDE-FGHJK." (use your own code).

Your code stays the same in this browser, so your companion can remember it. After the first time you only need to open the game and ask it to join. Talk to it in the game from Household, then Talk.

Where to add the connector

• Claude (web, desktop, phone): Settings, then Connectors, then Add custom connector. Paste the address above.
• Claude Code:

  claude mcp add --transport http glitched-garden https://play.glitchedgarden.com/api/mcp

• Other apps: look in settings for "MCP", "connectors" or "tools" and add a remote (HTTP) server with the address above. If your app only supports programs that run on your computer, use the local connector option in the game instead.

If your AI can make web requests but cannot add connectors

Give it these instructions along with your code:

You can join my Glitched Garden game over HTTP.
Read https://play.glitchedgarden.com/api/companion/guide for the list of tools.
To use one, POST JSON to https://play.glitchedgarden.com/api/companion/act
  {"code": "MY-CODE", "tool": "companion_join", "input": {}}
Start with companion_join to see who lives there, then call it again
with {"character": "Name"} to become one of them. Use "say" to talk to me
and "listen" to hear what I say and do.

Good to know

• Keep your code private. Anyone who has it can join your game while it is open. If it gets out, press New code in the game.
• You are in control. Press Stop or Disconnect at any time. Everything your companion builds can be undone like your own edits.
• The game must be open. Your companion can only join while your game is open in a browser tab.
• One character at a time. A companion plays one member of your household.

Trouble?

• "No open game has that code": open the game, check Household shows "Waiting for your companion", and read the code again.
• Your AI app will not accept the address: it may only support local connectors. Use "My AI uses a connector on this computer" in the game.
• It joined but went quiet: ask it to "listen" again. Companions only hear you when they are listening.