Back to Directory/Developer Tools

io.github.amortegui84/printscale-mcp

Upscale images to print-ready files (TIFF/PNG/JPG) via PrintScale.

Developer ToolsJavaScriptv1.0.2

printscale-mcp

An MCP server that lets AI agents (Claude Desktop, Cursor, Claude Code, etc.) upscale images to print-ready files (TIFF + PNG + JPG) via PrintScale.

Setup

  1. Create an API key at https://printscale.app/dashboard/api.
  2. Add the server to your MCP client config, with the key as an env var.

Claude Desktop / Cursor (mcp config)

{
  "mcpServers": {
    "printscale": {
      "command": "npx",
      "args": ["-y", "printscale-mcp"],
      "env": { "PRINTSCALE_API_KEY": "psk_live_xxxxxxxx" }
    }
  }
}

Claude Code (CLI)

claude mcp add printscale -e PRINTSCALE_API_KEY=psk_live_xxx -- npx -y printscale-mcp

Running locally from source instead of npm? Use "command": "node", "args": ["/path/to/printscale-mcp/index.mjs"].

Tools

  • printscale_upscale — upscale an image. Provide a public image_url or a local file_path. Choose mode (auto / 2x / 3x / print); for print, set cm and dpi. Returns TIFF/PNG/JPG download URLs. Charges credits.
  • printscale_job — check a job's status by id.
  • printscale_credits — show the remaining credit balance.

Example prompts

  • "Upscale ./product.jpg to 60 cm at 300 DPI for print."
  • "Upscale https://example.com/photo.png at 3x and give me the TIFF."
  • "How many PrintScale credits do I have left?"

Notes

  • Start from a sharp source — PrintScale enlarges detail, it doesn't repair blurry or low-quality images.
  • Outputs are available for 3 days, then deleted. Download within the window.
  • Credits are shared with your PrintScale account (buy them in the app).

Env: PRINTSCALE_API_KEY (required), PRINTSCALE_BASE_URL (optional, defaults to https://printscale.app).

Installation

Source-derived launch command. Check the maintainer’s required arguments and credentials before running:

bash
npx -y printscale-mcp

Set up in your AI client

Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.

json
{
  "mcpServers": {
    "io-github-amortegui84-printscale-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "printscale-mcp"
      ]
    }
  }
}

Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.

Claude Desktop setup reference

Package

printscale-mcpnpm

Compatible MCP Clients

io.github.amortegui84/printscale-mcp works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.

  • Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.
  • Cursor~/.cursor/mcp.jsonRestart Cursor for changes to take effect.
  • VS Code.vscode/mcp.jsonReload VS Code window for changes to take effect.
  • Windsurf~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect.
  • Claude Code.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.

Learn More