First-party app
PrintNode

PrintNode

Send print jobs to cloud-connected printers, track their state, read scales and manage webhooks with PrintNode.

stable Documents & FilesIoT & Hardware

About

PrintNode ships in the w6w first-party pack. It declares 18 actions, 3 health checks, and the host runs its code in a sandbox that never sees the credential.

App id
io.w6w.printnode
Version
0.1.0
Author
w6w
Licence
MIT
Categories
Documents & Files · IoT & Hardware

Overview

PrintNode connects printers to the internet: install the PrintNode Client on a computer and every printer attached to it becomes addressable through one API. This app lets a workflow print a PDF or raw printer data (labels, receipts, barcodes) to any of those printers, from a URL or as base64 content, with the usual print options such as copies, duplex, paper size, tray and page ranges.

Beyond printing it covers the whole job lifecycle: list and look up print jobs, read their full state history (new, sent to client, done, error, expired), and cancel jobs that have not yet reached the client. It also lists the computers and printers on the account, including each printer’s capabilities, reads live weight readings from attached USB scales, and manages the webhooks PrintNode uses to push computer and print job state changes.

The app keeps two vendor quirks out of your way: PrintNode returns a webhook’s shared secret in clear on every read, and the app removes it before a result is stored; and the bulk delete forms that would remove every computer or every print job are never built, so a missing id cannot wipe an account.

Build with PrintNode

Three routes to the same 18 actions. The Workflow tab is generated from PrintNode's own manifest and carries its real ids, so it is copy-pasteable; the Code and CLI examples are the same call for any action on any app, so every app-specific value in them is a blank you fill in.

Get Account

account-get

Fetch the PrintNode account the connected API key belongs to.

Delete Computers

computer-delete

Remove one or more computers from the account. Returns the ids removed.

Get Computers

computer-get

Fetch one or more computers by id. Always returns a list, even for one id.

List Computers

computer-list

List the computers running the PrintNode Client on this account.

Get Printers

printer-get

Fetch one or more printers by id, including their capabilities. Returns a list.

List Printers

printer-list

List printers, optionally limited to given computers.

Cancel Print Jobs On Printers

printer-printjobs-cancel

Cancel all undelivered print jobs on given printers, or only the listed jobs.

Cancel Print Jobs

printjob-cancel

Cancel print jobs that have not yet reached the PrintNode Client.

Create Print Job

printjob-create

Send a PDF or raw document to a printer. Returns the new print job id.

Get Print Jobs

printjob-get

Fetch one or more print jobs by id. Returns a list.

List Print Jobs

printjob-list

List print jobs, optionally limited to given printers.

Get Print Job States

printjob-states-list

Read the state history of print jobs (new, sent_to_client, done, error, expired).

Get Scale Reading

scale-get

Read the latest weight from one scale, identified by device name and number.

List Scale Readings

scale-list

Read the most recent weight readings from scales attached to a computer.

Create Webhook

webhook-create

Register a webhook target for computer and print job state events.

Delete Webhook

webhook-delete

Delete a webhook by id. Returns the remaining webhooks.

List Webhooks

webhook-list

List the account's webhooks and their delivery statistics.

Update Webhook

webhook-update

Change a webhook's target URL, secret or message types.

A workflow step names the app and the action, and the editor fills in the connection when you pick one. This is the Step shape from the workflow spec, carrying PrintNode's real ids.

{
  "manifestVersion": "2",
  "name": "printnode-example",
  "steps": [
    {
      "id": "computer-get",
      "uses": {
        "app": "io.w6w.printnode",
        "action": "computer-get",
        "connection": "conn_YOUR_CONNECTION_ID"
      },
      "with": {
        "computerIds": "<computerIds>"
      }
    }
  ]
}

Here are some of the things you can do

  • Get Computers

    read
    computer-get
  • Get Account

    read
    account-get
  • List Computers

    read
    computer-list
  • Get Printers

    read
    printer-get
  • List Printers

    read
    printer-list

+13 more actions available

Every app-specific value here is a blank you have to fill in. An app action is reached through the connection that authenticates it, so the address is a connection id, not the app id — and connections belong to your account, so a public page cannot know yours. Create one for PrintNode, then fill in the three blanks: conn_YOUR_CONNECTION_ID, the action key, and the parameters that action declares. The call itself is real — the shape is transcribed from the studio's own snippet builder, which prints the same kind of blanks — but nothing in it is specific to PrintNode. The Workflow tab is where this app's real ids are.

Install
npm install @w6w/sdk
yarn add @w6w/sdk
pnpm add @w6w/sdk
deno add npm:@w6w/sdk
Code
import { W6wClient, isActionRun } from "@w6w/sdk";

// Reads W6W_BASE_URL and W6W_TOKEN from the environment when omitted.
const client = new W6wClient();

const envelope = await client.run({
  urn: "conn_YOUR_CONNECTION_ID",
  action: "computer-get",
  payload: {
    computerIds: "<value>",
    // limit: "<value>",
    // after: "<value>",
    // dir: "<value>",
  },
});

if (isActionRun(envelope)) console.log(envelope.value);
Install the CLI
npm install -g @w6w/cli
CLI
w6w run conn_YOUR_CONNECTION_ID --action computer-get --payload '{"computerIds":"<value>"}'

Give an AI agent PrintNode — without giving it PrintNode's credentials. One MCP endpoint exposes every app, function and workflow the caller is entitled to, as tools it can discover and run. Access is granted per team while we onboard.

One tool call
{
  "name": "w6w_invoke",
  "arguments": {
    "ref": "app:io.w6w.printnode#computer-get",
    "input": {
      "computerIds": "<computerIds>"
    }
  }
}

Every tool names its target with a single ref. The app: form above doesn't name a connection at all — the host resolves which of the caller's PrintNode connections to sign with, and refuses rather than guesses when the answer is ambiguous.

What the agent gets

Credentials it can't read

The token is attached host-side, at the moment of the call. It is never a tool argument, never in the model's context, and never in a transcript — so a prompt injection has nothing to exfiltrate.

A tool surface scoped to the caller

Tools are derived per end user from what that person has actually connected and is entitled to — not one shared bot identity carrying the union of everyone's access.

A durable workflow in one call

Multi-step work runs on the workflow engine and returns a run handle the agent can poll — retries, branching and state survive the conversation that started them.

Health-aware discovery

PrintNode's declared health checks are on the surface too, so an agent can tell "the vendor is down" from "your credential expired" before it burns a retry on either.

The MCP surface is part of the hosted platform. PrintNode itself is MIT, and the runtime that executes it is source-available (FSL).

Request MCP access

Health checks

PrintNode declares its own checks, so its health is a property of the app rather than something the host guesses at.

service

PrintNode platform status

dependency

API reachable

Unauthenticated GET https://api.printnode.com/ping. The JSON string "OK" passes. Credential validity is the derived `auth:*` check's job.

quota

API request-rate headroom