How do I install PrintYourDuck Quote?

Copy the http config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does PrintYourDuck Quote need an API key?

No required environment variable is listed on this record.

What transport does PrintYourDuck Quote use?

PrintYourDuck Quote is reached over HTTP.

When was PrintYourDuck Quote last checked?

Last checked 2026-11-08. Find and submit local 3D print files for manual PrintYourDuck quote review.

PrintYourDuck Quote MCP server

Power your agent

Add this server

The publisher's own URL. Not a PlugMCP endpoint.

Add to Cursor Add in Claude Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Server URL

https://printyourduck.com/api/mcp

The Claude button above opens Claude with the name and URL filled in. You still confirm it there.

shClaude Code

1claude mcp add --transport http com.printyourduck-quote https://printyourduck.com/api/mcp

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "com.printyourduck-quote": {4      "command": "npx",5      "args": [6        "-y",7        "mcp-remote",8        "https://printyourduck.com/api/mcp"9      ]10    }11  }12}

claude_desktop_config.json

Remote · HTTPPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Remote

Transport: http
Version: 0.1.1
Last checked

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

PrintYourDuck MCP

MCP server for sending local 3D print files to PrintYourDuck manual quote review. It is built for coding-agent workflows where the user has generated or selected a local .stl, .step, .stp, .3mf, .obj, or .zip file and wants help preparing a quote request.

The server is preconfigured for https://printyourduck.com. Users do not need to supply an API URL, API key, or shop routing configuration.

Status

Surface	Status
Remote MCP	Live at `https://printyourduck.com/api/mcp`
Local stdio package	Available via npm as `@printyourduck/mcp`
npm package	Public: `@printyourduck/mcp`
OCI image	Release target: `ghcr.io/printyourduck/printyourduck-mcp:<version>`
MCP Registry	Live as `com.printyourduck/quote`

npx is the primary install path today. Use Docker only after verifying the GHCR image is publicly pullable for the target version.

Why This Exists

3D-print quote workflows are easy to get wrong when a user is coming from code, CAD generation, or rapid prototyping. This MCP server gives agents a narrow, auditable workflow:

Read the public quote requirements.
Find recent printable files in the current project.
Ask the user to choose one file and confirm the required safety statements.
Upload that file through PrintYourDuck's private upload flow.
Submit the manual quote request.
Check public-safe quote status by quote ID and customer email.

It does not calculate instant pricing, collect payment at upload, automate checkout, or expose private operational details.

Install

Use this now:

npx -y @printyourduck/mcp

For team-shared or reproducible client configs, pin a package version:

npx -y @printyourduck/mcp@<version>

Client Setup

MCP client configuration files are not identical across clients. Use the shape expected by your client, then restart or refresh that client so it reloads the server.

Claude Code, local user setup:

claude mcp add --transport stdio printyourduck -- npx -y @printyourduck/mcp

Claude Code, project-shared .mcp.json:

{
  "mcpServers": {
    "printyourduck": {
      "command": "npx",
      "args": ["-y", "@printyourduck/mcp"]
    }
  }
}

Use project-shared .mcp.json only when a repository should intentionally offer PrintYourDuck tools to everyone opening that project. Claude Code prompts for approval before using project-scoped MCP servers.

VS Code workspace setup in .vscode/mcp.json:

{
  "servers": {
    "printyourduck": {
      "command": "npx",
      "args": ["-y", "@printyourduck/mcp"]
    }
  }
}

Clients that use the common mcpServers shape can use the Claude Code project snippet above.

Test the local server with MCP Inspector:

npx -y @modelcontextprotocol/inspector npx -y @printyourduck/mcp

Docker, after verifying the GHCR image is public:

docker run --rm -i ghcr.io/printyourduck/printyourduck-mcp:<version>

Remote-capable MCP clients can connect today:

https://printyourduck.com/api/mcp

Claude Code remote HTTP setup:

claude mcp add --transport http printyourduck https://printyourduck.com/api/mcp

Tools

Tool	Purpose	Network/File Access
`get_printyourduck_quote_requirements`	Returns accepted file types, material choices, required confirmations, and safety boundaries.	No local file access. No network.
`find_recent_printable_files`	Finds recent printable files under an allowed local project directory.	Read-only local file metadata.
`submit_local_file_for_quote`	Uploads one user-approved local file and creates a manual quote request.	Reads one allowed local file, uploads privately, then submits to PrintYourDuck.
`get_quote_status`	Looks up public-safe quote status with quote ID and matching email.	Network request to PrintYourDuck only.

