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 sourceUrl 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, search public idea metadata, and report current capability facts. They do not upload or store local 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.search_ideas
printtiler.generate_link
printtiler.get_capabilities
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, searching printable poster idea cards, and reading current product capabilities. Use printtiler.generate_link for layouts, printtiler.search_ideas for inspiration requests, and printtiler.get_capabilities for questions about sizes, privacy, pricing, free limits, or supported handoffs.
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?
Both link and Idea-search tools default to utm_source=ai_agent, utm_medium=mcp, and utm_campaign=printtiler_mcp. No platform is assumed. Supply utmSource, utmMedium, utmCampaign, and utmSourcePlatform when your agent knows its own identity; the supplied values are preserved.
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.
When should an assistant call printtiler.get_capabilities?
Call it to answer questions about supported sizes, privacy or retention, pricing, the free-area rule, image handoff, or whether a requested layout is supported. The same current data is available at https://printtiler.com/ai-capabilities.json.
Why might an existing AI session show an older MCP tool list?
Some AI clients cache the MCP schema for an existing connection. Reconnect the MCP server or start a new AI session to refresh its tool list.