Tools & Interface Reference
Cancel Scheduled Task Tool
Section titled “Cancel Scheduled Task Tool”Disables a cron job so it stops running.
Description: Cancel (disable) a scheduled task by its ID. The task can be re-enabled from the PocketCoder dashboard. The user will be asked to approve this action.
Args:
task_id— The ID of the scheduled task to cancel
Update Checker
Section titled “Update Checker”Checks the Codeberg repo for new commits/releases.
Description: Check for PocketCoder updates from the official Codeberg repository. Shows recent commits on main and any releases. Use this when the user asks about updates, or occasionally to keep them informed.
Args:
count— Number of recent commits to show
List Scheduled Tasks Tool
Section titled “List Scheduled Tasks Tool”Shows all cron jobs for the current user.
Description: List all scheduled tasks for the current user. Shows active and disabled cron jobs with their schedules and last execution status.
MCP Catalog Browser
Section titled “MCP Catalog Browser”Lets Poco discover available Docker MCP servers.
Description: Browse or search the Docker MCP Catalog to discover available MCP servers. Returns the names and descriptions of all matching servers.
Args:
query— Optional search term to filter servers (checks both name and description)
MCP Inspector
Section titled “MCP Inspector”Deep-inspects server tools, config schema, and README from the catalog.
Description: Inspect an MCP server’s technical details, including its tools, environment variables, and README documentation from the catalog.
Args:
server_name— The name of the MCP server to inspect (e.g., ‘n8n’, ‘mysql’)mode— Filter what information to return
MCP Request Tool
Section titled “MCP Request Tool”Submits enriched MCP server requests to PocketBase for user approval.
Description: Request a new MCP server to be enabled. Automatically researches the technical requirements (image, secrets) from the Docker MCP catalog before submitting.
Args:
server_name— Name of the MCP server (e.g., ‘n8n’, ‘mysql’)reason— Why this server is needed for the current task
MCP Status
Section titled “MCP Status”Reports which MCP servers are currently live in the gateway.
Description: Check which MCP servers are currently enabled in the gateway. Reads the live config.
Schedule Task Tool
Section titled “Schedule Task Tool”Creates a cron job record so Poco can schedule recurring tasks.
Description: Schedule a recurring task. Creates a cron job that will execute a prompt on a schedule. The user will be asked to approve this action.
Args:
task_name— A short name for the scheduled task (e.g., ‘Nightly Tests’, ‘PR Review Reminder’)cron_expression— Standard cron expression for the schedule (e.g., ‘0 9 * * 1’ for every Monday at 9am)prompt— The prompt/instruction to execute on each runsession_mode— ‘new’ to create a fresh chat each run (default), or ‘existing’ to reuse the current chatdescription— Optional longer description of what this task does
Session Env Plugin
Section titled “Session Env Plugin”Injects session and agent identity into OpenCode shell environments.
Interface Bridge
Section titled “Interface Bridge”Event pump + command pump syncing PocketBase with OpenCode.