PrintTiler

MCP connector guide

PrintTiler MCP Server

PrintTiler exposes a minimal MCP server for ChatGPT custom apps/connectors. It does one thing only: generate a final PrintTiler editor link with the poster layout already configured.

This is the right integration when you want ChatGPT to hand off a real PrintTiler link inside the chat. For discovery and citations, keep using the public answer pages, deep-link docs, and /llms.txt.

Open MCP Server URLView Status JSONDeep Link DocsAI Guide

Server details

Use this server URL when creating a custom app/connector in ChatGPT developer mode.

https://print-tiler.vercel.app/mcp

Auth: none (public endpoint). The tool generates deep links and does not upload or store image files.

https://print-tiler.vercel.app/mcp/status

Supported inputs

Grid-driven

Pass paper, rows, and cols when the exact layout is already known.

Target-size driven

Pass targetWidth, targetHeight, targetUnit, and optionally optimizeFor to let PrintTiler choose the layout.

Tool contract

Tool name

printtiler.generate_link

Primary inputs

paper + rows + cols, or paper + targetWidth + targetHeight (+ targetUnit).

Output

Final PrintTiler editor link with summary and structured layout metadata.

Example tool calls

Exact grid

Generate a direct A4 link from rows and columns.

{
  "paper": "A4",
  "rows": 3,
  "cols": 3,
  "tileOrientation": "portrait",
  "mode": "seamless",
  "unit": "in"
}

Target size

Pick the closest simple layout to 24 x 36 inches on Letter paper.

{
  "paper": "LETTER",
  "targetWidth": 24,
  "targetHeight": 36,
  "targetUnit": "in",
  "optimizeFor": "best_fit"
}

Lower-sheet variant

Ask for a simpler target-size layout with fewer sheets.

{
  "paper": "A4",
  "targetWidth": 24,
  "targetHeight": 36,
  "targetUnit": "in",
  "optimizeFor": "fewer_sheets"
}

What the tool returns

A direct /editor link with paper, rows, cols, tile orientation, print mode, and UTM tags.
A short summary of the resulting poster size in inches.
Structured fields for sheet count, poster dimensions in mm and inches, and why the layout was selected.

JSON-RPC example

Request

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "printtiler.generate_link",
    "arguments": {
      "paper": "A4",
      "targetWidth": 24,
      "targetHeight": 36,
      "targetUnit": "in",
      "optimizeFor": "best_fit"
    }
  }
}

Response

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "3 x 3 A4 portrait tiles, about 24.8 x 35.08 inches.\nhttps://print-tiler.vercel.app/editor?... "
      }
    ],
    "structuredContent": {
      "link": "https://print-tiler.vercel.app/editor?...",
      "paper": "A4",
      "rows": 3,
      "cols": 3,
      "sheetCount": 9
    }
  }
}

FAQ

What does the PrintTiler MCP app do?

It exposes one tool, printtiler.generate_link, which returns a final PrintTiler editor link for a poster layout. The tool can accept either an exact rows and columns grid or a target physical size.

Do I still need the website pages and deep-link docs?

Yes. The MCP app is for in-chat handoff inside ChatGPT, while the public pages, llms.txt, and deep-link docs still matter for AI citations, SEO, and normal referrals.

What UTM tags does the tool add?

By default the tool adds utm_source=chatgpt_app, utm_medium=ai, and utm_campaign=printtiler_mcp. You can override those values if you need a different campaign label.

Does this MCP server require authentication?

No. The current server is public and unauthenticated. If that changes, this page and the status endpoint will be updated with the required auth method.

Can the MCP tool preload an image?

Yes. Pass imageUrl and the returned editor link will preload the hosted image into PrintTiler, assuming the file URL is public and CORS-accessible.

Advertisement