Connect Codex, Claude Code or Cursor to ContentFries over MCP. Say what you want in plain words. Your agent finds the moments, renders the visuals and lines up the posts. ContentFries quotes every paid step first, and nothing goes out without you.
Hosted MCP · https://my.contentfries.com/api/mcp · workspace API key
Make a pack from Tuesday's episode.Source checked. Recipe found. Quote: 1,180 credits.Approve 1,180.9 clips, 4 thumbnails, 6 quotes, 1 outline ready for review.Example run. Gold lines are yours.
Six things you can ask for today. Every tool name below is a real operation on the hosted MCP server.
Paste a public video link. Your agent inspects the source, picks a live recipe, shows you the quote and starts processing once you say yes. The pack lands in your workspace with your style applied.
source_url_inspectrecipes_listproject_processing_quoteprojects_start_cookYour agent authors VisualFries scenes and ContentFries renders them: captioned MP4 clips, quote cards, carousels as up to sixteen ordered PNG slides, or a single-frame still. Quoting is free; rendering waits for your approval.
scenes_quotescenes_renderrenders_getConnect your YouTube channel once. Your agent reads which videos are taking off, with the performance evidence behind each one, and lists the candidates worth turning into a pack.
radar_channel_connectradar_videos_listradar_candidates_listIdeas grounded in your own numbers. Each recommendation links back to the top performers on your channel that inspired it, so you see the why before you act.
recommendations_listYour agent reads the brand context saved in your workspace before it drafts anything, and saves back the owner rules you approve.
content_context_exportcontent_context_patchOutputs queue for your review. Keep, edit or drop each one. Approved assets flow to the Planner and your agent marks them scheduled or published as your scheduler posts them.
review_items_listreview_batch_submitplanner_items_listplanner_mark_scheduledAn example run with sample numbers. Your quote shows the real total before anything is charged.
Here is Tuesday’s episode: https://youtu.be/… Make the pack, keep the three strongest clips and build a four-slide quote carousel from the best line. Ask before spending credits.source_url_inspect → public YouTube video, 48:12recipes_list → "Make a pack" fits a long talking-head episodeCreate the project and fetch the quote? Project creation is a write.Go.project_processing_quote → total 1,180 credits · expires in 15 minApprove 1,180.projects_start_cook → jobs_get → doneprojects_outputs_list → 9 captioned clips · 4 thumbnails · 6 quote ideas · 1 blog outlinescenes_quote → 4 PNG slides from the best line · total 96 creditsApprove 96.scenes_render → renders_get → 4 slide URLs, in orderreview_items_list → 3 clips and the carousel are waiting for your reviewOne message with the link and what you want. Plain English, your own limits.
Inspects the source, picks the recipe, fetches an exact quote, waits for your yes, then processes, renders the carousel and queues everything for review.
A review grid with captioned clips, thumbnails, quote ideas and a blog outline, four carousel slides as PNGs in order, and a Planner handoff ready for your scheduler.
Five minutes from a fresh key to a verified connection.
Open Integrations in your ContentFries workspace and create a key. Start with read-only scopes: credits:read, recipes:read, projects:read, content:read and planner:read. Store the one-time key in
your secret manager and expose it as CONTENTFRIES_API_KEY. Keep it out of
prompts, repositories, screenshots and shell history. Current Free, Creator and Scale
plans include Agent API access.
Pick your client. Each one reads the key from the environment, so the secret stays out of config files. Restart the agent after adding the server.
codex mcp add contentfries --url https://my.contentfries.com/api/mcp --bearer-token-env-var CONTENTFRIES_API_KEYCheck with codex mcp get contentfries
claude mcp add --transport http contentfries https://my.contentfries.com/api/mcp --header "Authorization: Bearer $CONTENTFRIES_API_KEY"Check with claude mcp list
{ "mcpServers": { "contentfries": { "url": "https://my.contentfries.com/api/mcp", "headers": { "Authorization": "Bearer ${env:CONTENTFRIES_API_KEY}" } } }}Cursor reads the variable from your environment at startup.
Any other MCP client connects to https://my.contentfries.com/api/mcp with the key as a bearer token.
Give your agent this prompt. It only reads.
Run a read-only ContentFries health check using credits_balance_get, recipes_list, projects_list and planner_items_list for the next seven days. Report missing scopes. Do not create, cook, render, review, schedule, publish or spend credits. Never print keys or signed asset URLs.
You are connected when the agent returns real results: today's recipes, your credit
balance and your Planner for the week. When you are ready to make something, add projects:write, recipes:run and jobs:read. Add content:review for review decisions and planner:write for scheduler handoff.
credits_balance_get any time.Every clip, quote card and carousel your agent renders is a VisualFries scene: typed JSON for text, shapes, media, audio and captions, rendered deterministically. Author scenes in code with VisualFries, then let ContentFries handle moments, packs, styles, quotes and review.
Read-only scopes first. Paid steps only after your approval.