ClearCrowds

MCP Setup

Connect Codex, Claude Code, or Cursor to edit photos and generate images with your ClearCrowds account.

MCP server URL
https://app.clearcrowds.com/api/agent/mcp

Connect and install

  1. Sign in to ClearCrowds, choose Connect an Agent in the editor sidebar, and select your assistant.
  2. Codex can open with the setup prompt prefilled. In other local clients, copy and send the setup prompt. It includes both MCP configuration and personal image Skill installation. Cursor's native install link adds only MCP; send the full prompt to install the Skill too.
  3. Check your account in the browser, choose Allow connection, then return to the client to complete sign-in.
  4. The Agent checks your account and available capabilities. Setup and connection checks do not generate images or spend credits.

My connections shows verified connections. Use the pencil to name a device, such as “Work laptop · Codex.” Existing connections can copy the Skill setup instructions to add the Skill. Verify that the client can find the installed Skill before invoking it.

Invoke ClearCrowds

ClientExplicit invocationSkill location
Codex$clearcrowds~/.agents/skills/clearcrowds/SKILL.md
Claude Code/clearcrowds~/.claude/skills/clearcrowds/SKILL.md
Cursor/clearcrowds~/.cursor/skills/clearcrowds/SKILL.md
Pi/skill:clearcrowds~/.pi/agent/skills/clearcrowds/SKILL.md

You can also ask “Use ClearCrowds to fix this photo” in clients that select matching Skills automatically. If a new Skill is missing, refresh or start a new session as required by your client. Pi supports /reload.

Browser-based Claude and Grok use remote MCP and natural language; connecting does not install a Skill on your computer. Other clients choose their supported setup method. Pi needs an installed adapter that supports remote MCP; there is no universal Pi MCP install command. There is also no universal @clearcrowds command across clients.

Try editing a photo

  1. Choose an assistant in My connections, then Share a photo and explicitly select an image.
  2. Try a city background, text replacement, or background people removal. Edit the request and send the resulting prompt. It identifies the exact selected photo.
  3. The Agent directly edits the photo using existing credits after your clear request, without asking for credit-cost confirmation. It returns a preview and an editor link; the result is saved in that photo's edit history.
Example editing prompt
Use ClearCrowds to replace the background of my shared photo with a city at night. Preserve the person's appearance and pose, and blend the lighting naturally.

You can also select a local image for the Agent. The client uploads it before editing. A remote MCP server cannot read a local path or chat attachment by itself; attachment access depends on the client.

Manual MCP configuration

Use Streamable HTTP and approve the connection in your browser. These commands target the production service. For local testing, use the address generated by the editor.

Codex

Terminal
codex mcp add clearcrowds --url https://app.clearcrowds.com/api/agent/mcp
codex mcp login clearcrowds

Claude Code

Terminal
claude mcp add --transport http --scope user clearcrowds https://app.clearcrowds.com/api/agent/mcp

Open Claude Code, run /mcp, select clearcrowds, and complete browser authorization. In Cursor and other remote MCP clients, add the remote address in MCP settings and sign in when prompted.

Download the personal image Skill (SKILL.md) and save it in the corresponding directory above. It includes the MCP address, explicit photo selection, local uploads, text-to-image generation, direct editing, job polling and returning to the editor.

Generate an image from text

Tell your connected Agent what you want, for example: “Create a landscape image of a small cabin beside a lake at sunrise.” No upload or shared photo is needed.

The Agent calls quote_generation with your prompt and optional aspect_ratio (1:1, 3:2, 2:3, 16:9, 9:16), then immediately calls generate_image with that quote. A clear generation request authorizes use of existing personal credits; no credit-cost confirmation step is required. An explicit budget still applies. Capacity is reserved at submission and charged only after the result is durably delivered. Failed tasks release the reservation.

The Agent reuses the exact quote on a retry, polls get_job, and returns the preview and editor_url. Results appear in your ClearCrowds history and can be edited through the same connection. Setup checks alone never generate images or consume credits.

Credits, permissions and troubleshooting

  • Which balance is used? Personal plans use the same balance as the editor. On an AppSumo lifetime plan, MCP uses the API Credits in your developer project. Your monthly AppSumo credits are for edits in the ClearCrowds app. Credits are never purchased automatically.
  • How do I use MCP with an AppSumo lifetime plan? Sign in with the same ClearCrowds account, set up API access and add API Credits in the Developer Console. If you have more than one active project, choose which one to use when the agent asks. The MCP connection uses browser sign-in and does not require you to share an API key with the agent.
  • Missing photo? Explicitly share it with this connection, then send a fresh editing prompt.
  • Signed in but tools are unavailable? Refresh the client's MCP tools and check account and capabilities. Opening an authorization page alone does not complete the token exchange or verify the connection.
  • Why a system credential prompt? The client manages OAuth credential storage. ClearCrowds does not read your keychain or ask for credentials in chat.
  • How do I disconnect? Disconnect in My connections to revoke access immediately. The Agent can access only explicitly shared photos, images uploaded through its connection and results created through that connection, not the entire library.

Developer integrations use separate API Credits and CLI workflows.