Use this file to discover all available pages before exploring further.
The MCP server exposes 23 tools across five categories. Pick a category below to see what’s available.
Account
Direct Generation
Workflows
Workflow Builder
Workflow Runs
Check credits and estimate cost before kicking off expensive jobs.
get_balance
Check the user’s current Magica credit balance. Returns the raw microcredit value plus a human-readable string.
get_pricing
Get the cost structure for a model, or compute the exact credit cost for a sample input. Purely informational — credits are charged automatically by execute_tool.
The primary one-shot path for image, video, audio, TTS, lipsync, and transcription. Use these instead of building a workflow for single-step generation.
search_tools
Browse the model catalog grouped by category (text-to-image, text-to-video, image-to-video, lipsync, TTS, music, sound effects, transcription, …). Returns model IDs.
get_model_schema
Get the full input parameter schema for a model — types, defaults, conditional fields, ranges. Required before calling execute_tool with an unfamiliar model.
execute_tool
Run a generation or utility tool. Routes via tool_name: generate, batch_execute, merge_videos, extract_audio, and more. The single one-shot generation tool.
get_run_status
Long-poll a run by ID. Returns the final result or a still-running response to call again. Replaces the older get_run / get_model_run.
upload_file
Upload an image / video / audio / raw file to permanent Magica storage. Accepts url, data_uri, or base64. Returns a stable URL + metadata.
get_generations
Browse the user’s recent media-library items (generated assets + uploads). Paginated — uses a ‘Load more’ widget rather than refetching.
Start a workflow run by ID or name. Searches user workflows first, falls back to system workflows. Validates Request Node fields automatically.
list_runs
List workflow runs with optional filters (workflow, status, search) and cursor or page-based pagination.
cancel_run
Cancel a running or queued workflow run. Refunds unused estimated credits.
To check the status or result of a workflow run, use get_run_status from the Direct Generation tab — it handles both workflow runs and one-shot generations.
See Runs & Execution for request-node handling, polling patterns, and the run result shape.
