MCP connector guide
PrintTiler MCP Server
PrintTiler exposes an MCP server for ChatGPT custom apps/connectors. It can generate a final PrintTiler editor link with the poster layout already configured and search public printable poster idea cards.
When ChatGPT has generated an image, the tool can include its public https://chatgpt.com/s/m_... image-share link in the handoff. The returned PrintTiler URL loads the original shared image through the source parameter.
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, idea cards, deep-link docs, and /llms.txt.
Server details
Use this server URL when creating a custom app/connector in ChatGPT developer mode.
https://printtiler.com/mcpAuth: none (public endpoint). The tools generate links and search public idea metadata; they do not upload or store image files.
https://printtiler.com/mcp/statusSupported 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.
Idea-search driven
Pass query and optional limit when the user wants poster ideas, templates, examples, or inspiration.
Image handoff
Pass imageUrl for a public direct image file. Pass sourceUrl for a public ChatGPT image share or Pinterest image Pin. Do not send both.
Tool contract
Tool names
printtiler.generate_link
printtiler.search_ideas
Primary inputs
paper + rows + cols, or paper + targetWidth + targetHeight (+ targetUnit), with optional imageUrl or sourceUrl.
Output
Final PrintTiler editor links, idea-card links, summaries, and structured 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"
}ChatGPT-generated image
Preload a public ChatGPT image share using sourceUrl.
{
"paper": "A4",
"rows": 4,
"cols": 4,
"mode": "seamless",
"sourceUrl": "https://chatgpt.com/s/m_0123456789abcdef0123456789abcdef"
}Idea-card search
Find matching printable poster idea cards and ready editor links.
{
"query": "kids football motivation",
"limit": 3
}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
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://printtiler.com/editor?... "
}
],
"structuredContent": {
"link": "https://printtiler.com/editor?...",
"paper": "A4",
"rows": 3,
"cols": 3,
"sheetCount": 9
}
}
}FAQ
What does the PrintTiler MCP app do?
It exposes tools for generating PrintTiler editor links and searching printable poster idea cards. Use printtiler.generate_link for layouts and printtiler.search_ideas for inspiration requests.
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?
The generate-link tool adds utm_source=chatgpt_app, utm_medium=ai-assistant, utm_campaign=printtiler_mcp, and utm_source_platform=openai by default. 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 for a public direct image file. For a public ChatGPT image share or Pinterest image Pin, pass sourceUrl instead. A private ChatGPT conversation attachment is not accessible unless it has been made into a public image share.
Can the MCP app return idea-card links?
Yes. Use printtiler.search_ideas with a query such as football motivation, classroom alphabet, birthday dinosaur, peace poster, or wall art. It returns public /ideas/[slug] links plus ready editor links.