MCP server

Maginary Official

io.github.maginaryai/maginary-mcp

Checked 26 Oct 2026, 08:29 UTC · Connected to it and listed its tools

AI image + video generation for agents: --flag prompt DSL, async generate/poll, x402 pay-per-use.

Website Source

At a glance

Type

MCP server

Publisher

maginary.ai (verified by the MCP Registry)

Status

Working at last check

Tools

16

Token cost

About 6,275 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

26 Oct 2026, 08:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

claude mcp add --transport http maginary-mcp https://mcp.maginary.ai/mcp

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.maginary-mcp]
url = "https://mcp.maginary.ai/mcp"

Gemini CLI

{"mcpServers":{"maginary-mcp":{"httpUrl":"https://mcp.maginary.ai/mcp"}}}

Cursor

{"mcpServers":{"maginary-mcp":{"url":"https://mcp.maginary.ai/mcp"}}}

VS Code

{"servers":{"maginary-mcp":{"type":"http","url":"https://mcp.maginary.ai/mcp"}}}

Antigravity

agy mcp add maginary-mcp https://mcp.maginary.ai/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"maginary-mcp","server_url":"https://mcp.maginary.ai/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"maginary-mcp","server_url":"https://mcp.maginary.ai/mcp"}

Tools

• check_account_status ~283 tokens
  Check account verification status, credit balance, and API key count. Use this after ``create_account`` to poll whether the user has clicked the verification link. Pass ``email`` + ``password`` (from ``create_account``) for Basic auth, or omit both to use the configured API key. Ar
• checkout Moves money · ~417 tokens
  Create a Stripe checkout session for purchasing a product. Returns a ``checkout_url`` — the user must open it in a browser to complete payment. After payment, credits are provisioned automatically via webhook. **Present the URL exactly as returned, including the ``#fragment`` — do n
• configure_api_key ~270 tokens
  Activate an API key. Local (stdio) servers persist it; hosted does not. Call this after ``manage_api_key(action='create')`` returns a ``raw_key``. On a local server the key is saved to ``~/.config/maginary/api_key`` (chmod 600) and survives restarts. On the hosted server (mcp.magina
• create_account Changes accounts · ~290 tokens
  Create a new Maginary account for the given email address. Returns the auto-generated password — display it to the user ONCE so they can save it. A verification email is sent; the user must click the link before the account can generate images. After verification, use ``manage_api_
• create_wallet_account ~495 tokens
  Create (or access) a Maginary account using a wallet signature. Sign the message ``Maginary: authenticate <address> at <timestamp>. This does not move funds.`` with EIP-191 ``personal_sign`` and pass all three values. On success, an API key is returned immediately — no email verific
• execute_action ~886 tokens
  Run a follow-up action on a completed generation's image. After ``generate`` → ``wait_for_generation``, the response's ``processing_result.available_actions`` lists what's possible per slot. Call this tool with one of those action types. Args: generation_uuid: UUID of the p
• generate ~712 tokens
  Kick off a generation via POST /api/gens/. Args: prompt: The user's words, passed through as-is. Do NOT add flags the user did not ask for — no ``--ar``, no ``--flagship``, no model flags. Every extra flag costs credits; adding them unrequested is wro
• get_balance ~190 tokens
  Check remaining credits and uploads for the authenticated account. Args: email: Account email (for Basic auth). password: Account password (for Basic auth). Returns: Dict with ``credits_remaining`` and ``uploads_remaining``.
• get_generation ~366 tokens
  Fetch a generation by UUID (GET /api/gens/{uuid}/). Args: uuid: The UUID returned by ``generate``. Returns: The full generation record. If terminal, ``image_urls[]`` holds the finished outputs and ``processing_result.slots[]`` the per-slot detail. NOTE: a ge
• get_parameter ~175 tokens
  Return the full record for a single parameter (canonical name or alias). Args: name: Parameter name with or without leading ``--`` (e.g. ``ar``, ``--ar``, ``aspect``). Case-insensitive. Returns: The parameter dict. Not-found is an ``isError`` result — surface it
• get_products ~210 tokens
  List available Maginary products/plans with pricing. No authentication required. Use this to present purchase options to the user. The ``novice_pack`` ($10, 150 credits) is the recommended starting point. Returns: Dict with ``count`` and ``products`` — each product carries
• list_parameters ~382 tokens
  List Maginary prompt-DSL parameters. Args: category: Restrict to one category (e.g. ``composition``, ``video``, ``model``, ``outpaint``). Call with no filters once — the response's ``categories`` / ``statuses`` maps are the full taxonomy. status: Restrict
• manage_api_key ~456 tokens
  Create, list, or revoke Maginary API keys (up to 10 per account). Auth: pass ``email`` + ``password`` for Basic auth (onboarding), or omit both to use the configured API key (normal operation). Args: action: One of ``create``, ``list``, ``revoke``. name: Key name (requi
• search_parameters ~285 tokens
  Text-search over parameter names, aliases, descriptions, values, examples. Args: query: Substring match, case-insensitive. category: Optional single-category restriction. include_reserved: Whether to include ``unimplemented`` parameters. Returns: Dict with `
• upload_image ~310 tokens
  Upload a local image and get a CDN URL for img2img or ``--sref``. Only available on local (stdio) connections. On hosted/remote connections, place an existing image URL directly in the prompt. Place the returned ``url`` in a ``generate`` prompt: ``generate("https://cdn.maginary.ai
• wait_for_generation ~548 tokens
  Poll ``get_generation`` on a backoff until it reaches done / failed. Args: uuid: The UUID returned by ``generate``. timeout_s: Return after this many seconds even if still running. Default 45 stays under the 60 s per-call limit most MCP clients enforce; a

Browse

• GitHub tools
• Stripe tools
• Email
• Payments
• GitHub and code hosting
• Image generation

Related MCP servers

• Vap E
  AI image, video & music generation. Flux, Veo 3.1, Suno V5. Free tier included.
• Agentic Commerce Catalog
  AI music, video, image, and voice tools callable by agents with USDC payments via x402 on Base.
• CCAPI
  Image, video, music and text generation across 100+ models through one endpoint.
• Switchapp Switch
  Generate, manage and explore your Switch AI image and video library, scoped to your account.
• Ai Content Drop
  Make AI videos, images, ads and short dramas from a description, priced first. Sign in to create.
• Budgetpixel
  Generate AI images, video, music, and sound effects, and upscale them, from any MCP client.
• Private AI Media Generation
  Paid AI image/video generation for agents — x402 USDC or API key, no account needed.
• Clueso
  Make videos and docs with your AI agent — describe what you need, every output stays editable.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.github.maginaryai/maginary-mcp.svg)](https://aptlynx.net/servers/io.github.maginaryai/maginary-mcp)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents