Integrations

MCP Server

Give your agent the power to create. Connect by URL — no download, no npx, no config file — and generate images, videos, and edits via tool-calling, using your account and your credits.

Connect in 3 steps

Caranguejo's hosted MCP endpoint is the same for any client:

url

https://mcp.caranguejo.art/mcp

Copy the URL

The block above — it's the same endpoint for any MCP client.

Add the connector

In Claude, open Settings → Connectors, add a custom connector named "Caranguejo", and paste the URL. In Cursor: Settings → MCP → Add, same URL. Open connectors in Claude

Connect and sign in

Click Connect and log in with your Caranguejo account (OAuth) — done. Just ask the agent to generate.

Advanced: headless agents

Claude Code, terminal agents, and other clients without a connectors UI use the same URL with an auth header:

http

https://mcp.caranguejo.art/mcp
Authorization: Bearer ck_live_xxxxxxxx

One command, with remote transport:

bash

claude mcp add --transport http caranguejo https://mcp.caranguejo.art/mcp \
  --header "Authorization: Bearer ck_live_xxxxxxxx"

Clients without remote MCP support can still run the package locally via stdio:

claude_desktop_config.json

{
  "mcpServers": {
    "caranguejo": {
      "command": "npx",
      "args": ["-y", "@caranguejo/mcp"],
      "env": { "CARANGUEJO_API_KEY": "ck_live_xxxxxxxx" }
    }
  }
}

Grab your ck_live_… key at Account → Apps & API. Optional: CARANGUEJO_BASE_URL to point at a different API on the legacy path.

Available tools

Tool	What it does	Key args
`generate`	Generic generation with any model (image, video, or tool). Waits for the result by default.	`model`, `prompt`, `image_urls`, `params`
`generate_image` image	Shortcut for text-to-image / editing.	`prompt`, `quality`, `resolution`, `size`, `image_urls`
`generate_video` video	Shortcut for text-to-video / image-to-video.	`model`, `prompt`, `image_url`, `duration_seconds`, `aspect_ratio`
`run_tool` tool	Upscale / relight / enhance / inpaint on a piece of media.	`model`, `input_url`, `params`
`get_generation_status`	Checks a job and returns the output URLs.	`id`
`upload_file`	Hosts a local file and returns a public URL for reference.	`path`
`list_models`	Lists the model catalog and its capabilities.	`type` (optional)
`list_generations`	Lists your generations via the API.	`limit`, `cursor`
`get_balance`	Account credit balance.	—

Browsable resources: caranguejo://models (live capabilities) and caranguejo://pricing (credit matrix).

In practice

Once configured, just ask in natural language. Examples:

"Generate a food delivery app mockup, iOS style, 3:2, high quality." → the agent calls generate_image.
"Animate this photo spinning 360°, 5s, 9:16." (attach the image) → upload_file + generate_video.
"Upscale this image 4×." → run_tool with the upscale model.