PrintPal Remote MCP server · Free · No auth for read-only tools

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
Overview

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
REST + OpenAPI
POST /mcp/rest/<tool> · /mcp/openapi.json
Price
Free
Features

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.

Install

How to connect the PrintPal MCP server

  1. Copy the server URL: https://printpal.io/mcp.
  2. Add it to your client as a remote (HTTP) MCP server. Pick your client below for the exact command or config.
  3. 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_… (or Authorization: Bearer pp_live_…); never paste the key into a chat.
  4. 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.

Server URL

Remote MCP, Streamable HTTP.

https://printpal.io/mcp
Claude Code
claude mcp add --transport http printpal https://printpal.io/mcp
Gemini CLI
gemini mcp add --transport http printpal https://printpal.io/mcp
Cursor (~/.cursor/mcp.json)
{
  "mcpServers": {
    "printpal": { "url": "https://printpal.io/mcp" }
  }
}
VS Code / GitHub Copilot (.vscode/mcp.json)
{
  "servers": {
    "printpal": { "type": "http", "url": "https://printpal.io/mcp" }
  }
}
Windsurf (mcp_config.json)
{
  "mcpServers": {
    "printpal": { "serverUrl": "https://printpal.io/mcp" }
  }
}
stdio-only clients

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"]
    }
  }
}
REST (no MCP client needed)

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}'
Try it

Prompts to try in MCP Server

Find me a 3D printable headphone stand.
How much will a 45 g, 3.5 hour PLA print cost me?
What are the magic layer heights for an Ender 3 with a 0.4 mm nozzle?
My ABS print is warping at the corners. What should I change? Cite your sources.
Show me an Arduino + 3D printed desk gadget I can build this weekend.
Design a wall bracket for a 60 x 40 mm power supply with M3 holes 50 mm apart.

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.

ToolWhat it doesAccount?
search_3d_modelsFind free printable STL, 3MF and OBJ models in the PrintPal community library, with thumbnail, author, license and stats.No
get_3d_modelDetails, files, license and the page link for one free model.No
calculate_print_costMaterial, electricity, machine wear, labor and failure allowance, plus a suggested selling price.No
calculate_filament_usageFilament grams to metres to cost, and how much is left on a spool.No
calculate_layer_heightsZ-axis "magic number" layer heights for your printer's leadscrew and stepper.No
calculate_volumetric_flowCheck a print speed and layer height against your hotend's volumetric flow limit.No
search_learning_resourcesSearch the vendor-neutral 3D printing wiki, OpenSCAD and AI CAD docs, video tutorials and Academy courses.No
search_build_guidesFind Arduino / ESP32 + 3D-printed project guides by idea, difficulty, time and cost.No
get_build_guideBill of materials, downloadable files and every step of one build guide.No
open_cad_agent_linkLink that opens PrintPal's AI CAD agent with a design brief prefilled. Running the agent on printpal.io uses your credits.No
prepare_3d_generationCheck 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_modelStart a quoted generation on your PrintPal credits. Retrying the same request never charges twice.Connected account
check_3d_generationProgress of a generation you started, with a fresh download link once it is finished.Connected account
get_printpal_profileShows which PrintPal account is connected (display name and username only).Connected account
open_3d_generator_linkOpens PrintPal's AI 3D generator on printpal.io with a prompt prefilled. Generates nothing by itself.No
find_3d_printing_toolRecommend the right free PrintPal browser tool or calculator for a task.No
searchSearch everything on PrintPal at once: models, tools, wiki, docs, videos, guides and courses.No
fetchRead 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.

PromptArgumentsWhat it does
troubleshoot_printproblem, printer, materialDiagnoses a failed print and cites the PrintPal wiki articles it used.
design_a_partwhat, dimensionsChecks the library for an existing model, otherwise drafts a CAD brief and opens the AI CAD agent.
plan_a_buildidea, skill_levelFinds a matching build guide with its bill of materials and steps.

Endpoints

Everything the server exposes over HTTP.

PathPurpose
POST /mcpJSON-RPC over Streamable HTTP (stateless). Batches supported.
GET /.well-known/mcp.jsonServer card: transport, auth, tools and links, for crawlers and registries.
GET /mcp/openapi.jsonOpenAPI 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/healthLiveness, tool count and supported protocol versions.
GET /.well-known/oauth-protected-resourceOAuth protected-resource metadata (RFC 9728) pointing to PrintPal's authorization server.
GET /.well-known/oauth-authorization-serverAuthorization-server metadata (RFC 8414): authorize, token and revocation endpoints, PKCE S256, scopes models:generate and models:read.
GET /llms.txtMarkdown overview of PrintPal for LLMs, also exposed as the printpal://llms.txt resource.
Who it's for

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

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_source tag so we can see which assistant sent the visit; no identifier is attached.
FAQ

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.