> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cherryshot.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Use from Claude (MCP)

> Add Cherry Shot as an MCP server and generate by chatting.

Cherry Shot ships a remote [Model Context Protocol](https://modelcontextprotocol.io) server,
so any MCP client — Claude Desktop, Claude Code, Cursor — can generate shoots and videos
directly. It's a thin layer over this API and uses the same API key and credits.

## Server details

<ParamField path="URL" type="string">
  `https://ybhqmgyprapjxomdxifs.supabase.co/functions/v1/mcp`
</ParamField>

<ParamField path="Transport" type="string">
  Streamable HTTP
</ParamField>

<ParamField path="Auth" type="string">
  `Authorization: Bearer cs_your_key`
</ParamField>

## Add it to Claude

<Tabs>
  <Tab title="Claude Desktop / claude.ai">
    Settings → **Connectors** → **Add custom connector**, then paste the URL above and add
    your API key as a bearer token.
  </Tab>

  <Tab title="Claude Code">
    ```bash theme={null}
    claude mcp add --transport http cherry-shot \
      https://ybhqmgyprapjxomdxifs.supabase.co/functions/v1/mcp \
      --header "Authorization: Bearer cs_your_key"
    ```
  </Tab>
</Tabs>

## Tools

| Tool           | What it does                                         |
| -------------- | ---------------------------------------------------- |
| `get_credits`  | Return your credit balance.                          |
| `list_models`  | List preset + your own models for with-model shoots. |
| `create_shoot` | Start a product-photography shoot.                   |
| `get_shoot`    | Poll a shoot; returns image URLs when done.          |
| `create_video` | Start a video ad from image URLs.                    |
| `get_video`    | Poll a video; returns the MP4 URL when done.         |

## Example

> **You:** Generate an editorial 4-shot set for this product: [https://example.com/bottle.jpg](https://example.com/bottle.jpg)
>
> **Claude:** *(calls `create_shoot`, polls `get_shoot`, returns the image URLs)*
>
> **You:** Make a 10-second 720p ad from the first two.
>
> **Claude:** *(calls `create_video`, polls `get_video`, returns the MP4)*

<Note>
  The MCP server enforces the same authentication, rate limits, and credit charges as the
  REST API — it's just a friendlier front door.
</Note>