mcpField
P
printscale-mcp

printscale-mcp

Local
github.com/amortegui84Media & Design0Updated 18w ago
Repository

About printscale-mcp

printscale-mcp is an MCP server for AI agents that turns images into print-ready files through PrintScale. It supports image enlargement by URL or local path, print sizing, and job and credit checks.

Key features

  1. 01Upscale images by URL or file path
  2. 02Choose auto, 2x, 3x, or print mode
  3. 03Set print dimensions and DPI
  4. 04Return TIFF, PNG, and JPG download URLs
  5. 05Check job status and credit balance

Use cases

  1. 01Prepare a product image for large-format printing
  2. 02Enlarge an online image by a selected factor
  3. 03Check an upscale job or remaining credits

MCP support

The MCP server exposes PrintScale image upscaling, job-status, and credit-balance tools to MCP clients. It requires a PrintScale API key.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "amortegui84-printscale": {
      "command": "npx",
      "args": [
        "-y",
        "printscale-mcp"
      ],
      "env": {
        "PRINTSCALE_API_KEY": "<PRINTSCALE_API_KEY>"
      }
    }
  }
}
Run commandnpx -y printscale-mcp
Environment variables to set
PRINTSCALE_API_KEYSecretPrintScale API key (create one at https://printscale.app/dashboard/api)

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmprintscale-mcp1.0.2

Tools

3

Saved tool list · updated 2w ago

ParameterTypeRequiredDescription
cmnumberNoFor mode 'print': long side in centimeters
dpienumNoFor mode 'print': DPI (default 300)150 | 300 | 600
modeenumNoauto = 3x for small / 2x for large; 2x or 3x = fixed; print = exact sizeauto | 2x | 3x | print
file_pathstringNoPath to a local image file (jpg/png/webp)
image_urlstringNoPublic https URL of the image

Details

From the project README

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).

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.