# Clippie API and MCP server > Make Clippie videos, images and audio from code or from Claude, ChatGPT and Cursor: authentication, errors, limits, jobs, webhooks, the MCP server and every endpoint. REST base URL https://api.clippie.ai/v1; MCP server https://api.clippie.ai/mcp; OpenAPI https://api.clippie.ai/v1/openapi.json. Paid Clippie plans only; the same credits and minutes as the app. Rules for agents: read the key from the CLIPPIE_API_KEY environment variable and never hardcode it; call GET /v1/me first; run create calls with "dryRun": true and confirm the cost with the user before spending; send an Idempotency-Key on every create; wait with GET /v1/jobs/:id?wait=30 or a webhook. ## Docs - [Overview](https://clippie.ai/developers/docs.md): Quickstart, authentication, errors, rate limits, idempotency, jobs, webhooks and the MCP server. - [Everything in one file](https://clippie.ai/developers/llms-full.txt): every page below, concatenated. ## Templates - [Create AI Story video](https://clippie.ai/developers/docs/create-ai-story-video.md): POST /v1/videos/ai-story, MCP create_ai_story_video. Makes a narrated AI Story video (script, voiceover, scene images, captions, music) and renders it to MP4. - [Render video](https://clippie.ai/developers/docs/render-video.md): POST /v1/videos/:projectId/render, MCP render_video. Renders an AI Story project you own to MP4: one made with create_ai_story_video (render: false) or in the Clippie editor. ## AI tools - [Generate images](https://clippie.ai/developers/docs/generate-image.md): POST /v1/ai/images, MCP generate_image. Generates 1-4 images with an AI Studio model (Nano Banana, Seedream, Flux, Imagen). - [Generate a video clip](https://clippie.ai/developers/docs/generate-video.md): POST /v1/ai/videos, MCP generate_video. Generates a short AI video clip with an AI Studio model: Seedance and Veo from text or images, Clippie Recast and Genjutsu from a source video (referenceVideoUrl or motionTemplateId) plus photos. - [Recast a trending video](https://clippie.ai/developers/docs/recast-video.md): POST /v1/ai/recast, MCP recast_video. Clippie Recast: puts the people in your photos into a trending motion template (list_motion_templates), keeping its moves, camera and sound. - [Upscale an image or video](https://clippie.ai/developers/docs/upscale.md): POST /v1/ai/upscale, MCP upscale. Upscales an image (2x-6x) or a video (to 720p, 1080p or 4K) with Topaz. - [Text to speech](https://clippie.ai/developers/docs/text-to-speech.md): POST /v1/ai/speech, MCP text_to_speech. Turns text into an mp3 narration with a Clippie voice or one of your cloned voices, with word timings. - [Transcribe audio or video](https://clippie.ai/developers/docs/transcribe.md): POST /v1/ai/transcribe, MCP transcribe. Transcribes an audio or video file (up to 30 minutes) into punctuated text, word timings, and SRT and WebVTT captions split at sentence ends. - [Write a script](https://clippie.ai/developers/docs/write-script.md): POST /v1/ai/scripts, MCP write_script. Writes a narration script for a short video from a topic, with the AI Story editor's writer, a theme, a tone and a target length. ## Resources - [List voices](https://clippie.ai/developers/docs/list-voices.md): GET /v1/voices, MCP list_voices. Lists narration voices: the user's own cloned voices first, then the popular voices, then the rest. - [List caption styles](https://clippie.ai/developers/docs/list-caption-styles.md): GET /v1/caption-styles, MCP list_caption_styles. Lists the burned-in caption styles (font, colours, one word at a time or lines). - [List art styles](https://clippie.ai/developers/docs/list-art-styles.md): GET /v1/art-styles, MCP list_art_styles. Lists the looks an AI Story video can have. - [List story templates](https://clippie.ai/developers/docs/list-story-templates.md): GET /v1/story-templates, MCP list_story_templates. Lists ready-made AI Story formats (an art style plus a frame shape, e.g. - [List motion templates](https://clippie.ai/developers/docs/list-motion-templates.md): GET /v1/motion-templates, MCP list_motion_templates. Lists the trending motion clips used by Clippie Recast and motion-control video models, in the same order as AI Studio (newest hand-picked uploads first, then by trend). - [List AI models](https://clippie.ai/developers/docs/list-models.md): GET /v1/models, MCP list_models. Lists the AI Studio video and image models with their resolutions, aspect ratios, durations and credit price per generation (images: per image). - [List background videos](https://clippie.ai/developers/docs/list-background-videos.md): GET /v1/background-videos, MCP list_background_videos. Lists the gameplay and satisfying background clips (Minecraft parkour, Roblox, ...) used behind story videos. - [List music](https://clippie.ai/developers/docs/list-music.md): GET /v1/music, MCP list_music. Lists background music tracks, popular first. - [List sound effects](https://clippie.ai/developers/docs/list-sound-effects.md): GET /v1/sound-effects, MCP list_sound_effects. Lists the short sound effects (whoosh, bell, punch, ...) that can be placed on a video timeline. - [List languages](https://clippie.ai/developers/docs/list-languages.md): GET /v1/languages, MCP list_languages. Lists the languages for captions, transcription and narration. ## Jobs & files - [List jobs](https://clippie.ai/developers/docs/list-jobs.md): GET /v1/jobs, MCP list_jobs. Lists the jobs started through the API or MCP, newest first, with their status, output and what they cost. - [Get job](https://clippie.ai/developers/docs/get-job.md): GET /v1/jobs/:id, MCP get_job. Gets one job: status (queued, processing, rendering, completed, failed, canceled), step, progress, output (videoUrl, imageUrls, audioUrl, captions, editorUrl) and cost. - [Cancel job](https://clippie.ai/developers/docs/cancel-job.md): POST /v1/jobs/:id/cancel, MCP cancel_job. Cancels a job that is still queued and refunds what it was charged. - [Estimate cost](https://clippie.ai/developers/docs/estimate-cost.md): POST /v1/estimate, MCP estimate_cost. Shows what a create tool would charge (credits and voiceover, caption and export minutes) and whether it would go through, without spending anything. - [Upload file](https://clippie.ai/developers/docs/upload-file.md): POST /v1/files, MCP upload_file. Imports an image, video or audio file from a public https URL (up to 100 MB) so other tools can use it as fileId. - [Start a large file upload](https://clippie.ai/developers/docs/create-file-upload.md): POST /v1/files/uploads. Starts a multipart upload for files over 100 MB (up to 5 GB): returns presigned URLs to PUT each part to, valid for an hour, then call POST /v1/files/uploads/complete with each part's ETag. - [Finish a large file upload](https://clippie.ai/developers/docs/complete-file-upload.md): POST /v1/files/uploads/complete. Finishes a multipart upload started with POST /v1/files/uploads and returns the file. - [Get file](https://clippie.ai/developers/docs/get-file.md): GET /v1/files/:id, MCP get_file. Gets a file uploaded with upload_file: its type and URL. ## Account - [Get account](https://clippie.ai/developers/docs/get-account.md): GET /v1/me, MCP get_account. Shows the user's Clippie plan, AI credit balance (plan and top-up), the voiceover, caption and export minutes left, when the period ends and whether videos are watermarked. - [List credit history](https://clippie.ai/developers/docs/list-credit-history.md): GET /v1/credits/history, MCP list_credit_history. Lists credit movements (top-ups, plan credits, generations, refunds) and minute spends, newest first, each linked to its API job when there is one. ## Optional - [OpenAPI spec](https://api.clippie.ai/v1/openapi.json): request and response schemas for every endpoint. - [Developers page](https://clippie.ai/developers): what you can build, with install buttons for each AI client.