Available Tools
All MCP tools exposed by the Pushary server
The Pushary MCP server exposes 20 tools across six categories. Each tool uses your API key for authentication and delegates to the Pushary REST API.
Notifications
send_notification
Send a push notification to subscribers. Target by subscriber IDs, external IDs, or tags. If no targeting is specified, sends to all active subscribers.
Prop
Type
Delivers real notifications to real users immediately.
Human-in-the-Loop
ask_user
Send a question to the user via push notification. Supports three question types: confirm (yes/no), select (multiple choice), and input (free text).
Prop
Type
Returns a correlationId to pass to wait_for_answer. Questions expire after 10 minutes. sessionId/machineId are set automatically by the Pushary hook — see Multi-Agent Control Panel.
wait_for_answer
Long-poll for the user's response. Blocks until the user responds or the timeout is reached.
Prop
Type
Returns { answered: true, value: "yes" | "no" | "option text" | "free text" } if answered, or { answered: false } on timeout. Call again with the same correlationId to keep polling.
cancel_question
Cancel a pending question so it can no longer be answered.
Prop
Type
Returns { cancelled: true } if found and deleted, or { cancelled: false } if already expired.
list_sessions
Read-only. Returns your site's live agent sessions (keyed by machine + session) and any pending approval questions, so you can see which of your parallel agents is blocked. Does not start, stop, or steer agents, and sends no notification.
Prop
Type
Returns { sessions, pendingQuestions }. Each session includes agentType, agentName, machineId, sessionId, computedStatus (active / idle / waiting / offline / errored), lastAction, lastSeenAt, and a human-readable timeAgo. Scoped to the API key's site — there's no parameter that can read another tenant. See the Multi-Agent Control Panel for what each status means.
This is the only agent-facing read of your fleet. It's safe to poll, performs zero writes, and is the right tool for a supervising agent that wants to find the blocked session.
Subscribers
list_subscribers
List push notification subscribers with optional filters. Returns a paginated list.
Prop
Type
get_subscriber
Get full details of a single subscriber by ID, including browser, OS, location, tags, and activity.
Prop
Type
count_subscribers
Get subscriber counts broken down by status: total, active, and unsubscribed. No parameters required.