The PrintPal MCP server: 3D printing tools for any AI agent
One URL gives ChatGPT, Claude, Gemini, Cursor, VS Code and any other MCP client 18 tools for 3D printing. Stateless Streamable HTTP, anonymous read-only tools, account-linked AI generation, listed in the official MCP Registry.
- Free
- Anonymous read-only tools
- Stateless JSON (no SSE)
- Official MCP Registry
- material $0.90 · electricity $0.05
- failure allowance (5%) $0.05
- cost per print $1.00
What is PrintPal MCP Server?
The PrintPal MCP server is a free, public Model Context Protocol server at https://printpal.io/mcp, published by PrintPal as io.printpal/printpal in the official MCP Registry. It gives AI assistants and agents 18 tools for 3D printing: searching a community library of printable models, print-cost and calibration calculators, a vendor-neutral troubleshooting wiki with full-text fetch for citations, Arduino and ESP32 build guides, credit-metered AI 3D generation, and a hand-off to PrintPal's parametric AI CAD agent.
It speaks stateless Streamable HTTP with plain JSON responses and also exposes the tools as REST endpoints with an OpenAPI 3.1 description. Read-only tools need no authentication. The generation tools need a connected PrintPal account: OAuth account linking for ChatGPT, or X-API-Key / Authorization: Bearer <API key> for other clients.
Updated October 27, 2026 · Made by PrintPal
At a glance
- Endpoint
https://printpal.io/mcp- Transport
- Streamable HTTP, stateless, JSON responses (no SSE)
- Authentication
- None for read-only tools. Generation: OAuth 2.1 (ChatGPT) or a PrintPal API key.
- Tools / prompts / resources
- 18 / 3 / 3
- Registry name
io.printpal/printpal- Server card
- /.well-known/mcp.json
- REST + OpenAPI
POST /mcp/rest/<tool>· /mcp/openapi.json- Price
- Free
What PrintPal MCP Server can do
Works in every MCP client
ChatGPT, Claude, Gemini, Cursor, VS Code with GitHub Copilot, Windsurf and any client that supports remote Streamable HTTP servers.
No sessions, auth only where it matters
Stateless JSON-RPC over HTTP with CORS enabled. Read-only tools are anonymous; each generation tool declares its own security scheme and answers with a sign-in challenge when no account is connected.
Built for citations
search and fetch follow the connector contract, so assistants can read a full wiki article and link to it.
MCP App widgets
Model search results render as interactive cards (ui://widget/printpal-models-v2.html), and generations show cost, progress and the download in ui://widget/printpal-generation-v1.html, in hosts that support MCP Apps.
Honest annotations
Every tool declares readOnlyHint, destructiveHint and openWorldHint. Only generate_3d_model spends credits, it needs a cost quote from prepare_3d_generation, and retrying the same request never charges twice.
REST and OpenAPI too
Call any tool with a JSON body at /mcp/rest/<tool> from scripts, Zapier or Custom GPT Actions.
How to connect the PrintPal MCP server
- Copy the server URL:
https://printpal.io/mcp. - Add it to your client as a remote (HTTP) MCP server. Pick your client below for the exact command or config.
- Leave authentication off for search, calculators, the wiki and build guides. For AI 3D generation on your own credits, configure your client to send
X-API-Key: pp_live_…(orAuthorization: Bearer pp_live_…); never paste the key into a chat. - Ask your assistant a 3D printing question. It will discover the 18 tools automatically.
Clients that only support local stdio servers can bridge with npx -y mcp-remote https://printpal.io/mcp.
Remote MCP, Streamable HTTP.
https://printpal.io/mcp
claude mcp add --transport http printpal https://printpal.io/mcp
gemini mcp add --transport http printpal https://printpal.io/mcp
{
"mcpServers": {
"printpal": { "url": "https://printpal.io/mcp" }
}
}
{
"servers": {
"printpal": { "type": "http", "url": "https://printpal.io/mcp" }
}
}
{
"mcpServers": {
"printpal": { "serverUrl": "https://printpal.io/mcp" }
}
}
Bridges a local stdio client to the remote server. Requires Node.js 18+.
{
"mcpServers": {
"printpal": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://printpal.io/mcp"]
}
}
}
Every tool is also a plain JSON endpoint.
curl -s https://printpal.io/mcp/rest/calculate_print_cost \
-H 'Content-Type: application/json' \
-d '{"print_weight_grams": 45, "print_time_hours": 3.5}'
Prompts to try in MCP Server
The 18 PrintPal tools
Every AI assistant integration exposes the same tools from the PrintPal MCP server. Fourteen work without an account. The generation and profile tools need a connected PrintPal account: sign-in with PrintPal in ChatGPT, or a PrintPal API key in clients where you can set a request header. Only generate_3d_model spends credits, and only with a cost quote from prepare_3d_generation that the assistant is instructed to confirm with you first.
| Tool | What it does | Account? |
|---|---|---|
search_3d_models | Find free printable STL, 3MF and OBJ models in the PrintPal community library, with thumbnail, author, license and stats. | No |
get_3d_model | Details, files, license and the page link for one free model. | No |
calculate_print_cost | Material, electricity, machine wear, labor and failure allowance, plus a suggested selling price. | No |
calculate_filament_usage | Filament grams to metres to cost, and how much is left on a spool. | No |
calculate_layer_heights | Z-axis "magic number" layer heights for your printer's leadscrew and stepper. | No |
calculate_volumetric_flow | Check a print speed and layer height against your hotend's volumetric flow limit. | No |
search_learning_resources | Search the vendor-neutral 3D printing wiki, OpenSCAD and AI CAD docs, video tutorials and Academy courses. | No |
search_build_guides | Find Arduino / ESP32 + 3D-printed project guides by idea, difficulty, time and cost. | No |
get_build_guide | Bill of materials, downloadable files and every step of one build guide. | No |
open_cad_agent_link | Link that opens PrintPal's AI CAD agent with a design brief prefilled. Running the agent on printpal.io uses your credits. | No |
prepare_3d_generation | Check an AI text-to-3D or image-to-3D request and quote its exact credit cost. Starts nothing and charges nothing. | Connected account |
generate_3d_model | Start a quoted generation on your PrintPal credits. Retrying the same request never charges twice. | Connected account |
check_3d_generation | Progress of a generation you started, with a fresh download link once it is finished. | Connected account |
get_printpal_profile | Shows which PrintPal account is connected (display name and username only). | Connected account |
open_3d_generator_link | Opens PrintPal's AI 3D generator on printpal.io with a prompt prefilled. Generates nothing by itself. | No |
find_3d_printing_tool | Recommend the right free PrintPal browser tool or calculator for a task. | No |
search | Search everything on PrintPal at once: models, tools, wiki, docs, videos, guides and courses. | No |
fetch | Read any search result in full (for example a wiki article) so the assistant can quote and cite it. | No |
Built-in prompts
Clients that support MCP prompts (Claude, Cursor and others) list these as one-click starting points.
| Prompt | Arguments | What it does |
|---|---|---|
troubleshoot_print | problem, printer, material | Diagnoses a failed print and cites the PrintPal wiki articles it used. |
design_a_part | what, dimensions | Checks the library for an existing model, otherwise drafts a CAD brief and opens the AI CAD agent. |
plan_a_build | idea, skill_level | Finds a matching build guide with its bill of materials and steps. |
Endpoints
Everything the server exposes over HTTP.
| Path | Purpose |
|---|---|
POST /mcp | JSON-RPC over Streamable HTTP (stateless). Batches supported. |
GET /.well-known/mcp.json | Server card: transport, auth, tools and links, for crawlers and registries. |
GET /mcp/openapi.json | OpenAPI 3.1 description of the REST shim, for Custom GPT Actions and HTTP agents. |
POST /mcp/rest/<tool> | Call one tool with a JSON body and get its structured result. |
GET /mcp/health | Liveness, tool count and supported protocol versions. |
GET /.well-known/oauth-protected-resource | OAuth protected-resource metadata (RFC 9728) pointing to PrintPal's authorization server. |
GET /.well-known/oauth-authorization-server | Authorization-server metadata (RFC 8414): authorize, token and revocation endpoints, PKCE S256, scopes models:generate and models:read. |
GET /llms.txt | Markdown overview of PrintPal for LLMs, also exposed as the printpal://llms.txt resource. |
Who uses PrintPal MCP Server
Agent builders
Add 3D printing knowledge to a support bot, a print-farm assistant or a classroom tutor.
IDE assistants
Let Copilot, Cursor or Windsurf look up models, docs and print costs while you build hardware projects.
Automations
Call the REST shim from Zapier, n8n or a cron job to price prints or search the library.
Researchers and evals
A stable, public MCP server with anonymous read-only tools is a handy fixture for testing MCP clients.
Privacy and how it works
What PrintPal MCP Server sends, stores and never touches.
- Search, calculator, wiki and build-guide tools work without an account, and those requests are not saved to a PrintPal account.
- PrintPal only receives what the assistant sends to a tool: a search phrase, calculator numbers, a model id, or a generation prompt and attached image. It does not receive the rest of your conversation.
- AI 3D generation needs a connected PrintPal account. In ChatGPT you sign in to PrintPal and approve access, and ChatGPT gets its own revocable token, never your password or API key. In other clients you can send a PrintPal API key in a request header. Never paste either into a chat.
- Generation prompts, attached images, the generated models and their credit charges are saved to your PrintPal account history, like generations made on printpal.io, and are covered by the PrintPal privacy policy. To produce the model, the prompt or image is sent to the AI generation services PrintPal uses for the chosen quality.
- You can see and disconnect linked assistants at any time under Connected apps; disconnecting stops their access immediately.
- Links back to printpal.io carry a
utm_sourcetag so we can see which assistant sent the visit; no identifier is attached.
Frequently asked questions about PrintPal MCP Server
What is the PrintPal MCP server?
It is a free, public Model Context Protocol server at https://printpal.io/mcp that gives AI assistants 18 tools for 3D printing: model search, print-cost and calibration calculators, a cited troubleshooting wiki, Arduino and ESP32 build guides, credit-metered AI 3D generation and a hand-off to PrintPal's AI CAD agent. It is listed in the official MCP Registry as io.printpal/printpal.
Does the PrintPal MCP server need authentication?
Not for the read-only tools. The generation tools (prepare_3d_generation, generate_3d_model, check_3d_generation) and get_printpal_profile need a connected PrintPal account. ChatGPT links the account with OAuth 2.1 (authorization code with PKCE, scopes models:generate and models:read); other clients send a PrintPal API key in the X-API-Key or Authorization: Bearer header. Without one, those tools answer with a sign-in challenge instead of a result.
Which MCP clients does it work with?
Any client that supports remote Streamable HTTP servers, including ChatGPT, Claude.ai, Claude Desktop, Claude Code, Gemini CLI, Cursor, VS Code with GitHub Copilot and Windsurf. Clients limited to stdio can use npx mcp-remote https://printpal.io/mcp.
Does it use SSE?
No. The server is stateless Streamable HTTP and always answers with plain JSON. GET /mcp returns 405 because it does not open a server-to-client stream, which the specification allows.
Can I call the tools without an MCP client?
Yes. Each tool is available at POST https://printpal.io/mcp/rest/<tool> with a JSON body, and https://printpal.io/mcp/openapi.json describes them in OpenAPI 3.1 for Custom GPT Actions and other HTTP callers.
Is the PrintPal MCP server free?
Yes. Only AI 3D generation costs PrintPal credits, and only on a connected account after prepare_3d_generation has quoted the cost. Without an account, open_3d_generator_link returns a prefilled link to printpal.io instead.
Does it store my data?
The MCP transport keeps no session, but some calls do create records. Anonymous read-only calls are not saved to an account. Generations are saved to your PrintPal account history with their prompt, any attached image, the settings and the credit charge, and ChatGPT account links are stored until you disconnect them. These records are covered by the PrintPal privacy policy.
Get PrintPal MCP Server
One free remote MCP endpoint with 18 tools for 3D printing. Works in any client that speaks Streamable HTTP. Free to install. See all integrations.