Input Module

User interaction and notifications

Available Tools

• input_notify - Send terminal and desktop notifications
• input_prompt - Interactive text prompts (terminal or MCP)
• input_select - Selection menus (terminal or MCP)
• input_progress - Display progress bars
• input_clipboard_read - Read from system clipboard
• input_clipboard_write - Write to system clipboard

Example: Send Notification

{
  "name": "input_notify",
  "arguments": {
    "title": "Build Complete",
    "message": "Your project has been built successfully!",
    "type": "both",
    "urgency": "normal"
  }
}

Sends both terminal and desktop notifications with configurable urgency levels.

Notification Types

• terminal: Display notification in terminal only
• desktop: Display desktop notification only
• both: Display both terminal and desktop notifications

Urgency Levels

• low: Low priority notification
• normal: Normal priority notification
• critical: Critical/urgent notification

Example: Clipboard Operations

Write to clipboard

{
  "name": "input_clipboard_write",
  "arguments": {
    "content": "Hello from Poly MCP!"
  }
}

Read from clipboard

{
  "name": "input_clipboard_read",
  "arguments": {}
}

Example: Interactive Prompt

{
  "name": "input_prompt",
  "arguments": {
    "message": "Enter your name:",
    "default": "User"
  }
}

Example: Selection Menu

{
  "name": "input_select",
  "arguments": {
    "message": "Choose an option:",
    "options": ["Option 1", "Option 2", "Option 3"]
  }
}

Example: Progress Bar

{
  "name": "input_progress",
  "arguments": {
    "message": "Processing...",
    "total": 100,
    "current": 50
  }
}

Desktop Notification with Icon

{
  "name": "input_notify",
  "arguments": {
    "title": "Warning",
    "message": "Disk space is running low",
    "type": "desktop",
    "urgency": "critical",
    "icon": "warning"
  }
}