Local file discovery and upload are limited to the current working directory by default. Set PRINTYOURDUCK_MCP_ALLOWED_ROOTS to a path-delimited allowlist when the MCP client should access additional project directories.

submit_local_file_for_quote derives a stable submissionId from the selected file and quote details unless the caller provides one. Reuse that ID on retry to avoid duplicate manual quote requests. The helper also caches the uploaded private file key locally by submissionId and file hash so retries can reuse the same uploaded file reference when the upload service returns a generated Blob key.

Guardrails

This server preserves the PrintYourDuck manual-quote boundary:

no instant pricing today;
no payment at upload;
no checkout automation;
no local-production, Canadian-made-production, or guaranteed-delivery claims;
no supplier locations, fulfilment routes, carrier strategy, supplier costs, margin logic, private file references, or customer data in public responses.

Price ranges or instant estimates are a valid future capability only when they are explicitly scoped, tested, publicly documented, and clearly separated from checkout or payment collection.

Development

pnpm install
pnpm check:release

Useful checks:

pnpm check          # lint, tests, typecheck
pnpm check:security # audit, gitleaks, trufflehog
pnpm check:mcp      # stdio initialize, tool list, fixture discovery, path guard
pnpm check:pack     # npm tarball allowlist

pnpm check:mcp builds the server, starts it over stdio, verifies initialize and tool metadata, creates a temporary .stl fixture, verifies local discovery, and verifies files outside allowed roots are rejected before upload.

Run the live production smoke only when you intentionally want to create a real quote request:

PRINTYOURDUCK_MCP_LIVE_SMOKE=1 \
[email protected] \
pnpm smoke:live

The live smoke uploads a tiny fixture through https://printyourduck.com, submits one manual quote request, and verifies get_quote_status returns.

Release Checklist

Only claim npm local-helper installability after all of these pass:

pnpm check:release
npm view @printyourduck/mcp version
VERSION="$(npm view @printyourduck/mcp version)"
gh release view "mcp-v${VERSION}"
PRINTYOURDUCK_MCP_LIVE_SMOKE=1 [email protected] pnpm smoke:live

Release npm package changes from this dedicated MCP repository, not from the website repository.

For each tagged release, verify the npm package was published from the tagged commit:

VERSION="$(node -p "require('./package.json').version")"
test "$(npm view "@printyourduck/mcp@${VERSION}" gitHead)" = "$(git rev-parse HEAD)"
npm view "@printyourduck/mcp@${VERSION}" dist.tarball dist.integrity

The MCP Registry name is com.printyourduck/quote, so publication uses domain-based HTTP authentication for printyourduck.com. Serve the public v=MCPv1; ... record from https://printyourduck.com/.well-known/mcp-registry-auth and keep the matching private key only in the MCP_REGISTRY_PRIVATE_KEY GitHub Actions secret for this repository.

Only claim MCP Registry publication after this passes:

curl -f "https://registry.modelcontextprotocol.io/v0/servers/com.printyourduck%2Fquote/versions"

Before tagging a release, make the GHCR package public in GitHub's package settings. The release workflow fails before publishing npm if ghcr.io/printyourduck/printyourduck-mcp is still private, because the public release must be anonymously pullable.

Only claim OCI/container installability after making package visibility public and running:

VERSION="$(node -p "require('./package.json').version")"
DOCKER_CONFIG="$(mktemp -d)" docker manifest inspect "ghcr.io/printyourduck/printyourduck-mcp:${VERSION}"

Contributing

See CONTRIBUTING.md. Good first areas include client setup docs, path-safety hardening, MCP metadata safety, package release checks, and public-safe examples.

For security issues, see SECURITY.md. Do not include secrets, customer files, private file references, supplier/cost/margin details, or dashboard screenshots in public issues.

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install PrintYourDuck Quote?

Does PrintYourDuck Quote need an API key?

What transport does PrintYourDuck Quote use?

When was PrintYourDuck Quote last checked?

Documentation

PrintYourDuck MCP

Status

Why This Exists

Install

Client Setup

Tools

Guardrails

Development

Release Checklist

Contributing