lulu-print-mcp

An MCP server for the Lulu Print API. It lets Claude and other AI assistants price, validate, order and track print-on-demand books.

• Covers the whole API. There is one tool for each of the 22 operations in Lulu's published OpenAPI spec, and a test fails if any operation is missing.

• Built exactly to the spec. Every input rule and every request is checked against Lulu's own spec in the test suite. The few places where the spec contradicts itself are written up in docs/spec-notes.md.

• Safe by default. It uses Lulu's sandbox unless you choose production, so you can't place a real order by accident.

• Ready for Lulu's new product codes. It accepts the dotted pod_package_id format, and the old 27-character format until Lulu retires it on 1 February 2027.

Install

You need Node.js 22 or newer and Lulu API keys. Get your keys from the sandbox developer portal (free test orders) or the production portal (real orders). The two environments use different keys.

Claude Desktop

Add this to claude_desktop_config.json (in Claude Desktop, go to Settings → Developer → Edit Config), then restart Claude Desktop:

{
  "mcpServers": {
    "lulu-print": {
      "command": "npx",
      "args": ["-y", "lulu-print-mcp"],
      "env": {
        "LULU_CLIENT_KEY": "your-client-key",
        "LULU_CLIENT_SECRET": "your-client-secret",
        "LULU_ENVIRONMENT": "sandbox"
      }
    }
  }
}

Claude Code

claude mcp add lulu-print -e LULU_CLIENT_KEY=your-client-key -e LULU_CLIENT_SECRET=your-client-secret -e LULU_ENVIRONMENT=sandbox -- npx -y lulu-print-mcp

Other MCP clients

Run npx -y lulu-print-mcp as a stdio server with the environment variables below.

Related MCP server: Printful MCP Server

Configuration

Production places real orders. In production, create_print_job and reprint_print_job create orders that stay unpaid until you pay for them in Lulu's portal, or that are charged automatically if a card is on file. The server tells the assistant to confirm with you before ordering. Use production_delay to leave time to cancel.

Tools

A typical order goes like this:

1. calculate_cover_dimensions to get the cover size for the book.

2. validate_interior_file and validate_cover_file to check the PDFs.

3. get_shipping_options to see delivery choices.

4. calculate_print_job_cost to get the price.

5. create_print_job to place the order.

6. get_print_job_status to track it.

Tools that only read data are marked read-only, and cancel_print_job and delete_webhook are marked destructive, so MCP clients can ask before running them.

Use it as a library

import { createLuluServer, LuluClient, loadConfig } from "lulu-print-mcp";

const client = new LuluClient(loadConfig());
const jobs = await client.request({ method: "GET", path: "/print-jobs/", query: { page_size: 10 } });

How it's kept exact

• spec/openapi_public.yml is a byte-for-byte copy of Lulu's published spec.

• The rule tests read every required field, length limit, range, enum, type and format from the spec, and check that each tool accepts and rejects exactly the same values. If Lulu changes a rule, the failing test names the field.

• The contract tests check that:

  • every operation in the spec has exactly one tool;

  • every request each tool sends passes validation against the spec;

  • each tool can send every writable field in the spec;

  • no tool sends a field the spec doesn't document.

• Live tests run every tool against Lulu's sandbox.

• A weekly GitHub Action compares our copy with Lulu's live spec and opens an issue if Lulu changes it.

Development

npm install
npm run check

npm run check runs type checking, lint, the tests with coverage, and the build.

To run the live sandbox tests:

LULU_SANDBOX_CLIENT_KEY=... LULU_SANDBOX_CLIENT_SECRET=... npm run test:sandbox

To see whether Lulu has changed its spec:

npm run spec:check

See CONTRIBUTING.md for more.

License

MIT. This project is not affiliated with or endorsed by Lulu Press, Inc.