picsart-api

Picsart API (MCP)

The picsart MCP server at https://mcp.picsart.io/v1 exposes four Picsart REST APIs as MCP tools. Each tool name equals the OpenAPI operationId verbatim — dashes preserved (e.g. genai-text2image, image-remove-background, video-trim, vd-export-replay).

When to Use

Use this skill whenever the user asks to:

• Generate net-new content from a prompt — image, video, sticker, logo, speech, sound, music, SFX, or text completion.
• Edit, enhance, resize, reformat, recolor, or transform an existing image or video.
• Remove backgrounds or objects; inpaint, outpaint, or extend canvas.
• Apply effects, masks, styles, adjustments, blur, color/style transfer.
• Extract, transcribe, or manipulate audio tracks in video.
• Upscale, FPS-upscale, super-resolve, or enhance faces.
• Watermark, crop, trim, concat, or fit media.
• Render bulk personalised creative assets via a Replay.

If the request touches any of the above, read the relevant doc in references/ BEFORE calling any picsart-*, image-*, video-*, genai-*, or vd-* MCP tool.

Prerequisites

The picsart MCP server must be connected and a Picsart API key available:

• MCP server. This repo ships the server config at the repo-root .mcp.json. Claude Code auto-loads it when the repo (or the installed skill) is in scope. For other hosts (Cursor, Codex) or a manual setup, register an HTTP MCP server named picsart pointing at https://mcp.picsart.io/v1:

  {
    "mcpServers": {
      "picsart": {
        "type": "http",
        "url": "https://mcp.picsart.io/v1",
        "headers": {
          "X-Picsart-API-Key": "${PICSART_API_KEY}",
          "Accept": "application/json"
        }
      }
    }
  }
  

• API key. Export PICSART_API_KEY in the environment before starting the agent. Never hardcode it — the config interpolates ${PICSART_API_KEY} at runtime.

• Two servers, two auth models. The repo-root .mcp.json registers two Picsart servers. Use the one that matches your setup:

  • picsart at https://mcp.picsart.io/v1 — the server this skill uses. Auth via the X-Picsart-API-Key: ${PICSART_API_KEY} header (shown above). Exposes all image-*, video-*, genai-*, and vd-* tools.
  • picsart-gen-ai at https://api.picsart.com/gen-ai/mcp — the generative-AI server. Auth via OAuth: the host (Cursor, Claude Code) runs an interactive sign-in the first time it connects; no API-key header is needed. Its tools overlap with the genai-* surface of the picsart server, so pick one path per session rather than mixing.