MCP Capabilities
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" => {#1226} ] |
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" => {#1227} ] |
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" => {#1228} ] |
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" => {#1229} ] |
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.