@retomagic/mcp
OfficialClick 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., "@@retomagic/mcp generate an image of a serene lake at sunset"
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.
@retomagic/mcp
An MCP server for the Magicly image & video generation API. Lets any MCP client (Claude Desktop, IDEs, agents) generate media through your Magicly developer API key.
Setup
Create an API key at dev.magicly.ai → API Keys.
Add the server to your MCP client. For Claude Desktop (
claude_desktop_config.json):
{
"mcpServers": {
"magicly": {
"command": "npx",
"args": ["-y", "@retomagic/mcp"],
"env": { "MAGICLY_API_KEY": "sk_live_..." }
}
}
}Restart the client. That's it.
Related MCP server: genrelay-mcp
Tools
list_models— list available models with id, media type, price ($) and inputs.generate— generate an image/video:{ model, prompt, aspect_ratio?, size?, seconds?, seed?, image? }. Creates a prediction and waits for the result, returning the output URL(s). Passwait: falseto return immediately with an id to poll.get_prediction— fetch a prediction's status/output byid.
Config
Env | Default | Description |
| – | Required. Your developer API key ( |
|
| API base URL (override for staging). |
Billing is metered in credits (1000 credits = $1) against your organization's balance. See dev.magicly.ai for pricing, keys and usage.
Development
npm install
npm run build # → dist/
MAGICLY_API_KEY=sk_live_... npm startAvailable Tools
3 toolsgenerateA
Generate an image or video with a Magicly model. Creates a prediction and (by default) waits for the result, returning the output URL(s). Use list_models to discover model ids and their inputs.
Inputs: model (required), prompt (required), seed, size, +4 more.
get_predictionA
Get the current status and output of a prediction by its id.
Inputs: id (required).
list_modelsA
List the available Magicly models with their id, media type, price ($) and supported inputs.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool has a clearly distinct purpose: generating content, checking prediction status, and listing available models. There is no overlap or ambiguity.
All tool names follow a consistent verb_noun pattern with lowercase and underscores (generate, get_prediction, list_models), making them predictable and easy to understand.
Three tools is appropriate for the server's scope: model discovery, content generation, and result retrieval. Each tool serves a necessary function without excess or deficiency.
The tool surface covers the full workflow: listing models to know available options, generating content with optional polling, and checking results asynchronously. No obvious gaps for the intended purpose.
Maintenance
Related MCP Connectors
Generate AI images and videos from any compatible MCP client.
Generate AI video, images and audio, and browse your history, from any MCP client.
Generate images, video, audio and short films with 140+ AI models from any MCP client.
Generate AI images, video, music, and sound effects, and upscale them, from any MCP client.
Related MCP Servers
- AlicenseAqualityCmaintenanceEnables generating and editing images and videos from any MCP client using SayMaker's model lineup, with credit cost reporting and async task polling.695 npmMIT
- AlicenseAqualityBmaintenanceEnables video and image generation from any MCP client, with support for models like Veo 3.1, Grok Imagine, and Nano Banana, including text-to-video, image-to-video, image generation and editing.478 npmMIT
- AlicenseNot gradedqualityAmaintenanceEnables MCP-compatible clients to generate images and videos, synthesize speech, clone voices, and design custom voices through MiniMax APIs.468 npmMIT
- AlicenseNot gradedqualityAmaintenanceEnables MCP-compatible clients to generate images and videos, create text-to-speech audio, clone voices, and design custom voices through MiniMax APIs.468 npmMIT