Skip to content
SupportOpen app

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/mcp

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:

Terminal window
claude mcp add --transport http screel https://api.screel.ai/mcp

In 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.

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_url on set_scene_image
  • reference_image_urls on refine_scene_image
  • audio_url on analyze_audio
  • An image, video or audio input of run_workflow

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.

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.