← Back to Skills Marketplace
earlvanze

Epson MCP

by Earl Co · GitHub ↗ · v0.2.1 · MIT-0
cross-platform ⚠ suspicious
42
Downloads
0
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install epson-mcp
Description
Print, scan, copy, and job control for the Epson WF-2250 (and other network-attached Epson inkjets) via MCP. Exposes tools for text/raster/PDF printing, prin...
README (SKILL.md)

Epson MCP

MCP server for the Epson WF-2250 inkjet printer. Connects to the printer over TCP/9100 (ESC/P-R) or LPD, with an optional Windows PowerShell spooler backend.

Tools

  • epson_diag — Diagnose connectivity and capabilities
  • epson_print_text — Print plain text via ESC/P-R
  • epson_print_file — Print a file from the shared volume (PDF auto-converted)
  • epson_print_raw — Send a base64-encoded ESC/P or PostScript payload
  • epson_status — Re-probe the printer and return a status summary
  • epson_ink — Ink level info (stub — WF-2250 doesn't expose ink over network)
  • epson_list_jobs — List Windows spooler jobs (requires PowerShell)
  • epson_cancel_job — Cancel a Windows spooler job (requires PowerShell)
  • epson_scan — Network scan (stub — WF-2250 doesn't support network scanning)
  • epson_copy — Network copy (stub)

Setup

  1. Deploy the Docker container (see repo README).
  2. Expose over Tailnet: tailscale serve --bg --set-path=/epson http://localhost:18790
  3. Wire into Codex/OpenClaw: 
    codex mcp add epson --url https://cyber.talpa-stargazer.ts.net/epson/mcp \
    --bearer-token-env-var EPSON_MCP_AUTH_TOKEN

Backends

Backend Protocol Notes
raw9100 TCP/9100 ESC/P Default; works with WF-2250
lpd TCP/515 LPR Fallback; most low-end Epsons ignore
windows PowerShell Only when PowerShell is available

When backend=auto (default), tries lpd → raw9100 → windows in order. On Linux containers, the Windows backend is automatically skipped if powershell.exe / pwsh is not found.

License

MIT-0

Usage Guidance
Install only if you trust the MCP server and intend to let an agent control a real printer. Treat raw printing and job cancellation as explicit, user-confirmed actions, preferably limited to trusted users and exact job IDs.
Capability Assessment
ℹ Purpose & Capability
The stated purpose is Epson printer management over MCP, and the listed capabilities fit that purpose: printing, diagnostics, status checks, spooler job listing, cancellation, and scan/copy stubs.
⚠ Instruction Scope
The artifact discloses raw printer payload submission and job cancellation, but does not clearly require explicit user confirmation, exact job targeting, or safer default use of ordinary print tools.
ℹ Install Mechanism
The skill points to a Tailnet-authenticated MCP endpoint and Docker-based deployment, but the reviewed artifact is mainly SKILL.md text rather than the server implementation.
ℹ Credentials
Network printer and spooler access are proportionate for a printer-control skill, while raw ESC/P or PostScript payload support is broader than routine document printing.
✓ Persistence & Privilege
No hidden persistence, credential harvesting, broad local indexing, privilege escalation, or unrelated background behavior is shown in the reviewed artifact.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install epson-mcp
  3. After installation, invoke the skill by name or use /epson-mcp
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.2.1
Fix powershell.exe crash on Linux; auto-detect platform
v0.2.0
Fix powershell.exe crash on Linux
Metadata
Slug epson-mcp
Version 0.2.1
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 2
Frequently Asked Questions

What is Epson MCP?

Print, scan, copy, and job control for the Epson WF-2250 (and other network-attached Epson inkjets) via MCP. Exposes tools for text/raster/PDF printing, prin... It is an AI Agent Skill for Claude Code / OpenClaw, with 42 downloads so far.

How do I install Epson MCP?

Run "/install epson-mcp" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Epson MCP free?

Yes, Epson MCP is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Epson MCP support?

Epson MCP is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Epson MCP?

It is built and maintained by Earl Co (@earlvanze); the current version is v0.2.1.

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463283 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259410 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200423 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191115 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190156 · by oswalpalash

💬 Comments