Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@openart-mcp Create a video of character 'Test' saying 'Hello from OpenArt'."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP server + Claude skill for OpenArt.ai. OpenArt has no public API, so this drives their web UI as a logged-in user via Playwright.
MCP server (src/) — exposes 5 tools that automate OpenArt character + video workflows
Claude skill (skills/openart/SKILL.md) — tells Claude when and how to call the MCP tools
Related MCP server: Playwright MCP Automation
Tool | Purpose |
| List every character in your OpenArt account |
| Get details for one character by ID |
| Create a new character from a local image |
| Generate a video of a character speaking a script |
| Check render status + URL of a generated video |
git clone https://github.com/jbertus/openart-mcp.git
cd openart-mcp
npm install
npx playwright install chromium
npm run build
npm run login # opens browser, log in to OpenArt, press Enter when doneThe login step saves a Playwright storageState JSON to ~/.openart-mcp/auth.json (or %USERPROFILE%\.openart-mcp\auth.json on Windows). The server reuses that session for every subsequent tool call.
Claude Code / Claude Desktop — add to your MCP config (~/.claude/mcp.json or equivalent):
{
"mcpServers": {
"openart": {
"command": "node",
"args": ["<absolute-path-to-cloned-repo>/dist/index.js"]
}
}
}Other MCP clients — point to node <repo>/dist/index.js with stdio transport.
npx skills add https://github.com/jbertus/openart-mcp --skill openartThe skill teaches Claude when to call which tool and how to format arguments. Without it, Claude can still use the MCP but you'll have to spell out intent more explicitly.
Environment variables (all optional):
Var | Default | Purpose |
|
| Path to Playwright session JSON |
|
| Set to |
The tools in src/tools.ts ship with placeholder DOM selectors marked TODO. OpenArt's UI changes over time, so the selectors need to be captured against the live site:
npx playwright codegen https://openart.ai/suite/characters-and-worldsClick through the UI for each tool's flow. Playwright generates real selectors. Paste them into the TODO spots in src/tools.ts, rebuild (npm run build), and the tools work.
If the selectors break later (OpenArt redesigns), repeat this step.
Fragile to UI changes. Every OpenArt redesign may break selectors. Re-run codegen and re-patch.
Slower than a real API. Each tool call launches a browser session and waits on page loads.
Session can expire. Re-run npm run login when prompted.
OpenArt may block automation. Anti-bot detection could rate-limit or ban your account. Use sparingly. No recourse if banned.
npm run inspect # launches MCP Inspector against the serverPRs welcome. If OpenArt's UI changes and the selectors break, open an issue with the new selectors and a brief description of which tool flow needs updating.
MIT — see LICENSE.
Create a new OpenArt character from an image. Provide name, local image path, optional background story, optional voice ID.
Inputs: name (required), image_path (required), background_story, voice_id.
Generate a video using an existing OpenArt character speaking a script.
Inputs: character_id (required), script (required), aspect_ratio.
Get details for a specific OpenArt character by ID.
Inputs: id (required).
Check the rendering status and URL of an OpenArt video by ID.
Inputs: video_id (required).
List all characters/avatars in the user's OpenArt account.
Inputs: no named parameters.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 5 tools
Each tool has a clearly distinct purpose: creating a character, generating a video, fetching character details, checking video status, and listing characters. No overlap in functionality.
All tools follow a consistent 'openart_verb_noun' pattern (e.g., openart_create_character, openart_list_characters), with verbs in imperative form and nouns clearly indicating the resource.
With 5 tools, the set is well-scoped for managing OpenArt characters and videos. Each tool earns its place, covering essential operations without unnecessary bloat.
The set covers the core workflow: character creation, retrieval, listing, video generation, and status checking. Missing update and delete operations for characters are minor gaps that agents can work around.
LLM chat, text tools, image generation, editing, batch image jobs, and asynchronous video generation
Playwright browser automation — navigate, click, fill forms, extract, screenshot — 17 agent tools.
Image and video AI tools and your own pipelines, run from any AI assistant.
Create and manage cinematic AI video renders through the Future Video Studio Agent API.
