io.github.amortegui84/printscale-mcp
Upscale images to print-ready files (TIFF/PNG/JPG) via PrintScale.
Open source Open in the app JSON README (API)
About
Upscale images to print-ready files (TIFF/PNG/JPG) via PrintScale.
Details
- Kind
- MCP servers
- Topic
- No topic detected
- Publisher
- amortegui84
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 1.0.2
- Last push
- 2026-06-27T15:52:41Z
- Repository state
- ativo
- Language
- JavaScript
- License
- MIT
- Added
- 2026-08-29 03:02:25
- Updated
- 2026-08-29 03:02:25
- Origin id
io.github.amortegui84/printscale-mcp
README
# printscale-mcp
An [MCP](https://modelcontextprotocol.io) server that lets AI agents (Claude
Desktop, Cursor, Claude Code, etc.) upscale images to **print-ready** files
(TIFF + PNG + JPG) via [PrintScale](https://printscale.app).
## 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)
```json
{
"mcpServers": {
"printscale": {
"command": "npx",
"args": ["-y", "printscale-mcp"],
"env": { "PRINTSCALE_API_KEY": "psk_live_xxxxxxxx" }
}
}
}
```
### Claude Code (CLI)
```bash
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`).