Back to Browse

Inkrelay Ai MCP Server

Developer ToolsLow Risk10.0MCP RegistryLocal
Free

Server data from the Official MCP Registry

Print PDFs, ZPL labels and ESC/POS receipts on your printers and follow print jobs via InkRelay

About

Print PDFs, ZPL labels and ESC/POS receipts on your printers and follow print jobs via InkRelay

Security Report

10.0
Low Risk10.0Low Risk

Valid MCP server (4 strong, 3 medium validity signals). No known CVEs in dependencies. Package registry verified. Imported from the Official MCP Registry.

5 files analyzed · 1 issue found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

file_system

Check that this permission is expected for this type of plugin.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

Check that this permission is expected for this type of plugin.

network_websocket

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

InkRelay API key from app.inkrelay.app/api-keys. ir_test_ keys print only to free virtual printers.Required

Environment variable: INKRELAY_API_KEY

Folder that filePath arguments must stay inside. Defaults to the working directory.Optional

Environment variable: INKRELAY_FILE_ROOT

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-gauravbr-inkrelay": {
      "env": {
        "INKRELAY_API_KEY": "your-inkrelay-api-key-here",
        "INKRELAY_FILE_ROOT": "your-inkrelay-file-root-here"
      },
      "args": [
        "-y",
        "@inkrelay/mcp"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

InkRelay AI kit

MCP server, Agent Skill and Claude Code plugin for InkRelay, a cloud printing API. Use them to let an AI assistant print on your printers, or to have a coding agent add printing to your app.

PieceUse it toInstall
@inkrelay/mcpList printers, print PDFs, ZPL labels and ESC/POS receipts, follow jobs, manage webhooks from an MCP clientnpx -y @inkrelay/mcp
inkrelay-printing skillGive a coding agent the API rules, SDK usage, webhook verification and raw printing detailsClaude Code plugin, or copy the folder
inkrelay-integrator agentAdd printing to a project: SDK, config, print module, webhook route, tests, one test printClaude Code plugin
Docs MCP serverSearch the InkRelay docs from an MCP clienthttps://docs.inkrelay.app/mcp
AGENTS.md snippetGive agents without skills the same rulesPaste into AGENTS.md, CLAUDE.md or Cursor rules

Quick start

  1. Sign in at app.inkrelay.app and create a key under API keys. A test key (ir_test_...) prints only to four virtual printers (A4 laser, Letter color, 80 mm receipt, 4x6 label) and costs nothing.

  2. Add the MCP server to Claude Code (other clients are in mcp/README.md):

    claude mcp add-json inkrelay '{"command":"npx","args":["-y","@inkrelay/mcp"],"env":{"INKRELAY_API_KEY":"ir_test_your_key"}}'
    
  3. Ask: "Print https://inkrelay.app/sample.pdf on Test A4 Laser and tell me when it is done."

Claude Code plugin

Installs the MCP server, the docs MCP server, the skill and the agent together. Set INKRELAY_API_KEY in your shell, start Claude Code and run:

/plugin marketplace add GauravBR/inkrelay-ai
/plugin install inkrelay@inkrelay

Then ask, for example: "Add label printing to this app with InkRelay."

Skill only

Copy plugins/inkrelay/skills/inkrelay-printing into your agent's skills folder (for Claude Code, .claude/skills/ in the project or ~/.claude/skills/). It uses the Agent Skills format (SKILL.md with name and description), so other agents that read that format can load it too.

What InkRelay does

  • An agent runs as a system service on Windows, macOS or Linux (including Raspberry Pi) next to the printers. It connects out on port 443 and keeps a WebSocket to api.inkrelay.app, so nothing needs to be opened on the network.
  • Your code sends POST /v1/printjobs with a printer id and a PDF (URL or base64) or raw bytes (ZPL, ESC/POS). The job is sent to the agent as soon as it is stored. Test jobs reach done in about 3 seconds.
  • Each job reports queued, sent, received, printing, then done or error with the operating system's message, and keeps its event history.
  • Webhooks are signed in the Standard Webhooks format (HMAC), cover 15 event types, retry for about 27 hours and can be replayed.
  • Idempotency-Key on job creation makes retries safe. The limit is 20 requests per second per key.
  • SDKs: @inkrelay/sdk (npm) and inkrelay (PyPI). OpenAPI 3.1 spec and a Postman collection.
  • Request fields match PrintNode's, so PrintNode integrations move with a base URL and id change (migration guide).
  • Test mode is free. The Lite plan includes 50 live prints a month on one computer (pricing).

Links

License

MIT

Reviews

No reviews yet

Be the first to review this server!