# HeyKlick

> HeyKlick turns a single product photo into scroll-stopping, on-brand social
> media posts. Upload a photo, pick a style and brand colors, and get a set of
> finished, downloadable posts — in one klick.

## Use HeyKlick from your AI (MCP connector)

HeyKlick is a remote MCP server. Connect it to Claude, ChatGPT, Cursor, Codex,
or any MCP client and generate posts directly in the chat.

- MCP server URL: https://heyklick.com/api/mcp
- Transport: Streamable HTTP (POST)
- Auth: OAuth 2.1 (PKCE). On first use the client opens a browser to "Authorize
  HeyKlick"; the user signs in and approves. No API key needed.
- Setup guide: https://heyklick.com/connect

### Quick connect

- Claude Code (CLI):  claude mcp add --transport http heyklick https://heyklick.com/api/mcp
- Claude Desktop / claude.ai:  Settings → Connectors → Add custom connector → https://heyklick.com/api/mcp
- Cursor/Codex/Cline/Windsurf:  add a remote MCP server with url https://heyklick.com/api/mcp

## Tools

- heyklick_upload(image, mimeType?)
    RECOMMENDED FIRST STEP for any large photo: upload it once and get back a
    short-lived URL (~24h) to reuse. Accepts base64 bytes (pass mimeType), a
    data: URL, or a public URL. Then pass the returned url as the image (or logo)
    to heyklick_generate instead of inlining big base64 — faster and avoids
    oversized requests. Small images can skip this and go straight to generate.
- heyklick_generate(image, mimeType?, logo?, logoMimeType?, count?, style?, about?, brandColors?, brandName?, brand?, aspect?)
    Generate on-brand social posts from ONE product photo. image accepts a public
    URL, a data: URL, OR base64 bytes (pass mimeType for base64). For large
    photos, call heyklick_upload first and pass the returned url here. logo is an
    optional brand logo (same formats). style is one of: brand (editorial
    brand-shoot, default), designed (graphic layout), photo (clean editorial).
    brand applies a saved brand kit by id or name (see heyklick_brands). aspect is
    1:1, 9:16, or 16:9. Returns a jobId. Costs 10 credits per post.
- heyklick_status(jobId)
    Poll a job; returns status + finished, downloadable image URLs (with each
    post's creativeId, used for heyklick_edit) when ready.
- heyklick_edit(creativeId, instruction, aspect?)
    Edit an existing post with a plain-language instruction (e.g. "make the
    background warmer", "remove the shadow"). Returns a jobId. Costs 10 credits.
- heyklick_download(jobId)
    Get direct downloadable image URLs for a finished job.
- heyklick_library(limit?)
    List the account's recent generated posts with image URLs + creativeIds.
- heyklick_brands()
    List the user's saved brand kits (id, name, colors) to pass as the brand
    argument to heyklick_generate so posts are on-brand and filed under that brand.
- heyklick_credits()
    Plan + remaining credits (10 credits = 1 post).

## Notes

- A free HeyKlick account includes starter credits.
- Generated images are returned as signed, downloadable URLs.
- Pricing: https://heyklick.com/pricing