Upscayl AI UpscalerUpscayl AI
Remote MCP server

AI image upscaling tools for Codex

Connect Upscayl to Codex or any compatible MCP client. Your assistant can discover the upscaler, check credits, start a 2x or 4x job and return the finished image—using the same paid account, API key and billing ledger as the REST API.

Get an API keyRead the setup guide
Connect with Codex
codex mcp add upscayl --url https://www.upscayl.app/api/mcp --bearer-token-env-var UPSCAYL_API_KEY

Store the key in an environment variable. The key is never placed directly in the Codex configuration.

Four focused tools, one predictable workflow

The first release exposes only the operations an assistant needs to upscale an image safely. More image APIs can be added under the same server later.

Discover products

upscayl_list_products

See available image tools, supported scales and the current credit price.

Check credits

upscayl_get_credit_balance

Confirm the authenticated account has enough credits before starting work.

Upscale an image

upscayl_upscale_image

Start an idempotent 2x or 4x upscale from a public HTTPS image URL.

Retrieve the result

upscayl_get_task

Poll a task owned by the same account and return its status or result URL.

Built for safe, asynchronous image work

MCP is a thin assistant-friendly layer over the existing Upscayl API, so task ownership, limits and refunds stay consistent.

  1. 01

    Connect once

    Create a paid-account API key and configure the remote MCP URL in Codex.

  2. 02

    Ask naturally

    Give Codex a public image URL and ask for 2x or 4x upscaling.

  3. 03

    Receive the result

    Codex submits the task, checks its status and returns the finished image URL.

The same protections as the public API

MCP requests do not bypass API controls or create a second credit system.

  • Bearer API key authentication; raw keys are shown once and stored only as SHA-256 hashes.
  • API activation requires a paid order, which prevents repeated free-account abuse.
  • Per-key rate limits, account concurrency limits and daily task limits still apply.
  • Each successful upscale costs 0.7 credit; failed tasks are automatically refunded.

MCP questions

What is the Upscayl MCP server?

It is a remote Model Context Protocol endpoint that lets compatible AI clients use Upscayl tools through structured, authenticated calls.

Does it work with Codex?

Yes. Codex supports remote Streamable HTTP MCP servers and bearer tokens supplied from an environment variable.

How much does an upscale cost?

A successful 2x or 4x standard upscale costs 0.7 credit. A failed task is refunded automatically.

Can I use the same API key for REST and MCP?

Yes. MCP reuses your Upscayl API key and account. You can create separate named keys if you want independent revocation and usage tracking.

Can more tools be added later?

Yes. Background removal and other image APIs can be registered as additional tools without changing the MCP URL or billing model.

Connect your first image tool

Purchase credits, create an API key and connect Upscayl to Codex in a few minutes.

Get an API key