GET https://printshop.grey.ooo/webcam/printer/01KZREN07YEW53VYXNK2DTVB1B.jpg

MCP Capabilities

14 Tools
0 Prompts
0 Resources
0 Resource Templates

Tools 14

list_automations

Description: List the automations configured for the current site, whether each is enabled, and when it last ran.

Handler: PrintShop\Mcp\AutomationTools::listAutomations()

Parameters

Name Type Required Default Description

Full Schema

array:2 [
  "type" => "object"
  "properties" => {#1227}
]

get_automation_run

Description: Fetch the recorded log for one automation run.

Handler: PrintShop\Mcp\AutomationTools::getAutomationRun()

Parameters

Name Type Required Default Description
runId string Yes - -

Full Schema

array:3 [
  "type" => "object"
  "properties" => array:1 [
    "runId" => array:1 [
      "type" => "string"
    ]
  ]
  "required" => array:1 [
    0 => "runId"
  ]
]

set_automation_enabled

Description: Enable or disable an automation at the current site.

Handler: PrintShop\Mcp\AutomationTools::setAutomationEnabled()

Parameters

Name Type Required Default Description
automationId string Yes - -
enabled boolean Yes - -

Full Schema

array:3 [
  "type" => "object"
  "properties" => array:2 [
    "automationId" => array:1 [
      "type" => "string"
    ]
    "enabled" => array:1 [
      "type" => "boolean"
    ]
  ]
  "required" => array:2 [
    0 => "automationId"
    1 => "enabled"
  ]
]

trigger_automation

Description: Run an automation now and return the resulting run record. IMPORTANT: automation execution is currently a stub in this codebase - AutomationService::execute() records a run but performs none of the configured filters or actions, so nothing will actually happen as a result of calling this.

Handler: PrintShop\Mcp\AutomationTools::triggerAutomation()

Parameters

Name Type Required Default Description
automationId string Yes - -

Full Schema

array:3 [
  "type" => "object"
  "properties" => array:1 [
    "automationId" => array:1 [
      "type" => "string"
    ]
  ]
  "required" => array:1 [
    0 => "automationId"
  ]
]

get_fleet_status

Description: List every printer at the current site with its live-ish state: machine state (Idle/Busy/Fix Me), andon lamp colour, whether it needs human attention, and the job it is currently running. Reflects the most recent background check-in, not a fresh poll.

Handler: PrintShop\Mcp\FleetTools::getFleetStatus()

Parameters

Name Type Required Default Description

Full Schema

array:2 [
  "type" => "object"
  "properties" => {#1228}
]

get_printer

Description: Detail for a single printer at the current site, including its recent event history. Use this to answer "why is printer X in this state?".

Handler: PrintShop\Mcp\FleetTools::getPrinter()

Parameters

Name Type Required Default Description
printerId string Yes - -
historyLimit integer No 20 -

Full Schema

array:3 [
  "type" => "object"
  "properties" => array:2 [
    "printerId" => array:1 [
      "type" => "string"
    ]
    "historyLimit" => array:2 [
      "type" => "integer"
      "default" => 20
    ]
  ]
  "required" => array:1 [
    0 => "printerId"
  ]
]

list_attention

Description: List printers at the current site that need human attention, with the most recent events explaining why. The usual cause is a finished print whose bed has not been cleared yet.

Handler: PrintShop\Mcp\FleetTools::listAttention()

Parameters

Name Type Required Default Description

Full Schema

array:2 [
  "type" => "object"
  "properties" => {#1229}
]

dismiss_attention

Description: Clear the needs-attention flag on a printer, once a human has actually dealt with it (typically by clearing the bed). Does not touch the machine itself.

Handler: PrintShop\Mcp\FleetTools::dismissAttention()

Parameters

Name Type Required Default Description
printerId string Yes - -

Full Schema

array:3 [
  "type" => "object"
  "properties" => array:1 [
    "printerId" => array:1 [
      "type" => "string"
    ]
  ]
  "required" => array:1 [
    0 => "printerId"
  ]
]

cancel_print

Description: Abort the print currently running on a printer. This stops a real machine mid-job and the partial print is wasted; it cannot be undone.

Handler: PrintShop\Mcp\FleetTools::cancelPrint()

Parameters

Name Type Required Default Description
printerId string Yes - -

Full Schema

array:3 [
  "type" => "object"
  "properties" => array:1 [
    "printerId" => array:1 [
      "type" => "string"
    ]
  ]
  "required" => array:1 [
    0 => "printerId"
  ]
]

list_mail

Description: List ingested order emails for the current site. Set unreadOnly to see just the ones nobody has opened yet. Returns headers and a short preview, not full bodies.

Handler: PrintShop\Mcp\MailTools::listMail()

Parameters

Name Type Required Default Description
unreadOnly boolean No -
limit integer No 25 -

Full Schema

array:2 [
  "type" => "object"
  "properties" => array:2 [
    "unreadOnly" => array:2 [
      "type" => "boolean"
      "default" => false
    ]
    "limit" => array:2 [
      "type" => "integer"
      "default" => 25
    ]
  ]
]

read_mail

Description: Read the full text body of one order email. Marks it as read, exactly as opening it in the mail centre would.

Handler: PrintShop\Mcp\MailTools::readMail()

Parameters

Name Type Required Default Description
mailId string Yes - -

Full Schema

array:3 [
  "type" => "object"
  "properties" => array:1 [
    "mailId" => array:1 [
      "type" => "string"
    ]
  ]
  "required" => array:1 [
    0 => "mailId"
  ]
]

get_dashboard_stats

Description: Headline counts for the current site: printers, how many need attention, queue depth, unread order emails, automations and products. One cheap call to size up the shop before drilling in.

Handler: PrintShop\Mcp\OverviewTools::getDashboardStats()

Parameters

Name Type Required Default Description

Full Schema

array:2 [
  "type" => "object"
  "properties" => {#1230}
]

list_queue

Description: The print queue grouped into pending, in-progress and completed. Note that pending jobs are shop-wide: a queued print has no site until the allocator assigns it to a printer, so pending items are not filtered by site while in-progress and completed ones are.

Handler: PrintShop\Mcp\QueueTools::listQueue()

Parameters

Name Type Required Default Description
limit integer No 25 -

Full Schema

array:2 [
  "type" => "object"
  "properties" => array:1 [
    "limit" => array:2 [
      "type" => "integer"
      "default" => 25
    ]
  ]
]

enqueue_print

Description: Queue a product to be printed, then run the allocator once. If a suitable idle printer is free the job starts on real hardware immediately; otherwise it waits in the queue. The allocator only ever starts one job per run, so a queued job may remain pending even when this returns successfully.

Handler: PrintShop\Mcp\QueueTools::enqueuePrint()

Parameters

Name Type Required Default Description
productId string Yes - -

Full Schema

array:3 [
  "type" => "object"
  "properties" => array:1 [
    "productId" => array:1 [
      "type" => "string"
    ]
  ]
  "required" => array:1 [
    0 => "productId"
  ]
]

Prompts 0

No prompts were registered.

Resources 0

No resources were registered.

Resource Templates 0

No resource templates were registered.