io.github.maginaryai/maginary-mcp
io.github.maginaryai/maginary-mcp · v0.3.18 · MCP 2025-11-25
AI image + video generation for agents: --flag prompt DSL, async generate/poll, x402 pay-per-use.
Reachability
reachable
checked 2026-09-20 05:31 UTC
Registry status active
Tools pinned 16
18eb50bedaa7
Tools last changed
unchanged since first capture 2026-09-16
Repo last push 2026-09-15
GitHub stars 1
Provenance
Registry namespace io.github.maginaryai
(GitHub-account verified by the official registry)
Repository
github.com/maginaryai/maginary-mcp
Website
https://maginary.ai/mcp
Remote endpoints
https://mcp.maginary.ai/mcp (streamable-http)
Observed changes
| When (UTC) | Event | Detail |
|---|---|---|
| 2026-09-16 05:30 | first capture | 16 tools pinned |
Pinned tool definitions (16)
| Tool | Description |
|---|---|
| list_parameters | 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`` /... |
| search_parameters | 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... |
| get_parameter | 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... |
| generate | 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... |
| get_generation | 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... |
| wait_for_generation | 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... |
| upload_image | 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``... |
| execute_action | 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... |
| create_account | 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... |
| create_wallet_account | 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... |
| check_account_status | 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... |
| manage_api_key | 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... |
| configure_api_key | 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... |
| get_products | 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: ... |
| checkout | 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... |
| get_balance | 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... |
Get alerted when this changes.
Email the moment io.github.maginaryai/maginary-mcp drifts, dies, or revives.
Status badge
[](https://toolpin.dev/servers/io.github.maginaryai/maginary-mcp)
Maintain this server? Add the badge to your README. It links your users to this live status page.