For agents and developers
CreativeClaw MCP
One remote MCP. OAuth with Gmail. No provider API keys. Tools generate images, video, speech, layouts, characters, and brand-themed assets into a permanent library.
Connect
- MCP URL
- https://app.creativeclaw.co/mcp
- ChatGPT app MCP URL
- https://app.creativeclaw.co/mcp/chatgpt
- Use this app-specific endpoint for native ChatGPT attachment import. Install the published app from Plugins when possible.
- Transport
- Streamable HTTP. Protocol 2025-03-26 and later.
- Claude Code
- claude mcp add creative-claw https://app.creativeclaw.co/mcp --transport http
- Skill
- npx skills add CreativeClawCo/creative-claw-marketplace
Per-client screenshots and ChatGPT / Codex / OpenClaw commands live on How to connect. Human-oriented tool examples live on Methods.
OAuth
The MCP endpoint returns 401 with a WWW-Authenticate challenge. Follow RFC 9728 to the protected-resource document, then RFC 8414 to Clerk. Use authorization code + PKCE S256. Register dynamically if the client has no pre-issued credentials.
- Authorization
- https://clerk.creativeclaw.co/oauth/authorize
- Token
- https://clerk.creativeclaw.co/oauth/token
- Registration
- https://clerk.creativeclaw.co/oauth/register
- Scopes
- profile email
- PKCE
- S256
- Resource metadata
- https://app.creativeclaw.co/.well-known/oauth-protected-resource/mcp
Do not request openid. Clerk rejects that scope for dynamically registered MCP clients.
Tools
49 tools. Call tools/list for live JSON Schema. Call get_model_params before sending model-specific extras. Tools marked async return a job_id — poll check_job.
Generate
-
generate_imageGenerate or edit an image. Default model: Nano Banana 2. -
generate_videoGenerate, animate, extend, or edit video. Default model: Gemini Omni Flash. async -
generate_speechGenerate speech or dialogue. Default model: ElevenLabs v3. -
generate_3d_modelQueue a 3D model generation job (GLB). async -
compare_modelsRun one image prompt through 2–4 image models side by side.
Discover models
-
list_modelsList current image, video, and speech models. Filter by category. -
get_model_paramsRead a model’s live schema, defaults, enums, and extras.
HTML, templates, motion
-
render_html_imageRender HTML/CSS to a PNG via the branded layout engine. -
render_html_videoRender code-driven HTML motion to MP4. Returns a job ID. async -
create_templateCreate a reusable HTML or generative template. -
render_templateRender a saved template with parameter values. -
update_templatePatch an existing template’s fields. -
list_templatesList saved templates for the account.
Edit media
-
transcribeTranscribe audio or video with word-level timestamps. async -
isolate_audioRemove noise, music, and reverb from a voice recording. async -
upscale_mediaUpscale an image or video. -
trim_videoCut a time range from a video. -
scale_videoResize, crop, or pad a video. -
add_subtitlesBurn captions onto a video. -
remove_backgroundRemove the background from an image or video. -
extract_framesExtract still frames from a video. -
merge_mediaConcatenate videos or audio, or mix an audio track onto video. async
Characters
-
manage_characterCreate or update a Character (reference image + optional cloned voice). -
clone_voiceAttach a consented voice clone to an existing Character. -
list_charactersList reusable Characters and IDs. -
delete_characterSoft-delete a Character.
Film projects
-
create_film_projectCreate a multi-shot Film project. -
update_film_projectSave script, shots, storyboards, clips, and approval state. -
get_film_projectInspect one Film project. -
list_film_projectsList Film projects for the account. -
assemble_filmMerge approved clips and audio into the final Film.
Brand themes
-
list_themesList brand themes and the default theme. -
get_themeFetch the default or named brand theme. -
update_themeCreate or update a brand theme, or open the visual editor. -
delete_themeSoft-delete a brand theme.
Asset library
-
search_assetsSearch the permanent asset library by type, query, tags, or name. -
update_assetSet a unique name, replace tags, or update a description. -
delete_assetSoft-delete an asset. -
load_imageLoad an image URL inline for visual review. -
import_mediaOpen the media picker when the user still needs to choose a file. -
import_chatgpt_mediaConvert a ChatGPT attachment into a durable CreativeClaw asset (ChatGPT only). -
get_upload_urlMint a signed upload URL for clients that can HTTP PUT bytes. -
confirm_uploadFinalize a signed upload into the asset library. -
upload_assetCopy a public, directly downloadable URL into the library.
Jobs, credits, feedback
-
check_jobPoll an async job by job_id until it completes or fails. -
get_credits_balanceRead remaining credits and optionally estimate a generation cost. -
get_credits_linkReturn a user-operated Polar checkout link for credit top-up. -
purchase_creditsStart a credit purchase. Packs: 1000/$10, 5000/$50, 11000/$100, 27500/$250. -
submit_feedbackSend product feedback (bug, missing feature, praise) to the team.
Errors
- HTTP 401 on /mcp — missing or expired token. Restart the OAuth flow.
- JSON-RPC error.code — protocol errors (−32600 invalid request, −32602 invalid params).
- Tool result isError: true — the call ran but failed (validation, insufficient credits, upstream provider). Read content[0].text.
- Job status: "failed" from check_job — async generation failed. The message names the provider error when available.
Credits and limits
New accounts start with 100 free credits, no card. Then $10 = 1,000 credits that never expire. Packs: 1,000 / 5,000 / 11,000 / 27,500. There is no subscription and no published requests-per-second cap — spend is credit-based. Upstream providers may 429; the server retries those.
Use get_credits_balance before a batch. Use get_credits_link so the user can pay. Live prices: /pricing.md.
Reliability
- Health: https://app.creativeclaw.co/health
- Status: https://creativeclaw.co/status/ and https://creativeclaw.co/status.json
- Uptime target: 99.9% for the MCP endpoint
- Support: [email protected] — Within 1 business day
Machine-readable
- OpenAPI 3.1: https://creativeclaw.co/openapi.json
- MCP server card: https://creativeclaw.co/.well-known/mcp.json
- API catalog: https://creativeclaw.co/.well-known/api-catalog.json
- llms.txt: https://creativeclaw.co/llms.txt
- Host: https://app.creativeclaw.co