# A little setup. A lot of possibility. Connect your agent to AnimaGuru for sprites, images, video, music, speech and sound effects. Use the CLI in your workspace or the MCP server from your chat. ## Let your agent handle setup Paste this into your agent. It will check your environment, choose the right connection and help you sign in. Copy setup prompt: ``` Help me set up AnimaGuru for this workspace. First read https://animaguru.com/docs.md and https://animaguru.com/agent-setup.md for current capabilities and setup instructions. If you can run local commands, check whether animaguru is installed and whether Node.js 24+ is available. Use the existing installation when possible; otherwise install @docyrus/animaguru from npm, or use the macOS installer at https://animaguru.com/install.sh. Run animaguru auth status; if sign-in is needed, run animaguru auth login and let me approve it in my browser. Never ask me to paste credentials into chat. Ask whether I want assets in an existing project, a standalone film, or a shared brand workspace. For existing projects, run animaguru init in the intended folder to install the agent skill. For a new film, use animaguru create NEW_FOLDER. For a brand with multiple films, use animaguru create workspace NEW_FOLDER, then animaguru create animation ANIMATION_NAME inside it. Preserve existing files. Read the installed skills and AGENTS.md or CLAUDE.md before production. Use animaguru schema and animaguru catalog to discover current commands and options. If local commands are unavailable, help me add https://animaguru.com/mcp as a remote Streamable HTTP MCP server and complete OAuth in my client. Discover projects with list_projects and configured models with list_assets. Clients that support MCP Apps can use open_studio for interactive previews. The ChatGPT directory plugin is coming soon and currently in review; do not claim it can be installed yet. Finish by checking the connected account and listing projects, without generating anything. Explain the available workflows. Before later paid generation, validate the request and show its estimate; CLI --dry-run estimates use bundled rates, while MCP estimate_generation validates against the server. Follow my generation request and budget, and track returned job IDs instead of resubmitting paid jobs. ``` ## One studio. Two ways to connect. Both connections use your AnimaGuru account, projects and generation credits. ### Draw, revise, animate Create characters and props, redraw artwork, add built-in actions or describe a custom motion. Inspect frames and export sprite sheets with animation data. ### Make the rest of the scene Generate images, music, speech and sound effects. Make video from text or images, or extend a saved clip using a supported model. ### Build and deliver with the CLI Work in an existing project or assemble films with PixiJS and creative skills. Export HTML5 or MP4, share finished videos, upload directly to YouTube, and sync versions on Pro or Team. ## Set up Codex or Claude Code Use the CLI for assets in an existing folder, a standalone film, or multiple animations sharing one brand. Successful commands return JSON. ### 1. Install AnimaGuru Choose the macOS installer, or install from npm with Node.js 24 or later. macOS: ``` curl -fsSL https://animaguru.com/install.sh | bash ``` npm · Node.js 24+: ``` npm install -g @docyrus/animaguru ``` ### 2. Connect your account Run the login command and approve the connection in your browser. Then check your sign-in status. Connect your account: ``` animaguru auth login animaguru auth status ``` ### 3. Choose your workflow Install skills in an existing project or create a new workspace. New workspaces include Codex and Claude guidance, creative skills and PixiJS references for 31 visual styles. Run these commands in your game or app folder. init installs or refreshes the AnimaGuru skill; catalog lists options and projects list checks access. Existing project: ``` animaguru init animaguru catalog animaguru projects list ``` TRY THIS PROMPT: ``` Read the AnimaGuru skill in this folder. List my projects and help me choose assets for this app. Show estimates before generating anything. ``` Run this from your projects’ parent folder with a new folder name. Dependencies and skills are installed for you. One film: ``` animaguru create my-video cd my-video ``` TRY THIS PROMPT: ``` Let’s make a short animated film. Help me choose a category, style and creative brief before production. ``` Create a new workspace, then add films inside it. Your animations share a brand kit, dependencies, player and export tools. Shared brand: ``` animaguru create workspace my-brand cd my-brand animaguru create animation first-film ``` TRY THIS PROMPT: ``` Read the workspace instructions and help me build a brand kit from my official website or brand guide. Then plan our first film. ``` ### 4. Start creating in your agent Open the project folder and ask your agent to read its installed instructions and skills. Start with a brief; review costs before generating assets. TRY THIS PROMPT: ``` Let’s make a short animated film. Help me choose a style and shape the story before we start. ``` Setup and project creation use no generation credits. CLI --dry-run estimates use bundled rates; the server checks models, references and credits when you submit. Paid generation requires --yes and your authorization. ## Set up Other MCP clients Connect through remote Streamable HTTP and OAuth. Browse personal and team projects, estimate generation, draw and revise sprites, generate media and follow jobs. MCP Apps clients can also show interactive studio previews. ### 1. Add a remote MCP server In your client’s MCP settings, add a server named AnimaGuru with this URL. Choose Streamable HTTP if your client asks for a transport. MCP URL: ``` https://animaguru.com/mcp ``` ### 2. Sign in to AnimaGuru Follow your client’s authentication flow, sign in, and review the requested permissions. The connection uses OAuth; you do not need to paste an API key. ### 3. Check the connection Ask your agent to list your projects. This checks access without starting a generation job. TRY THIS PROMPT: ``` List my AnimaGuru projects and help me choose one to work on. Don’t generate anything yet. ``` Tools depend on approved scopes: projects.read for browsing and estimating, projects.write for project creation and generation. Use estimate_generation for current costs and get_job for status. MCP does not expose project deletion or local film exports. ## ChatGPT · Coming soon Your creative studio, inside ChatGPT. Browse projects, play video and audio, inspect animation frames and review generation estimates in an interactive studio without leaving your conversation. The AnimaGuru plugin is currently in review for the ChatGPT directory. Installation will be available after approval. - Browse personal and team projects and saved assets. - Preview artwork, play animations, and inspect frames and quality findings. - Review credit estimates before sprite and media generation, then track jobs. - Use bundled AnimaGuru, CLI and PixiJS v8 guidance for creative work. More detail: [developer docs](https://animaguru.com/docs.md).