Connect an MCP client
Connect any Model Context Protocol client to Screel, such as Claude Code, Cursor or your own agent. Screel serves MCP over Streamable HTTP at this endpoint:
https://api.screel.ai/mcpConnect a client
Section titled “Connect a client”Sign-in uses OAuth 2.1. A client that supports MCP authorization finds Screel’s sign-in server from the endpoint and opens the sign-in in your browser. Sign in to Screel or create an account, then approve the screel.read and screel.generate scopes. Screel API keys do not work on this endpoint.
In Claude Code, run:
claude mcp add --transport http screel https://api.screel.ai/mcpIn Cursor, add the server to .cursor/mcp.json:
{ "mcpServers": { "screel": { "url": "https://api.screel.ai/mcp" } }}To check the connection, ask your client to call get_account.
What this endpoint offers
Section titled “What this endpoint offers”The endpoint serves 44 tools for projects, scenes, generation, the script, reference documents, workflow runs, track analysis, rendering and job tracking. The tool reference lists each tool and where you can call it. Workflow tools are not on every account.
Responses are plain JSON, with no widgets. Where the ChatGPT app takes a file attachment, this endpoint takes a public URL. Screel fetches the file over HTTPS and stores it in your account. These inputs take a URL:
image_urlonset_scene_imagereference_image_urlsonrefine_scene_imageaudio_urlonanalyze_audio- An image, video or audio input of
run_workflow
Make a video from a track
Section titled “Make a video from a track”Run a built-in template. list_workflows lists the templates with their Run forms. Call run_workflow with template, a project_id and the track’s URL in the template’s audio input.
Jobs and credits
Section titled “Jobs and credits”Generation tools return a job_id at once. Poll get_job_status, with up to 40 job IDs per call, for progress and results.
Generation spends credits from your Screel account, and get_account reports your balance and the cost of each action. A render spends no credits.
