How do I use odin-print-farm-mcp?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@odin-print-farm-mcp Show me the farm summary and a list of unread alerts." That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

odin-print-farm-mcp

by HughKantsime

Overview Schema Source Related Servers Discussions Admin

TypeScript

Hybrid

odin-print-farm-mcp

Model Context Protocol server for O.D.I.N. — drive an actual print farm with AI agents, or run the bundled reference calculators standalone.

v2 (2026-04-15) splits the surface in two:

Live tools (22) — agent-driven farm operation. Require a running O.D.I.N. instance + a scoped token. Queue jobs, pause printers, manage inventory, clear alerts, log maintenance, read the dashboard.
Reference tools (4) — standalone calculators. No ODIN deployment required. Print-cost math, printer recommendations, farm capacity planning, software comparison.

Both surfaces ship in the same npm package; the live tools error at invocation if ODIN_BASE_URL / ODIN_API_KEY aren't set, so the reference tools keep working for pre-sales and research use cases.

Quick Start

Standalone (reference tools only)

npx -y odin-print-farm-mcp@2

Wire into Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "odin-reference": {
      "command": "npx",
      "args": ["-y", "odin-print-farm-mcp@2"]
    }
  }
}

Agents can now use reference.calculate_print_cost, reference.recommend_printer_for_farm, reference.estimate_farm_capacity, reference.compare_farm_software.

Live (connected to O.D.I.N.)

Mint an API token in O.D.I.N. (Settings → API Tokens → New Token) with scope agent:read or agent:write.
Export the env vars and wire the client:

{
  "mcpServers": {
    "odin": {
      "command": "npx",
      "args": ["-y", "odin-print-farm-mcp@2"],
      "env": {
        "ODIN_BASE_URL": "http://192.168.1.100:8000",
        "ODIN_API_KEY": "odin_xxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

All 26 tools are now available.

Related MCP server: Kiln

Tools

Live reads (scope `agent:read` or higher)

Tool	Purpose
`farm_summary`	One-shot dashboard: printer counts by state, queue depth, unread alerts, active jobs. Call this first to orient.
`list_printers`	Fleet list, optional status filter.
`get_printer`	Full status + telemetry + AMS + active job for one printer.
`list_jobs`	Filter by status (pending / printing / completed / failed / cancelled).
`get_job`	Full job record.
`list_queue`	Pending jobs in priority order.
`list_alerts`	Filter by severity + read state.
`list_spools`	Filter by filament type / availability.
`list_filaments`	Filament library.
`list_maintenance_tasks`	Optional overdue-only filter.
`list_orders`	Customer orders by status.

Live writes (scope `agent:write` or admin)

Every write tool accepts optional dry_run and idempotency_key.

Tool	Purpose
`queue_job`	Add a job from a model library ID. Accepts `model_id`, optional `item_name`, `quantity`, `priority`, and `notes`; the ODIN scheduler assigns the printer.
`cancel_job`	Cancel a job. Requires reason on some endpoints.
`approve_job`	Approve a submitted job.
`reject_job`	Reject a job (reason required).
`pause_printer`	Pause the active print.
`resume_printer`	Resume a paused printer.
`mark_alert_read` / `dismiss_alert`	Alert housekeeping.
`assign_spool`	Bind spool → printer AMS slot.
`consume_spool`	Log grams used.
`complete_maintenance`	Log task completion. Requires `printer_id`, `task_id`, and `task_name`.

Reference (no backend)

Tool	Purpose
`reference.calculate_print_cost`	Material + electricity + depreciation + failure-rate math.
`reference.recommend_printer_for_farm`	Match printers to farm constraints.
`reference.estimate_farm_capacity`	Throughput forecasting.
`reference.compare_farm_software`	Feature matrix vs OctoFarm / Mainsail / Duet / etc.

Agent Primitives

The live surface inherits four retry-safety primitives from the O.D.I.N. v1.8.9 backend:

Idempotency-Key. Every write tool auto-generates a UUID key per call; pass a stable idempotency_key across retries to deduplicate. On replay, the response comes back with _idempotent_replay: true.

X-Dry-Run. Pass dry_run: true to any write tool. The backend returns {dry_run: true, would_execute: {...}} without committing. Per-route opt-in — individual routes land preview branches in subsequent releases.

Structured errors. Failures return an error: {code, detail, retriable} envelope. Stable codes agents can branch on:

Code	Meaning
`printer_not_found` / `job_not_found` / `spool_not_found` / `alert_not_found`	Resource missing.
`scope_denied`	Token scope insufficient. Mint a broader token.
`permission_denied`	Role-based denial (role, not scope).
`quota_exceeded`	Usage quota hit. `extra.used_grams` / `extra.limit_grams`.
`idempotency_conflict`	Same key + different body. Use a fresh key.
`idempotency_in_progress`	Concurrent retry in flight. Retry shortly.
`idempotency_authz_changed`	Role/scope changed since the original call. Mint a fresh key.
`idempotency_uncacheable_success`	Original succeeded but couldn't be cached. Mint a fresh key.
`idempotency_unsupported`	Multipart or oversized body — use app-level dedup.
`itar_outbound_blocked`	ODIN_ITAR_MODE=1 refused a public destination.
`rate_limited`	`retriable: true`.
`validation_failed`	Input schema error.

next_actions hints. Write responses include next_actions: [{tool, args?, reason?}] suggesting follow-up calls. Pure hint — no enforcement. Designed for 7B–32B local models.

ITAR / CMMC Deployment

O.D.I.N. ships ODIN_ITAR_MODE=1 for fail-closed air-gap deployments. Typical stack:

   Ollama (Qwen2.5-32B or similar)
      │
      ▼
   MCP client (Claude Desktop / OpenClaw / etc.)
      │ stdio
      ▼
   odin-print-farm-mcp@2  ── ODIN_BASE_URL=http://localhost:8000
      │ HTTP
      ▼
   O.D.I.N. backend  ── ODIN_ITAR_MODE=1
      │ LAN
      ▼
   Printers (LAN-only)

Zero outbound packets. All tokens, prompts, and telemetry stay inside the compliance boundary. See the ITAR / CMMC mode docs.

Migration from v1

v2.0.1 renames the four v1 tools into a reference.* namespace:

v1	v2
`calculate_print_cost`	`reference.calculate_print_cost`
`recommend_printer_for_farm`	`reference.recommend_printer_for_farm`
`estimate_farm_capacity`	`reference.estimate_farm_capacity`
`compare_farm_software`	`reference.compare_farm_software`

The behavior of each tool is unchanged — only the identifier. Pin odin-print-farm-mcp@1 if you need the un-namespaced IDs. Upgrade to @2 to access the 22 live tools plus the namespaced reference calculators.

Skill packages

The skills/ directory ships operator-ready prompt packs for Claude Code, OpenClaw, Cline, and other MCP clients. odin-farm/SKILL.md is the baseline "safe farm operator" rulebook — dry-run-first, branch on error codes, never batch cancellations. Drop it into ~/.claude/skills/ (Claude Code) or your client's skills directory, and a local 32B model will stop trying to cancel jobs without confirmation.

See skills/README.md for install + customization.

Development

git clone https://github.com/HughKantsime/odin-mcp
cd odin-mcp
npm install
npm run build
npm test  # 22 integration tests against an in-process mock ODIN

Tests use a node-native http mock server (test/mock_server.ts) — no external fixtures, no ODIN instance required, runs in ~1s.

License

Apache 2.0.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive

ResponsivenessNo issues

Resources

Need Help?

Related Servers

Related MCP Connectors

SimplyPrint: 3D Print Farm Management B
io.simplyprint
3D print farm management for AI. Monitor, queue, and control prints on your SimplyPrint account.
App Automation Virtualization
7521
PrintonicOAuth
com.printonic
Print-on-demand catalog, listings, and fulfillment for AI agents.
E-commerce & Retail
1
NoClick AOAuth
io.github.noclickapp
Build agents to automate any background task. Works with your ChatGPT/Claude subscription.
App Automation Autonomous Agents
4711
DobbyOAuth
io.github.gil-dobby
Connect, monitor, and control AI agents — tasks, approvals, schedules, and governance.
Agent Orchestration Autonomous Agents Monitoring
2

Related MCP Servers

Klipper MCP Server
Home Automation & IoT Developer Tools App Automation
Charleslotto
F
license
Not graded
quality
B
maintenance
An MCP server that enables AI assistants to control and monitor Klipper 3D printers via the Moonraker API. It supports comprehensive printer management, including G-code execution, toolchanger operations, and real-time status monitoring.
Updated a month ago (2026-08-05 18:30 UTC)
22
-
Kiln
Autonomous Agents Command Line Home Automation & IoT
codeofaxel
A
license
B
quality
B
maintenance
Open-source MCP server that lets AI agents control 3D printers. 353 tools for OctoPrint, Moonraker, Bambu Lab, Prusa Link, and Elegoo — search model marketplaces, generate 3D models from text, slice STL files, queue prints, monitor with camera vision, and manage multi-printer fleets. Install via pip install kiln3d.
Updated 2 days ago (2026-09-12 09:58 UTC)
468
57
AGPL 3.0
mcp-printable
Design Tools
AaronGoldsmith
A
license
A
quality
B
maintenance
Connects MCP-capable agents to Blender and OpenSCAD for AI-driven 3D modeling, with tools and rules optimized for FDM-printable geometry.
Updated 2 months ago (2026-07-05 21:43 UTC)
29
2
MIT
PrintVaultMCP
Project Management
BrandonDoster
A
license
A
quality
F
maintenance
Enables AI assistants to manage 3D printing inventory, filament spools, printers, projects, and print trackers through a self-hosted Print Vault instance.
Updated 6 months ago (2026-03-26 16:37 UTC)
40
AGPL 3.0

odin-print-farm-mcp

Quick Start

Standalone (reference tools only)

Live (connected to O.D.I.N.)

Tools

Live reads (scope agent:read or higher)

Live writes (scope agent:write or admin)

Reference (no backend)

Agent Primitives

ITAR / CMMC Deployment

Migration from v1

Skill packages

Development

Links

License

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

Klipper MCP Server

Kiln

mcp-printable

PrintVaultMCP

Live reads (scope `agent:read` or higher)

Live writes (scope `agent:write` or admin)